 qdoc3 - появилось руководство! |
Здравствуйте, гость ( Вход | Регистрация )
  |
Litkevich Yuriy опции профиля:
|
 23.6.2009, 20:56
Сообщение
#1
|
 разработчик РЭА  Группа: Сомодератор Сообщений: 9669 Регистрация: 9.1.2008 Из: Тюмень Пользователь №: 64 Спасибо сказали: 807 раз(а) Репутация:  94 
 |
Руководство по системе документирования Qt (из которой вырос DoxyGen) - QDoc
|
 |
  
|
|
igor_bogomolov опции профиля:
|
23.6.2009, 21:25
Сообщение
#2
|
|
Профессионал Группа: Сомодератор Сообщений: 1215 Регистрация: 22.3.2009 Из: Саратов Пользователь №: 630 Спасибо сказали: 235 раз(а) Репутация: 29
|
Раньше 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, 21:36
Сообщение
#3
|
|
разработчик РЭА Группа: Сомодератор Сообщений: 9669 Регистрация: 9.1.2008 Из: Тюмень Пользователь №: 64 Спасибо сказали: 807 раз(а) Репутация: 94
|
Цитата(igor_bogomolov @ 24.6.2009, 1:25)  Правильно ли я понимаю, что сейчас ситуация изменится? Они будут его использовать для своей документации. Я думаю поэтому выложили руководство.Цитата(igor_bogomolov @ 24.6.2009, 1:25) То что есть на данный момент меня совершенно не устраевает. а что не устраивает?Дока по Qt выглядит приличнее чем то, что поумолчанию генерит DoxyGen. |
|
|
|
|
igor_bogomolov опции профиля:
|
23.6.2009, 21:56
Сообщение
#4
|
|
Профессионал Группа: Сомодератор Сообщений: 1215 Регистрация: 22.3.2009 Из: Саратов Пользователь №: 630 Спасибо сказали: 235 раз(а) Репутация: 29
|
Цитата(Litkevich Yuriy @ 23.6.2009, 22:36) а что не устраивает? Выглядит на самом деле прилично. Поэтому и появился интерес к ней. Но сразу наткнулся на кучу неудобств, из-за которой отказался от ее использования. Сам Doxygen, оказался очень удобен и прост в использовании.Дока по Qt выглядит приличнее чем то, что поумолчанию генерит DoxyGen. В qdoc3 код и документация никак не связаны. Любое документирование внутри .h-файла, или внутри любого метода просто игнорируется. |
|
|
|
|
Litkevich Yuriy опции профиля:
|
23.6.2009, 22:00
Сообщение
#5
|
|
разработчик РЭА Группа: Сомодератор Сообщений: 9669 Регистрация: 9.1.2008 Из: Тюмень Пользователь №: 64 Спасибо сказали: 807 раз(а) Репутация: 94
|
Цитата(igor_bogomolov @ 24.6.2009, 1:56) В qdoc3 код и документация никак не связаны. дану, все исходники Qt задокументированны в коде.Цитата(igor_bogomolov @ 24.6.2009, 1:56) Любое документирование внутри .h-файла, или внутри любого метода просто игнорируется. я думаю это связанно с настройкамиУ QDoc другая проблемма, он непонимает по-русски и исправлять его я устал. Денис (из тролей) его правил для поддержки UTF-8. Но как там дальше дела развивались я не знаю, плюнул. |
|
|
|
|
igor_bogomolov опции профиля:
|
23.6.2009, 22:11
Сообщение
#6
|
|
Профессионал Группа: Сомодератор Сообщений: 1215 Регистрация: 22.3.2009 Из: Саратов Пользователь №: 630 Спасибо сказали: 235 раз(а) Репутация: 29
|
Цитата(Litkevich Yuriy @ 23.6.2009, 23:00) дану, все исходники Qt задокументированны в коде. Я дальше пояснил, что имею в виду.Цитата(igor_bogomolov @ 23.6.2009, 22:56) Любое документирование внутри .h-файла, или внутри любого метода просто игнорируется. Цитата(Litkevich Yuriy) я думаю это связанно с настройками Может быть. Но т.к. раньше никакого описания не было, обойти проблему не смог. Лазание по исходникам резальтата не дало, не встретил нигде документирования внутри кодаНу а раз русский язык не поддерживается, то использование его для ведения своей документации не имеет смысла. |
|
|
|
|
CrackedMind опции профиля:
|
21.7.2009, 4:38
Сообщение
#7
|
|
Студент Группа: Участник Сообщений: 44 Регистрация: 13.3.2009 Пользователь №: 611 Спасибо сказали: 7 раз(а) Репутация: 0
|
Какая то документация совсем даже не полная
|
|
|
|
|
ufna опции профиля:
|
22.7.2009, 0:11
Сообщение
#8
|
 Активный участник Группа: Участник Сообщений: 362 Регистрация: 24.5.2008 Из: Курган/СПб Пользователь №: 182 Спасибо сказали: 29 раз(а) Репутация: 5
|
а QDoc стал открыт массам? или планируется?
|
|
|
|
|
CrackedMind опции профиля:
|
22.7.2009, 0:58
Сообщение
#9
|
|
Студент Группа: Участник Сообщений: 44 Регистрация: 13.3.2009 Пользователь №: 611 Спасибо сказали: 7 раз(а) Репутация: 0
|
Хм.
QTDIR/tools/qdoc3 |
|
|
|
 |
Теги
Нет тегов для показа
4 чел. читают эту тему (гостей: 4, скрытых пользователей: 0)
Пользователей: 0
|
|
Текстовая версия | Сейчас: 22.12.2024, 5:26 |