История изменений
Исправление quiet_readonly, (текущая версия) :
- qdoc в оригинале генерирует промежуточную XML-разметку из комментариев в cpp-файлах (некоторые такие файлы ЕМНИП имеют расширение *.qdoc вместо *.cpp, чтобы понятнее было). В исходниках Qt и QtCreator можно найти много примеров. Суровый мануал: qt.apidoc.info/5.1.1/qdoc/qdoc-guide-conf.html
- doxygen тоже может в qdoc (qch), точнее в промежуточное XML-описание. Только в какой-то из старых версий был баг, где сгенерированный XML-файл был некорректным из-за одного тега, позднее баг в doxygen исправили.
- Готовая документация для STL, CMake, Ogre и других библиотек: wiki.qt.io/Qt_Creator_Documentation_Gallery
- Для написания доков к не-API я очень рекомендую Github + файлы Markdown, сам в конечном счёте к такому пришёл.
Исправление quiet_readonly, :
- qdoc в оригинале генерирует промежуточную XML-разметку из комментариев в cpp-файлах (некоторые такие файлы ЕМНИП имеют расширение *.qdoc). В исходниках Qt и QtCreator можно найти много примеров. Суровый мануал: qt.apidoc.info/5.1.1/qdoc/qdoc-guide-conf.html
- doxygen тоже может в qdoc (qch), точнее в промежуточное XML-описание. Только в какой-то из старых версий был баг, где сгенерированный XML-файл был некорректным из-за одного тега, позднее баг в doxygen исправили.
- Готовая документация для STL, CMake, Ogre и других библиотек: wiki.qt.io/Qt_Creator_Documentation_Gallery
- Для написания доков к не-API я очень рекомендую Github + файлы Markdown, сам в конечном счёте к такому пришёл.
Исходная версия quiet_readonly, :
- qdoc в оригинале генерирует промежуточную XML-разметку из комментариев в cpp-файлах (некоторые такие файлы ЕМНИП имеют расширение *.qdoc). В исходниках Qt и QtCreator можно найти много примеров. Суровый мануал: qt.apidoc.info/5.1.1/qdoc/qdoc-guide-conf.html
- doxygen тоже может в qdoc (qch), точнее в промежуточное XML-описание. Только в какой-то из старых версий был баг, где сгенерированный XML-файл был некорректным из-за одного тега, позднее баг в doxygen исправили.
- Готовая документация для STL, CMake, Ogre и других библиотек: wiki.qt.io/Qt_Creator_Documentation_Gallery