Справочник функций

Ваш аккаунт

Войти через: 
Забыли пароль?
Регистрация
Информацию о новых материалах можно получать и без регистрации:

Почтовая рассылка

Подписчиков: -1
Последний выпуск: 19.06.2015

Python documentation

271
14 июля 2011 года
MrXaK
721 / / 31.12.2002
Нужно создать документацию к python-проекту.
Я попробовал Doxygen, и он её создаёт, читает docstring, но проблема в том, что он почему-то не выводит названия методов и не парсит @param, хотя в его документации указано, что он так может. На приложенном скриншоте это видно.
Подскажите, пожалуйста, как можно это исправить или подскажите другую программу по созданию документации (docstring у всех функций прописаны в соответствии с PEP-257)

Скриншот того, как doxygen создаёт:
[ATTACH=CONFIG]5232[/ATTACH]
87
14 июля 2011 года
Kogrom
2.7K / / 02.02.2008
В данном вопросе не силён, но в теме должно быть упомянуто это:
http://docs.python.org/documenting/index.html

Добавлено позже:
хотя, туплю. Думаю, вот это ближе к теме:
http://docs.python.org/library/pydoc.html
271
15 июля 2011 года
MrXaK
721 / / 31.12.2002
Этот pydoc выдаёт no Python documentation found for 'patients.py' и т. п.
притом что внутри всё оформлено по стандарту))

В итоге я сгенерил epydoc'ом, хотя получилось не так красиво)) epydoc тоже не без багов и не понимает @param, но зато имена методов он видит

Upd: epydoc видит @param и прочее, но если они написаны в его стиле, а его стиль @param var: описание..
Реклама на сайте | Обмен ссылками | Ссылки | Экспорт (RSS) | Контакты
Добавить статью | Добавить исходник | Добавить хостинг-провайдера | Добавить сайт в каталог