Comentar código fuera de delphi?

[DarKraZY]

En alguna ocasión he pensado en algo parecido a lo que piden los superiores de Lepe. En mi caso, esa idea extrema, ha sido después de observar siempre los mismos comentarios tipo:

Código Delphi [-]
for i := 0 to 20 do
begin
//50 líneas dentro
end; // fin del for

O por el lío que genera no identar el código fuente, cabeceras al inicio del documento desactualizadas, etc.

Pero hay veces que es necesario hacer comentarios en el propio código fuente. Ahora mismo me acabo de encontrar con el problema de hacer DisableControls en una relación maestro/detalle entre dos TClientDataSet y he añadido un comentario para avisar de usar BlockReadSize.

En mi caso suelo utilizar subversión y con cada commit añado información de porqué he hecho modificaciones. No sé si eso te podría servir.

Saludos!

[[Lepe]]

Antes de nada quiero agradecer vuestros comentarios, como siempre, magníficos.

Neftali y Al González: Sí, es un despropósito, lo sé, pero es lo único que se me ocurre para salir del paso. En realidad son muchas cosas las que tenemos pendiente en el cajón (migrar a XE con Firebird 2.5, por ejemplo). El REGION me gustó del XE, ya me gustaría poder usarlo en D7 jejeje.

dec:: conocía de oídas el DelphiDoc, al ser Open Source, le echaré una visual.

Casimiro: Mi jefe es programador Delphi con más de 20 años de experiencia, único programador del proyecto. Creo es más bien una cuestión de gustos. No puedo dar más detalles, tampoco es que hayamos tenido una conversación larga y tendida sobre el tema, solo hizo un comentario y prefiero molestar lo mínimo. Esos comentarios a él no le sirven porque conoce TODO, (hasta la última coma) del proyecto [créeme, cuando digo hasta la última coma]. Mi idea es precisamente la que tú comentas, pero además del número de línea, guardaría un trozo de texto del código (con 1 Tera de Disco duro eso es lo de menos), así puedo abrir una ventanita de Cnpacks automáticamente mostrando el comentario en una ventana adosada (docked) o flotando donde no moleste.

DarKraZY: Uso Tortoise en un repositorio local, se lo he comentado, pero como no tenemos tiempo, no hemos sacado tiempo para ponerlo en marcha. Como tiene comprado el XE, en cuanto migremos el proyecto lo usaremos fijo. En realidad no me lo han pedido, es algo que quiero hacer para "aclararme yo".

Tengo que dejar aparcado esto un par de días, miraré las opciones más detenidamente.

Gracias y un Saludo.

[Casimiro Notevi]

Empezado por Lepe

Esos comentarios a él no le sirven porque conoce TODO, (hasta la última coma) del proyecto [créeme, cuando digo hasta la última coma].

Tendrá memoria fotográfica.