[Pxr-commits] cambios en read.px --- estilo del código
Carlos J. Gil Bellosta
cgb at datanalytics.com
Wed Aug 24 15:46:49 CEST 2011
Hola, ¿qué tal?
> PD. Un comentario sin mayor importancia: veo que en parte del código
> hay espacios alrededor de los paréntesis. A mí me resulta extraño y, la
> verdad, algo incómodo para leer el código. ¿Los necesitáis así por
> alguna razón?
No es asunto baladí. Sobre todo cuando el código se escribe entre
varios. Yo soy bastante quisquilloso con eso y me he ocupado del
asunto previamente:
1) http://www.datanalytics.com/blog/2010/11/01/una-propuesta-de-guia-de-estilo-de-r/
2) http://www.datanalytics.com/guia_estilo_r.html
Por ejemplo, en las llamadas a funciones, hay varias escuelas:
1) foo(x,y)
2) foo (x,y)
3) foo( x, y )
4) foo(x, y)
5) y alguna combinación de las anteriores
Me suelo decantar por la 3. Pero si nos gusta más la 4, por mí
perfecto (que es la que "recomienda" google para R, por ejemplo).
En la nomenclatura de funciones, pasa lo mismo:
1) foo_bar
2) fooBar
3) foo.bar
4) FooBar
5) ¿otras?
1 es la predilecta de quienes programan en C, Python, etc.
Históricamente era impráctica en R porque al crear documentación en
LaTeX, el _, que indica el subíndice, daba problemas. Aunque creo que
eso ya está solucionado.
Tradicionalmente en R se tendía a usar la 3, que recuerdo que me ponía
nervioso porque en C y Java el "." no es un separador. (2) sería la
preferida de los programadores en Java. Curiosamente, google se
decanta por 4.
También hay cuestiones relativas al tamaño de las indentaciones, el
formato de los comentarios, etc.
Creo que todos tenemos estilos distintos y no estaría de más
explicitar a cuál nos queremos atener para mantenerlo homogéneamente a
través de todo el paquete. De hecho, uno de mis TODOs es crear un
documento de estilo de para programar en R que mejore algunos de los
aspectos que no me gustan del de google y creo que esta es una buena
oportunidad para sacar a la luz pros y contras de las distintas
opciones.
Un saludo,
Carlos J. Gil Bellosta
http://www.datanalytics.com
More information about the Pxr-commits
mailing list