Hola,
Sólo por dar una idea, yo una vez quise hacer algo parecido con código PHP y era posible usando PHPDoc. Ahora bien, PHPDoc se basa en JavaDoc, y, existe algo como
DelphiDoc, que, también se basa en JavaDoc. La idea es que tú sólo incluyes una línea de comentario en determinado lugar, y, dicha línea lleva a un archivo XML que contiene la documentación de marras. De este modo, al generar la documentación, el programa en cuestión puede recoger la información del archivo XML y asociarla al lugar/identificador/clase o lo que sea.
Lo bueno es que se supone que no llenas el código de comentarios, pues sólo utilizas una línea. Lo malo es que debes mantener "sincronizados" el XML de cada comentario y el código fuente. Y otra cosa mala hay todavía, y, es que no sé si DelphiDoc soporta algo así, estoy echando un vistazo ahora mismo. No obstante no he querido dejar de decirlo, pues, es posible que otros programas de este tipo cuenten con dicha característica, es decir, sólo quería dar una idea de cómo sé que puede hacerse. No sé si valdrá de algo o qué.
Edito: Parece que DelphiDoc no está muy actualizado que digamos. Además he obtenido alguna "violación de acceso", y, con todo no he podido probar si soporta lo que he mencionado arriba o no. Tal vez algún compañero conozca de algún programa similar... yo quiero recordar uno que no era DelphiDoc, pero, no sé si era para PHP o si era para Delphi o si no existe y lo he soñado.
