No hay peor comentario que el comentario que está equivocado

¿Qué tiene mal este código?
for each // Me fijo cantidad de la entrada
where MstId = &MstId2
    if MstTpo = 'R'
        &MstCntR = MstCnt
    else
        &MstCntS = MstCnt
    endif
endfor
Para el que lo ve así, a simple vista, no tiene nada mal. Los que leyeron el título de la nota pueden tener alguna pista.

¡Lo que está mal es el comentario! Porque &MstId2 no es una ENTRADA, es una SALIDA. Claro que el que no conoce el contexto no tiene forma de saberlo, y ahí está el peligro.

Yo estoy a favor de poner comentarios que expliquen lo que hace el programa, pero los comentarios tienen que estar bien, si no, es peor tener comentarios que no tenerlos.

Porque alguien podría leer el for each y quedarse con la idea que toma la cantidad de la entrada, cuando en realidad se queda con la de la salida.

En conclusión, más vale no tener comentarios que tener comentarios equivocados...

Comentarios

  1. Andrés Rodriguez (ElAndrew)4/6/09 14:16

    Este comentario ha sido eliminado por el autor.

    ResponderBorrar
  2. Andrés Rodriguez (ElAndrew)4/6/09 14:17

    Te lo simplifico, más vale no tener PROGRAMADORES que hacen malos comentarios, que tenerlos.

    Solución final:
    Encontrar al reverendo que hizo el comentario y agregarlo a la bolsa de trabajo de artech ;)

    Saludos
    ElAndrew
    kualquiercosario.blogspot.com

    ResponderBorrar
  3. Marcos Crispino5/6/09 12:38

    Andrés: No es tan fácil... En realidad habría que encontrar el que cambió el programa y no cambió el comentario.

    ResponderBorrar

Publicar un comentario

Entradas más populares de este blog

Subversion vs. Git

Cuando se habla de control de versiones, hay dos grandes formas de encarar el tema: centralizado o distribuido. Durante un año estuve usando Git (un sistema de control de versiones distribuido), y ahora hace un mes y medio que estoy usando Subversion  (que es centralizado). Lo que sigue es un intento de comparar ambas herramientas, desde mi punto de vista personal, sin intención de hacer una comparación exhaustiva ni del todo objetiva. Lo primero que hay que aclarar es que ni Git es del todo "distribuido" (ya que se suele mantener un repositorio centralizado), ni Subversion es totalmente centralizado (porque se trabaja sobre una copia local). La diferencia en realidad es donde ocurren las operaciones (branch, commit, etc.). En el caso de Git (y los demás que son distribuidos como Mercurial), las operaciones son locales, mientras que en Subversion ocurren en el servidor. Esto quiere decir que en Git puedo hacer N commits antes de...
Leer más

Literales de tipo Date y DateTime en GeneXus

Imagen
Cuando programamos, ya sea en GeneXus o en cualquier otro lenguaje, es muy común usar literales en el código, para valores conocidos o especiales de la aplicación. Por ejemplo, si voy a hacer una suma de varios registros, inicializo la variable en cero: &suma = 0 O si estoy por ejemplo en una transacción y quiero saber si estoy en modo Insert, puedo preguntar if &Mode = 'INS'     ... endif (nota: es un ejemplo... lo recomendable en este caso es usar el dominio enumerado TrnMode) En GeneXus hay unos cuantos tipos de datos, pero podríamos decir que los principales son cuatro: números, strings, booleanos y fechas (o fecha-hora para ser más precisos). Para los tres primeros, es bien sabido como expresar literales, ¿pero para las fechas? Esta funcionalidad creo que no es muy conocida, pero en GeneXus también se pueden escribir literales de fechas, utilizando el caracter # como delimitador (así como usamos las comillas simples o dobles para los strings). ...
Leer más

I Maratón de Montevideo

Imagen
El pasado domingo 11 de mayo de 2014 se llevó a cabo la primer edición de la Maratón de Montevideo . Con un tiempo de 4 horas y 43 minutos logré completar el recorrido de 42.195 metros, por lo que ahora puedo decir que soy maratonista :) Por qué correr una maratón es una pregunta que me han hecho bastante. Seguramente haya tantas respuestas como corredores, en mi caso lo que quería era demostrarme a mi mismo que era capaz de hacerlo. Habiendo corrido 21 kilómetros en 2013 , parecía un desafío interesante. No me había puesto meta de tiempo, sabía que bajar de 4 horas y media iba a ser difícil por los tiempos que estaba haciendo en los entrenamientos, y esperaba poder hacerlo en menos de 5 horas. El límite máximo, puesto por la organización, era de 6 horas. Hablando del entrenamiento, fueron 16 semanas de actividad cada vez más exigente, con 4 actividades semanales y llegando a correr más de 60 kilómetros por semana, con un máximo de 32km en una oportunidad. Es un entrenamiento...
Leer más