YamaKen
yamak****@bp*****
2006年 4月 6日 (木) 05:51:53 JST
ヤマケンです。 太田さんがtexinfo形式のドキュメント一式をcommitしてくれましたが、 一部のドキュメントはplain textに戻したいと思うので意見聞かせてく ださい。 ユーザ向けの関数リファレンス等は他プロジェクトからの既存資産の流 用等も考慮に入れてtexinfo形式でもいいと思うんですが、どちらかと いうとSigScheme開発者間での情報共有のための内部メモに近い文書は、 コード書き/変更に伴ってガリガリ更新するそばからそのまま参照でき る形式が望ましいです。texinfoは色付けてもやっぱり見にくいです。 具体的に名指しすると、spec.txtとdesign.txtがそうです。spec.txtの 更新内容をfeatures.texiにも反映してみましたが、特に引用や itemized listの編集が面倒かつ見にくいです。 現在spec.txtとdesign.txtを実験的にAsciiDoc形式に書き換えてありま すが、plain textとしての見栄えもHTML等への変換結果も満足できるも のだと思います。というわけで、中の人寄りの頻繁に書き換える文書は これで書きませんか? ------------------------------- ヤマケン yamak****@bp*****
