- 505 名前:デフォルトの名無しさん [2009/08/22(土) 17:02:41 ]
- モジュールの先頭に """あれこれ""" とか
クラスの先頭に """のれそれ""" 書いてドキュメントとしています. pydoc にかけるとそれらはただ単なる文字列として表示されるだけ なんですが,なんかこう,定められたフォーマットとかあるんでしょうか? それとは別にどっかで見たので __author__ とか __licence__ とか 設定してみたんですが,pydoc はそういうのはガン無視らしいです. いままで覚書をコメント文で書いていたんですが, ドキュメントのこともそろそろちゃんと考えないと 自分的に破たんする(先月の自分は自分じゃない)とおもって Python使いの方はどうやってるのかと.
|

|