青山です。

Mon, Feb 22, 1999 at 01:44:33PM +0900 において
GOTO Kentaro さん曰く:

> これやって思ったんですけど，やっぱりこの手のドキュメントは
> 素手で書くのは危険です．多かった間違いを指摘しておくと，
> 
>   * <P>... <BLOCKQUOTE> ... </BLOCKQUOTE> ... </P> はダメ
>     <P>...</P> <BLOCKQUOTE> ... </BLOCKQUOTE> <P> ... </P> にすべき
>   * <LI> の直後，<A> の直後，</A> の直前には空白はおかない．
>   * MethodIndex.html に "#[]" などの危険な文字かつ
>     存在しないリンク
>   * 入れ子の間違い(特にインライン要素の中にブロック要素が多い)
>   * == のアンカー名が不統一
> 
> やはり，青山さんのツール(よく知らないですが)などを使った
> 方がいいかと思います．

残念ながら、タグの閉じ忘れが発生しないという程度で、文法チェックまでは
しないつもりです。面白そうだとは思うのですが、そのあたりは素直に文法チェ
ッカにまかせて良いかなと。

ドキュメントの一括生成という事では、やはり rd (Ruby Document)、および
それに関するツールの整備が必要と思われます。(ツールって何かあるのでし
たっけ？)


-- 
青山 和光 Wakou Aoyama <wakou / fsinet.or.jp>