Re: [MD:5165] Meadow-Manual.sdoc

[Shuichi KITAGUCHI <kit@xxxxxxxxxxx>]

三好> HTML にはきちんと変換できているので、やるとすればこちらを使う方向
三好> ですかね。

三好> 次のような案はいかがでしょうか?

三好> o Meadow-Manual.sdoc を HTML に変換して、それを Meadow パッケージ
三好>   に含める。
三好> o README.Meadow の中身はバッサリ削除して、その HTML ファイルへの
三好>   ポインタだけを示す。

このへんは2.10で対応するとして、今回は現状のままにしませんか?
でないと、さすがに英訳が間に合わないでしょうし。

三好> なお、nt/makefile に sdoc -> HTML の変換ルールを追加しておきまし
三好> た。configure.Meadow.bat 再実行後、`nmake doc ' で変換できます。

三好> ただし、Meadow-Manual.html の目次のタイトルが `??' と化けるのが気
三好> になります。

# 何で en の方が化けるのだろう...

北口> # 私はSmartDocでなければいけないと思ってはいないし、Javaはコマンドで
北口> # ちまちま叩くには重いので、他にいいのないかなぁと思いつつある今日この頃。

三好> 私も SmartDoc は今ひとつだと思います。タグだらけで人間がメンテしにくいです。

私は、README/INSTALLの部分はplain text、他はWiki、が一番いいのかなという
気がしています。ただ、Wikiだと共通フォーマットが(たぶん?)ないので、別の場所
で再利用したいことがあった時が難点ですが。

# 実はinfoが一番いいのでは、という気がしなくもない。


--
Shuichi Kitaguchi // kit@xxxxxxxx / ki@xxxxxxxxxxxxxx