Saturday, March 22, 2008

epydoc.el 公開しました

epydoc 形式のドキュメンテーションをサポートする emacs lisp, epydoc.el なるものを作りました。
http://code.google.com/p/epydoc-el/

epydoc について知りたい方はこちら
http://epydoc.sourceforge.net/

使いかたは epydoc.el を load-path が通っているところに置き
.emacs などで
(require 'epydoc)
とすればOKです。

あとは python ソースコードの中で
M-x epydoc-insert-file-comment
とすればファイルに対するepydocのテンプレートが出力されます。

また関数(メソッド)を定義している行(def hogefunc(arg1,arg2): のような行)で
M-x epydoc-insert-function-comment
とすれば関数(メソッド)に対するテンプレートが出力されます。

関数の直後に必ず文が無いとインデントが狂うといった問題がありますが、よろしければ使っていただけると幸いです。

日本語での感想、改善点などもこちらのブログにお寄せください。

それにしても今回参考にしたdoxygen.elの改造版を配布する許可をもらおうとしたら作者のアドレスが変わっていてちと焦った...。
調べてみたらなんかcjkvに詳しそうな人でした。
http://www.dreamersrealm.net/~tree/blog/?cat=15&submit=GO

あと
http://mailhide.recaptcha.net/
なる画像パスワードによるスパム防止サービスを初めて知りました。
http://recaptcha.net/learnmore.html
今度からメールアドレスを公開するときはこれを使おうと思います。