Модераторы: Daevaorn
  

Поиск:

Ответ в темуСоздание новой темы Создание опроса
> Генераторы документации 
:(
    Опции темы
Mal Hack
Дата 1.8.2008, 21:34 (ссылка) | (нет голосов) Загрузка ... Загрузка ... Быстрая цитата Цитата


Мудрый...
****


Профиль
Группа: Участник Клуба
Сообщений: 9926
Регистрация: 15.2.2004

Репутация: 2
Всего: 261
Доброе.

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


СУВ.
PM ICQ   Вверх
Daevaorn
Дата 1.8.2008, 21:36 (ссылка) | (голосов:2) Загрузка ... Загрузка ... Быстрая цитата Цитата


Эксперт
****


Профиль
Группа: Комодератор
Сообщений: 2155
Регистрация: 29.11.2004
Где: Москва

Репутация: 51
Всего: 70
Doxygen. Использовал именно его.

Вообще систем много и на любой вкус.
PM MAIL WWW   Вверх
JackYF
Дата 2.8.2008, 14:39 (ссылка) | (нет голосов) Загрузка ... Загрузка ... Быстрая цитата Цитата


полуавантюрист
****


Профиль
Группа: Участник
Сообщений: 5814
Регистрация: 28.8.2004
Где: страна тысячи озё р

Репутация: 18
Всего: 162
Тоже пробовал Doxygen - вполне приличная штука.


--------------------
Пожаловаться на меня как модератора можно здесь.
PM MAIL Jabber   Вверх
Mal Hack
Дата 2.8.2008, 16:50 (ссылка) | (нет голосов) Загрузка ... Загрузка ... Быстрая цитата Цитата


Мудрый...
****


Профиль
Группа: Участник Клуба
Сообщений: 9926
Регистрация: 15.2.2004

Репутация: 2
Всего: 261
Да, doxygen меня искренне порадовал, но мне хотелось несколько другого, чтоб комментариии в коде делалились, или хотя бы как правильно их оформлять. С правилами оформления кода я знаком, а вот с комментариями...
PM ICQ   Вверх
Torsten
Дата 2.8.2008, 17:58 (ссылка) | (голосов:2) Загрузка ... Загрузка ... Быстрая цитата Цитата


Бывалый
*


Профиль
Группа: Участник
Сообщений: 174
Регистрация: 10.6.2008
Где: Pskov

Репутация: 3
Всего: 7
Цитата(Mal Hack @  2.8.2008,  16:50 Найти цитируемый пост)
Да, doxygen меня искренне порадовал, но мне хотелось несколько другого, чтоб комментариии в коде делалились, или хотя бы как правильно их оформлять. С правилами оформления кода я знаком, а вот с комментариями...

если код хороший - комметарии не нужны, практически. За исключением тонких ньансов и некрасивых конструкций.
Главное, чтобы читать код можно было без запинок двухзначностей.
--------------------
We have no begining, we have no end. We are infinite.
PM MAIL   Вверх
Lazin
Дата 2.8.2008, 21:20 (ссылка) | (голосов:1) Загрузка ... Загрузка ... Быстрая цитата Цитата


Эксперт
****


Профиль
Группа: Завсегдатай
Сообщений: 3820
Регистрация: 11.12.2006
Где: paranoid oil empi re

Репутация: 41
Всего: 154
Цитата(Torsten @  2.8.2008,  17:58 Найти цитируемый пост)
если код хороший - комметарии не нужны, практически. За исключением тонких ньансов и некрасивых конструкций.
Главное, чтобы читать код можно было без запинок двухзначностей.

документируют обычно не код, а структуру кода...


--------------------
C++ is the steampunk of programming languages: modern ideas realized with victorian technology.
PM MAIL Skype GTalk   Вверх
Mal Hack
Дата 3.8.2008, 05:57 (ссылка) | (нет голосов) Загрузка ... Загрузка ... Быстрая цитата Цитата


Мудрый...
****


Профиль
Группа: Участник Клуба
Сообщений: 9926
Регистрация: 15.2.2004

Репутация: 2
Всего: 261
Цитата(Lazin @  2.8.2008,  22:20 Найти цитируемый пост)
документируют обычно не код, а структуру кода... 

Т.е. структуру кода? Я имею ввиду "расширить понятие"
PM ICQ   Вверх
  
 Ответ в темуСоздание новой темы Создание опроса
Правила форума "С++:Общие вопросы"
Earnest Daevaorn

Добро пожаловать!

  • Черновик стандарта C++ (за октябрь 2005) можно скачать с этого сайта. Прямая ссылка на файл черновика(4.4мб).
  • Черновик стандарта C (за сентябрь 2005) можно скачать с этого сайта. Прямая ссылка на файл черновика (3.4мб).
  • Прежде чем задать вопрос, прочтите это и/или это!
  • Здесь хранится весь мировой запас ссылок на документы, связанные с C++ :)
  • Не брезгуйте пользоваться тегами [code=cpp][/code].
  • Пожалуйста, не просите написать за вас программы в этом разделе - для этого существует "Центр Помощи".
  • C++ FAQ

Если Вам понравилась атмосфера форума, заходите к нам чаще! С уважением, Earnest Daevaorn
 
0 Пользователей читают эту тему (0 Гостей и 0 Скрытых Пользователей)
0 Пользователей:
« Предыдущая тема | C/C++: Общие вопросы | Следующая тема »

Подписаться на тему | Подписка на этот форум | Скачать/Распечатать тему


 




[ Время генерации скрипта: 0.0574 ]   [ Использовано запросов: 22 ]   [ GZIP включён ]


Реклама на сайте     Информационное спонсорство

 
 По вопросам размещения рекламы пишите на vladimir(sobaka)vingrad.ru
Отказ от ответственности     Powered by Invision Power Board(R) 1.3 © 2003  IPS, Inc.