Discusión sobre el artículo "Cómo crear documentación usando los códigos fuente MQL5"

 

Artículo publicado Cómo crear documentación usando los códigos fuente MQL5:

En el artículo se analiza la creación de documentación para el código en MQL5, comenzando por la automatización de la colocación de los tags necesarios. A continuación, se describe el trabajo con el programa Doxygen, su correcta configuración y la obtención de resultados en diferentes formatos: en html, en HtmlHelp y en PDF.

Por eso, lo primero que haremos es  resolver este problema introduciendo correcciones en la configuración del programa. Iniciamos doxywizard.exe y comenzamos la configuración, indicando el nombre del proyecto, la carpeta de entrada y salida, y marcando necesariamente "Optimize for C++ output" en el punto Mode de la pestaña Wizard.

Pasamos a la pestaña Expert y en el punto Input añadimos los archivos con la extensión necesaria:

Autor: Andrei Novichkov

 

Tengo una pregunta no exactamente sobre el artículo, sino sobre Doxygen. Entiendo que usaste la versión 1.8.13. Yo también la uso, pero directamente - vía línea de comandos. Por alguna razón, en la ayuda html que obtengo, todas las páginas de paso de "Directory Reference" no muestran las subcarpetas que contienen. Quiero decir, por ejemplo, hay una estructura de carpetas: MQL4, con las subcarpetas habituales Include y Scripts. Si hace clic en el elemento Lista de archivos en el menú de documentación, verá un árbol normal con carpetas y archivos. Si haces clic en la carpeta Include, por ejemplo, verás la página "Include Directory Reference" con todos los archivos. Sin embargo, si hago clic en el nivel superior - MQL4 - obtengo la página "MQL4 Directory Reference", que tiene un subtítulo Directories, pero debajo no hay ni Include ni Scripts. Otros documentos, incluyendo el suyo, no tienen este problema. ¿Cuál puede ser el problema?

Ya he intentado llenar INPUT en la configuración de diferentes maneras, pensé que era el primer candidato para la configuración incorrecta, he cambiado RECURSIVE - pero nada ayuda - la documentación se crea siempre en todo normal, excepto por este molesto matiz.

 
Stanislav Korotky:

He intentado llenar INPUT en la configuración de diferentes maneras, pensé que era el primer candidato para la configuración incorrecta, cambiado RECURSIVO - pero nada ayuda - la documentación se crea siempre en todo normal, excepto por este matiz molesto.

Tomó su config. Genera ayuda para mis fuentes sin el problema descrito. Ahora tengo que comparar una docena de opciones aquí y allá ;-/

 
Stanislav Korotky:

Tomé tu configuración. Genera ayuda para mis fuentes sin el problema descrito. Ahora tengo que comparar una docena de opciones aquí y allá ;-/

Por si acaso escribo el resultado - puede ser útil a alguien. Resultó que EXTRACT_ALL afecta. Con NO no se muestran las carpetas, con SI se muestran. IMHO, un bug del generador.

 

Buenas tardes.

Probablemente llegue tarde para responder ))))))) Recuerdo que en la GUI de Doxygen hay una opción para marcar "incluyendo subdirectorios". Ya no recuerdo muy bien dónde está, pero es posible encontrarla.