[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[debian-users:26996] Re: sub()/gsub() error in gawk-ja


> FSF products では man は obsolate で info 推奨(man の方は積極的には
> 更新されない)という立場だったと思うんですが、どこで見たんだったか
> 忘れてしまった。。。。どこでしたっけ?

GNU Coding Standard の Documentation の章:

GNU Manuals節 冒頭において

The preferred document format for the GNU system is the Texinfo
formatting language. Every GNU package should (ideally) have
documentation in Texinfo both for reference and for learners. Texinfo
makes it possible to produce a good quality formatted book, using TeX,
and to generate an Info file. It is also possible to generate HTML
output from Texinfo source. See the Texinfo manual, either the
hardcopy, or the on-line version available through info or the Emacs
Info subsystem (C-h i).

Nowadays some other formats such as Docbook and Sgmltexi can be
converted automatically into Texinfo.  It is ok to produce the Texinfo
documentation by conversion this way, as long as it gives good

 TeXinfo が標準、それを生成するためのツール(Sgmltexi など)を使うことの認可について記述され、

GNU Manuals節 終わりに

Don't use Unix man pages as a model for how to write GNU
documentation; most of them are terse, badly structured, and give
inadequate explanation of the underlying concepts. (There are, of
course, some exceptions.) Also, Unix man pages use a particular format
which is different from what we use in GNU manuals.

と man ページへの酷評 :-) が述べられています。

  GNU Document は参照目的の他にチュートリアルも含めることを必須として
いるので、man ページにしてしまうと平板に長くなりすぎて読みにくいと思い

  自分が info に対して不満があるとすれば、検索などでページを飛んでしまっ
すぐに迷子になる! 画面上部に表示されているノードの名前と章の名前が一致

  マイクロソフトの開発環境のヘルプシステム(内容の質はおいておいて :-) 
要でなければ閉じておけるし、切り離すこともできる…。info ファイル自体

   _/_/_/  -@-----------------------------------------------------@-  
  _/     |Furusawa Hirofumi: fsawa@xxxxxxxxxxxxxxx      Chiba, Japan |
 _/_/_/  +-----------------------------------------------------------+
_/       | Organization: Chiba Univ. Department of Law and Economics |