Discussão do artigo "Criação de documentos com base em códigos-fonte MQL5"

 

Novo artigo Criação de documentos com base em códigos-fonte MQL5 foi publicado:

No artigo é estudada a criação de documentação para um código em linguagem MQL5, partindo da automação de tags (marcação). Além disso, quanto ao programa Doxygen, é descrito seu funcionamento, adequada configuração e obtenção de resultados em vários formatos (HTML, HtmlHelp e PDF).

Vamos para a aba Expert e na opção Input adicionamos os arquivos com a extensão apropriada:

Autor: Andrei Novichkov

 

Tenho uma pergunta não exatamente sobre o artigo, mas sobre o Doxygen. Entendo que você usou a versão 1.8.13. Eu também a uso, mas diretamente, via linha de comando. Por alguma razão, na ajuda em html que recebo, todas as páginas de passagem "Directory Reference" não mostram as subpastas que elas contêm. Por exemplo, existe uma estrutura de pastas: MQL4, com as subpastas habituais Include e Scripts. Se você clicar no item Lista de arquivos no menu de documentação, verá uma árvore normal com pastas e arquivos. Se você clicar na pasta Include, por exemplo, verá a página "include Directory Reference" com todos os arquivos. No entanto, se eu clicar no nível mais alto - MQL4 - obtenho a página "MQL4 Directory Reference", que tem um subtítulo Directories, mas abaixo dele não há Include nem Scripts. Outros documentos, inclusive o seu, não apresentam esse problema. Qual pode ser o problema?

Já tentei preencher o INPUT na configuração de diferentes maneiras, achei que era o primeiro candidato a configuração incorreta, mudei o RECURSIVE - mas nada ajuda - a documentação é sempre criada de forma normal, exceto por essa nuance irritante.

 
Stanislav Korotky:

Tentei preencher o INPUT na configuração de diferentes maneiras, achei que era o primeiro candidato para a configuração incorreta, mudei o RECURSIVE - mas nada ajuda - a documentação é sempre criada em tudo normal, exceto por essa nuance irritante.

Peguei sua configuração. Ela gera ajuda para minhas fontes sem o problema descrito. Agora tenho que comparar uma dúzia de opções aqui e ali ;-/

 
Stanislav Korotky:

Usei sua configuração. Ela gera ajuda para minhas fontes sem o problema descrito. Agora tenho que comparar uma dúzia de opções aqui e ali ;-/

Por via das dúvidas, estou escrevendo o resultado - pode ser útil para alguém. Descobriu-se que o EXTRACT_ALL afeta o problema. Com NO, as pastas não são exibidas, com YES, elas são exibidas. IMHO, um bug do gerador.

 

Boa tarde.

Provavelmente estou muito atrasado para responder ))))))) Lembro-me de que na GUI do Doxygen há uma opção para marcar "incluindo subdiretórios". Não me lembro muito bem onde ela está, mas é possível encontrá-la.