Python documentation
Нужно создать документацию к python-проекту.
Я попробовал Doxygen, и он её создаёт, читает docstring, но проблема в том, что он почему-то не выводит названия методов и не парсит @param, хотя в его документации указано, что он так может. На приложенном скриншоте это видно.
Подскажите, пожалуйста, как можно это исправить или подскажите другую программу по созданию документации (docstring у всех функций прописаны в соответствии с PEP-257)
Скриншот того, как doxygen создаёт:
[ATTACH=CONFIG]5232[/ATTACH]
Я попробовал Doxygen, и он её создаёт, читает docstring, но проблема в том, что он почему-то не выводит названия методов и не парсит @param, хотя в его документации указано, что он так может. На приложенном скриншоте это видно.
Подскажите, пожалуйста, как можно это исправить или подскажите другую программу по созданию документации (docstring у всех функций прописаны в соответствии с PEP-257)
Скриншот того, как doxygen создаёт:
[ATTACH=CONFIG]5232[/ATTACH]
В данном вопросе не силён, но в теме должно быть упомянуто это:
http://docs.python.org/documenting/index.html
Добавлено позже:
хотя, туплю. Думаю, вот это ближе к теме:
http://docs.python.org/library/pydoc.html
http://docs.python.org/documenting/index.html
Добавлено позже:
хотя, туплю. Думаю, вот это ближе к теме:
http://docs.python.org/library/pydoc.html
Этот pydoc выдаёт no Python documentation found for 'patients.py' и т. п.
притом что внутри всё оформлено по стандарту))
В итоге я сгенерил epydoc'ом, хотя получилось не так красиво)) epydoc тоже не без багов и не понимает @param, но зато имена методов он видит
Upd: epydoc видит @param и прочее, но если они написаны в его стиле, а его стиль @param var: описание..
притом что внутри всё оформлено по стандарту))
В итоге я сгенерил epydoc'ом, хотя получилось не так красиво)) epydoc тоже не без багов и не понимает @param, но зато имена методов он видит
Upd: epydoc видит @param и прочее, но если они написаны в его стиле, а его стиль @param var: описание..