Здравствуйте, гость ( Вход | Регистрация )
CrackedMind | Дата 22.7.2009, 0:58 |
Хм. QTDIR/tools/qdoc3 |
|
ufna | Дата 22.7.2009, 0:11 |
а QDoc стал открыт массам? или планируется? | |
CrackedMind | Дата 21.7.2009, 4:38 |
Какая то документация совсем даже не полная | |
igor_bogomolov | Дата 23.6.2009, 22:11 |
дану, все исходники Qt задокументированны в коде. Я дальше пояснил, что имею в виду.Любое документирование внутри .h-файла, или внутри любого метода просто игнорируется. Цитата(Litkevich Yuriy) я думаю это связанно с настройками Может быть. Но т.к. раньше никакого описания не было, обойти проблему не смог. Лазание по исходникам резальтата не дало, не встретил нигде документирования внутри кодаНу а раз русский язык не поддерживается, то использование его для ведения своей документации не имеет смысла. |
|
Litkevich Yuriy | Дата 23.6.2009, 22:00 |
В qdoc3 код и документация никак не связаны. дану, все исходники Qt задокументированны в коде.Любое документирование внутри .h-файла, или внутри любого метода просто игнорируется. я думаю это связанно с настройкамиУ QDoc другая проблемма, он непонимает по-русски и исправлять его я устал. Денис (из тролей) его правил для поддержки UTF-8. Но как там дальше дела развивались я не знаю, плюнул. |
|
igor_bogomolov | Дата 23.6.2009, 21:56 |
а что не устраивает? Выглядит на самом деле прилично. Поэтому и появился интерес к ней. Но сразу наткнулся на кучу неудобств, из-за которой отказался от ее использования. Сам Doxygen, оказался очень удобен и прост в использовании.Дока по Qt выглядит приличнее чем то, что поумолчанию генерит DoxyGen. В qdoc3 код и документация никак не связаны. Любое документирование внутри .h-файла, или внутри любого метода просто игнорируется. |
|
Litkevich Yuriy | Дата 23.6.2009, 21:36 |
Правильно ли я понимаю, что сейчас ситуация изменится? Они будут его использовать для своей документации. Я думаю поэтому выложили руководство.То что есть на данный момент меня совершенно не устраевает. а что не устраивает?Дока по Qt выглядит приличнее чем то, что поумолчанию генерит DoxyGen. |
|
igor_bogomolov | Дата 23.6.2009, 21:25 |
Раньше Qt не рекомендовала использовать qdoc3 для ведения документации по коду. Цитата qdoc3 is the tool used to generate the Qt reference documentation. The source code is included as part of this package primarily to fulfill our GPL obligations. We highly recommend using Doxygen (http://www.stack.nl/~dimitri/doxygen/) for generating documentation for your Qt-based application. Правильно ли я понимаю, что сейчас ситуация изменится? Есть ли какие изменения в qdoc3? То что есть на данный момент меня совершенно не устраевает. |
|
Litkevich Yuriy | Дата 23.6.2009, 20:56 |
Руководство по системе документирования Qt (из которой вырос DoxyGen) - QDoc | |
Просмотр темы полностью (откроется в новом окне) | |
Текстовая версия | Сейчас: 28.3.2024, 14:03 |