Russian Qt Forum
Май 06, 2024, 05:11 *
Добро пожаловать, Гость. Пожалуйста, войдите или зарегистрируйтесь.
Вам не пришло письмо с кодом активации?

Войти
 
  Начало   Форум  WIKI (Вики)FAQ Помощь Поиск Войти Регистрация  

Страниц: [1]   Вниз
  Печать  
Автор Тема: Doxygen, документирование перечислений  (Прочитано 5577 раз)
Rcus
Гость
« : Апрель 17, 2009, 18:09 »

Диспозиция такова:
по-умолчанию Doxygen генерирует для enum'ов полное описание объявления в заголовке с численным значениями (если указаны), в детальном описании идет таблица без численных значений.

А хотелось бы получить вид аналогичный документации Qt: без значений в заголовке и таблицу со значениями в деталях. И совсем уж круто было бы узнать как разбить документацию значений по группам.

Маны раскуривал, гугл мучал, но Грустный
Записан
igor_bogomolov
Гость
« Ответ #1 : Апрель 19, 2009, 13:59 »

А хотелось бы получить вид аналогичный документации Qt
Qt не использует Doxygen для генерации документации. У них есть QTDIR\tools\qdoc3.
Если хотите иметь документацию в стиле Qt, можете использовать эту утилиту. Помимо html, с ее помощь можно также одновременно сгенерировать .qhp файлы.

Правда там есть свои недостатни. ИМХО.
Записан
Rcus
Гость
« Ответ #2 : Апрель 19, 2009, 14:15 »

qdoc3 не хотеть:
во-первых к нему никакого хелпа,
во-вторых его не рекомендуют использовать, о чем указано в README.TXT,
в-третьих Doxygen тоже умеет qch/qhp, о чем была статья в QQ (и при подключении в хелп креатора даже контекстная справка работает)
Записан
igor_bogomolov
Гость
« Ответ #3 : Апрель 19, 2009, 14:38 »

во-первых к нему никакого хелпа,
Можно в исходниках подсматривать необходимое оформление.

Другого способа навести такие красивости, как вы хотите я не знаю. Если только самому таблицу формировать через <TABLE>.

Если найдете способ, отпишитесь, мне тоже интересно Улыбающийся
Записан
Rcus
Гость
« Ответ #4 : Апрель 20, 2009, 09:06 »

Более методичное раскуривание манов приносит свои плоды:
Doxygen умеет генерировать документацию в XML формате и в ней есть вся нужная информация. Проблема только в том чтобы преобразовать XML в человечный HTML, но на сайте Doxygen есть несколько линков, как продвинусь в этом деле отпишусь.
Записан
Страниц: [1]   Вверх
  Печать  
 
Перейти в:  


Страница сгенерирована за 0.125 секунд. Запросов: 20.