HTML документация, часть 2 - PullRequest
Новая
       7

HTML документация, часть 2

0 голосов
/ 22 августа 2011

Ну, как и предлагалось в предыдущем вопросе , я попробовал GUI-версию sandcastle и doxygen.

К сожалению, мне кажется, что я действительно плохо нажимаю на кнопки:

  • Sandcastle:

    Генерирует множество файлов HTM с несвязанными именами, «компилирует» их в chm и удаляет их.Файл CHM не содержит файлов вообще!Просто указатель, который ведет к ошибочным страницам.

  • Doxygen:

    Создает совершенно хороший HTML, но по какой-то причине не документирует все классы (хотя Все классы задокументированы, как и все методы и свойства).

Что я могу сделать?

Ответы [ 2 ]

2 голосов
/ 22 августа 2011

Re Sandcastle: обратите внимание, что файлы .chm в новых версиях Windows по умолчанию заблокированы. Увидеть Как отобразить содержимое .chm

1 голос
/ 23 августа 2011

Для doxygen вы можете попробовать, если это поможет, если вы установите для EXTRACT_ALL значение YES в файле конфигурации (он находится в разделе Expert-> Build in GUI).сообщите в системе отслеживания ошибок doxygen (https://bugzilla.gnome.org/enter_bug.cgi?product=doxygen)) и добавьте отдельный пример (файл source + config), который демонстрирует проблему.

...