From: Tadashi Saito <shiba@...2.accsnet.ne.jp>
Date: 2008-03-01T20:36:34+09:00
Subject: [ruby-list:44711] Re: RDoc,RDフォーマットの公式文書はどこにあるのでしょうか

斎藤と申します。

On Fri, 22 Feb 2008 18:04:54 +0900
小西 弘将 <konishih@fd6.so-net.ne.jp> wrote:

> >それがHTMLに成形された物はここで見られます。
> >
> >http://www.ruby-doc.org/core/classes/RDoc.html
> こういうサイトがあるんですね。ちなみにこのサイトはRubyコミュニティとして
> 公式な意味合いを持つと考えてよいのでしょうか?

「公式な意味合い」というのが、何を求めていらっしゃるのかよく掴み切れな
かったのですが、

  http://www.ruby-doc.org/

の下の方を見る限りでは、James Brittさん個人がメンテナとのことで、少なく
ともruby-lang.org との直接の関わりはなさそうです。

> 別に両方とも可読性が良いので問題ないかもしれませんが、現在HTMLなどへの
> パーサが標準添付されているのがRDocのみであることを考えると、この辺は統一
> した方がよいような気がします。

自分はまぁ、いいのかなぁと思っています。もともと「そのまま読める」のが売りの
両者ですし、生成できるHTMLは共通規格ですよね。
加えて、新しいリファレンスマニュアルプロジェクト

  http://doc.loveruby.net/refm/api/

では、RDをベースにした独自のフォーマットを使っているようです。

  http://doc.loveruby.net/wiki/ReferenceManualFormatDigest.html

百花繚乱という感じですが、自然と良いものを相互に吸収し合っていけば
いいのかな、と自分は考えています。

> RDocについては、インストール後も見られる場所にあったり、ruby-lang.orgか
> らたどれるとありがたいのですが。どうでしょうか?

Unix系OSの通常のビルドプロセスだと、インストール時に指定すれば
(make install-doc)ドキュメントもインストールされます。Windowsについては
よく存じませんが、探せば別途配布していたり、あるいは既にインストールされて
いたりするのではないかと邪推しますが、いかがでしょうか。

またruby-lang.orgからは、

  http://www.ruby-lang.org/en/documentation/

の「Reference Documentation」の項から

  http://www.ruby-doc.org/stdlib/
  http://www.ruby-doc.org/core/

にそれぞれ、リンクが張られてたどれる状態になっていますね。

-- 
斎藤ただし