Обсуждение статьи "Автоматическое создание документации к программам на MQL5"

[MetaQuotes]

Опубликована статья Автоматическое создание документации к программам на MQL5:

В статье описано, как можно использовать программу Doxygen для создания структурированных файлов справки HTML для программ, написанных на MQL5. Затем они легко могут быть скомпилированы в файлы справки CHM при помощи программы Microsoft's HTML Help Workshop.

Автор: Paul

[Christo Tsvetanov]

Молодец! Хотя годится только если продаете MQL5 библиотеки :(

[Alexander]

Спасибо за статью! То что нужно. А может есть генераторы с msdn стилем?

[Automated-Trading]

Важно правильно указывать кодировку при создании документации к программам, содержащим комментарии на русском языке.

В противном случае вместо русскоязычных комментариев могут получиться квадратики:

По умолчанию в Doxygen в опциях проекта (Expert->Project) опция DOXYFILE_ENCODING установлена как UTF-8,

поэтому при подготовке документации лучше создать отдельную папку с файлами, сохраненными в кодировке UTF-8:

В результате получим:

Другая важная опция OUTPUT_LANGUAGE, с указанным языком (Russian) позволяет создавать меню и описание на русском языке:

Документация упрощает изучение структуры и свойств программ, поэтому старайтесь прикладывать документацию к исходным кодам.

[Alexander]

Automated-Trading писал(а) # :

поэтому при подготовке документации лучше создать отдельную папку с файлами, сохраненными в кодировке UTF-8:

Проще на вкладке Input задать INPUT_ENCODING как windows-1251. И никаких проблем с кодировками

[Automated-Trading]

GarF1eld писал(а) # :
Проще на вкладке Input задать INPUT_ENCODING как windows-1251. И никаких проблем с кодировками

конечно так было бы проще.

но почему-то doxygen (у меня 1.6.2) во все файлы вставляет

<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>

хотя в настройках

т.е файлы в нужной кодировке, а отображение можно исправить если во всех html-файлах заменить на:

<meta http-equiv="Content-Type" content="text/xhtml;charset=windows1251"/>

но вопрос в том, как побороть его, чтобы он это делал самостоятельно.

[Alexander]

Честно говоря не замечал, т.к меня вполне устраивает UTF-8, а когда была проблема с крокозяблами, просто изменил INPUT_ENCODING

[Roffild]

Вроде общепринято @param вместо \param для совместимости с другими докогенераторами.

Будет замечательно, если принять этот стандарт на уровне MQL, а то настоящий стиль комментирования кода странный - много лишних //////.

А если добавить поддержку на уровне MetaEditor, как это сделано в Eclipse... ммм...

[Roffild]

Версия 1.8.7 последняя с поддержкой MQL.

Баг где-то среди этих коммитов.

Кто найдет - сообщите.

[Denis Savenko]

Roffild:

Версия 1.8.7 последняя с поддержкой MQL.

Баг где-то среди этих коммитов.

Кто найдет - сообщите.

Спасибо. Все перерыл пока боролся последними версиями( Да выше 1.8.7 не идет. По коммитам так и не понял в чём подвох(

[Roffild]

Сейчас взял старый конфиг, который был создан до версии 1.8.8, и исправил: 

EXTENSION_MAPPING      = mq5=C++ mqh=C++

Работает!!!111