Руководство по системе документирования Qt (из которой вырос DoxyGen) - QDoc

Раньше Qt не рекомендовала использовать qdoc3 для ведения документации по коду.


Правильно ли я понимаю, что сейчас ситуация изменится?
Есть ли какие изменения в qdoc3? То что есть на данный момент меня совершенно не устраевает.

Они будут его использовать для своей документации. Я думаю поэтому выложили руководство.

а что не устраивает?
Дока по Qt выглядит приличнее чем то, что поумолчанию генерит DoxyGen.

Выглядит на самом деле прилично. Поэтому и появился интерес к ней. Но сразу наткнулся на кучу неудобств, из-за которой отказался от ее использования. Сам Doxygen, оказался очень удобен и прост в использовании.

В qdoc3 код и документация никак не связаны. Любое документирование внутри .h-файла, или внутри любого метода просто игнорируется.

дану, все исходники Qt задокументированны в коде.

я думаю это связанно с настройками

У QDoc другая проблемма, он непонимает по-русски и исправлять его я устал. Денис (из тролей) его правил для поддержки UTF-8. Но как там дальше дела развивались я не знаю, плюнул.

Я дальше пояснил, что имею в виду.
Может быть. Но т.к. раньше никакого описания не было, обойти проблему не смог. Лазание по исходникам резальтата не дало, не встретил нигде документирования внутри кода

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

Какая то документация совсем даже не полная

а QDoc стал открыт массам? или планируется?

Хм.
QTDIR/tools/qdoc3