Комментарии на: Использование Doxygen для документирования кода

От: zendframework

zendframework — Mon, 03 Oct 2011 12:26:02 +0000

Хорошая статья, спасибо! Сам только сел с ним разбираться)

От: ikalnitsky

ikalnitsky — Sun, 28 Aug 2011 09:24:25 +0000

Почему второй вариант хуже? Очевидно, из-за необходимости выравнивать комментарии на одном уровне с комментируемой сущностью, а также из-за избыточных символов *.

Все нормальные редакторы делают это за программиста :)

От: Максим Тремпольцев

Максим Тремпольцев — Mon, 24 Jan 2011 08:28:23 +0000

Если ты попробуешь прочесть статью, то узнаешь почему выбран именно такой стиль.

От: Kerbadun

Kerbadun — Mon, 24 Jan 2011 01:00:37 +0000

Абсолютно ублюдочный стиль комментариев. За такое надо бить ногами.

Просто какая-то рубрика “вредные советы”.

Если чо,

1) @brief можно явно не писать, да и @detailed при определенной настройке тоже;

2) doxygen убирает лишние пробелы, так что никакой необходимости писать комментарий от начала строки нет, так что спокойно можно выравнивать комментарии вместе с кодом, как все нормальные люди и делают.

От: Tim

Tim — Thu, 05 Aug 2010 21:10:33 +0000

Спасибо, мне было полезно это почитать!

От: traveller

traveller — Sat, 03 Jul 2010 16:30:51 +0000

Дякую за хорошу інформацію. Дуже допомогло

От: Дмитрий

Дмитрий — Tue, 01 Jun 2010 12:10:34 +0000

Есть вопрос как к специалисту, пользующемуся doxygen. При генерации документации, если в проекте наряду с классами присутствуют статические структуры, doxygen включает перечень структур в раздел описания классов. Может быть подскажете значение какого ключа в конфигурационном файле следует поменять для того чтобы перечень структур не появлялся в перечне описания классов?

От: Академик

Академик — Thu, 04 Mar 2010 02:28:18 +0000

Спасибо, за хороший материал

От: Максим Тремпольцев

Максим Тремпольцев — Fri, 26 Feb 2010 17:49:32 +0000

Благодарю за внимательность!

От: Obey-Kun

Obey-Kun — Thu, 25 Feb 2010 23:23:54 +0000

Спасибо! Хоть и использовал doxygen, некоторые вещи делал криво.

Только в листингах исправьте &