))
とは逆に定義文の上に書く.
(rdoc Ruby パーサや Javadoc と同じかな?)
* コメントの書式は "smarlty" フォーマット (javadoc に似せてあるらしい),
で, 少なくとも 表示やリスト表示は可能らしい.
(リンクないのかな... 無いとしたらかなり痛いですねぇ....)
* ドキュメントに反映するコメントの行頭には "!!" をつける.
* (かなり問題点) 2 箇所で同じ総称名の interface 文があると
エラーを返して終了する.
(例えば gt4 では Open という総称名を an_generic, gtdata_generic で
使ってるので, 解析できずに終わります. f90 的には問題ない使い方の
はずなのだが...)
* (不満な点) 目次が作成されない. (手作りせなあかん).
* (グッド) 構造体は定義をちゃんと書き出してくれる.
* (グッド) ちゃんと public と private を解析して出力する.
* (グッド) use 文がハイパーリンクに変換され, 別のモジュールに飛べる
== サンプル
(())にて配布される Fortran 90
データ I/O ライブラリ gt4f90io の f90doc 製ドキュメント. なお, 上記に
記述されるとおり, 別のファイル内で同じ手続き名に対してinterface による
多重定義を行なうとエラーを生じて停止するため, ソースコード全てに
対してのドキュメントは生成されていない.
* (())
=end JA