Javadoc のご先祖

もう1本読んだ論文．1986年と古いが，プログラミング言語からドキュメントをどうやって抽出するか，という話．

Multilingual programming: Coordinating programs, user interfaces, on-line help and documentation, Gary Perlman February 1986 Proceedings of the 4th annual international conference on Systems documentation SIGDOC '85
Publisher: ACM Press

/* sqrt: square root */
double sqrt (x);
double x; /* must be non-negative */

から, man を生成する仕組みとか，

OPT (w, width, Line Width, INT, 0. 72, value>O)
OPT (n, number, Line Numbering. LGL, 0, FALSE)
OPT (h, header, Page Header, STRING, 0, length(value) < optval(ridth))

と書いておくと，コマンドラインオプションのパーサ，および使い方のmanが生成される，とかいうお話．こんな話が20年前から行われている．