epydocのreStructuredText
ディレクトリ指定で中身を全部処理するタイプのものがこれしか無かったので、docstringをhtml化するツールとしてepydocを選択している(sphinxとかpydocでもできるのかしら?)。
で、マークアップ方式にrestructuredTextを指定すると途中で死ぬ。
> epydoc.py -o docs --docformat restructuredtext pymeshio UNEXPECTED ERROR: 'Text' object has no attribute 'data'
docstringの書き方がまずいのかと思いきやepydocの問題らしい。
検索すると、epydocは既にメンテされてないのでパッチ当てれということだった。
- http://stackoverflow.com/questions/6704770/epydoc-attributeerror-text-object-has-no-attribute-data
- http://cvs.pld-linux.org/cgi-bin/cvsweb.cgi/packages/epydoc/
パッチを当てて動くようなった。
$ cd site-package/epydoc-3.0.1-py2.7-win32.egg/ $ patch -p1 < epydoc-rst.patch patching file epydoc/markup/restructuredtext.py