Es importante que
las sintaxis sean entendibles. En un lugar de trabajo a veces una
sintaxis hecha por una persona es retomada, quizás tiempo después,
por otra. O incluso por la misma, después de un tiempo quizás
largo.
En cualquiera de las
dos situaciones la sintaxis debe ser comprensible. Es característica
necesaria de una buena sintaxis.
Para ser
comprensible ayuda que tenga una estructura tan clara y simple como
sea posible, y también los comentarios. No se trata de comentar cada
paso: los obvios no lo requieren. Pero sí intercalar los necesarios
para facilitar la comprensión.
En Stata se puede
comentar de tres maneras:
- empezando la línea con *
- comenzando el comentario con //
- Poniendo el comentario entre estos delimitadores: /* comentario */
La primera manera
pide comenzar una línea de comentario con *
Ejemplo con *
*cálculo
de impuesto
gen Iimpuesto = 0 if
salario_total < 15000
replace impuesto =
salario_total * 0.15 if salario_total >=15000
La segunda manera
pide empezar los comentarios con //. Estas dos barras diagonales
anteceden al comentario, y pueden ir al inicio del renglón o después
de terminar el comando. Si van luego de un comando es imprescindible
que haya espacios en blanco entre medio.
Ejemplo 1 con //
//cálculo
de impuesto
gen Iimpuesto = 0 if
salario_total < 15000
replace impuesto =
salario_total * 0.15 if salario_total >=15000
Ejemplo 2 con //
replace costo_vida =
12000 if region == 4 // La región 4 es la
noreste
En el ejemplo 2 se
pone el comentario después del comando y de espacios en blanco para
aclarar cuál es la región 4. Los espacios en blanco son imprescindibles aquí.
La tercera manera
es con delimitadores:
Ejemplo con delimitadores: /* comentario */
replace costo_vida =
12000 /*
12000 fue provisto por Banco Central */ if
region == 4
Esta forma de
comentar es más engorrosa de teclear y menos usada. Permite comentar
entre medio de un comando si así se desea.
