Estoy usando D2007 y estoy tratando de documentar mi código fuente, usando la función HelpInsight (provista desde D2005). Me interesa principalmente que funcionen las sugerencias de herramientas de HelpInsight. Desde varios navegadores web y experimentación, he encontrado lo siguiente:Documentación de HelpInsight en Delphi 2007
- El uso del estilo de comentario triple slash (///) funciona con más frecuencia que los otros estilos de comentarios documentados. es decir .:
{*! comment *}
y{! comment }
- Los comentarios deben preceder a la declaración de que son para. Para la mayoría de los casos, esto significará colocarlos en la sección de interfaz del código. (La excepción obvia es para tipos y funciones que no son accesibles desde fuera de la unidad actual y, por lo tanto, se declaran en el bloque de implementación.)
- El primer comentario no puede ser para una función. (Es decir, que debe ser para un tipo - o por lo menos parece que el analizador debe haber visto la palabra clave "tipo" antes funciona la característica HelpInsight)
A pesar de seguir estas "reglas", a veces la Ayuda-visión simplemente doesn No encuentro los comentarios que he escrito. Un archivo no produce las sugerencias de herramientas de HelpInsight correctas, pero si incluyo este archivo en un proyecto ficticio diferente, funciona correctamente.
¿Alguien más tiene otros consejos/trucos para que HelpInsight funcione?
¿Ha encontrado algunas soluciones más para hacer que HelpInsight sea más estable? –