ruby-list

斎藤と申します。

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/

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

-- 
斎藤ただし

Thread

Prev Next

In This Thread

Prev Next

[#44709] Rails勉強会@東北第8回のお知らせ — 片平 裕市 <yuichi_katahira@...>

[#44710] Rails勉強会@東北第9回のお知らせ(再送) — 片平 裕市 <yuichi_katahira@...>

[#44712] Mysql not loaded — 遠藤 明 <endo4917@...>

[#44713] パイプ経由コマンド実行？ — "morita" <m-morita@...>

[#44723] Ruby 1.8.6-p114 / 1.8.5-p115 released (Security Fix) — Urabe Shyouhei <shyouhei@...>

[#44725] Set[Set[1]]==Set[Set[1]] は偽？ — "5.5" <5.5@...>

[#44728] ダウンロードリンクが古い — Kouhei Yanagita <yanagi@...>

[#44738] [Mac OS X] foo-X.Y.Z.gem をダウンロードすると foo-X.Y.Z.gem.tar になってしまう — NISHIMATSU Takeshi <t_nissie@...>

[#44739] Re: Set[Set[1]]==Set[Set[1]] は偽？ — dai.gotou <dai.gotou@...>

[#44745] [ANN] Rails勉強会@東京 第28回のお知らせ — "MOROHASHI Kyosuke" <moronatural@...>

[#44748] Re: テキストファイルの文字列検索 — Kabu and Ruby管理人 <kabu_and_ruby@...>

[#44754] ruby-listをRSSで読めるようにしました — 前田 剛 <nil@...>

[#44762] RubyインストールガイドをThe RWikiに移動しました — Kazuhiro NISHIYAMA <zn@...>

[#44767] [ANN]Miyako1.5先行公開版とMiyakoマスコット — cyross@...

[#44769] Ann: Ruby-1.9.0-1 Windowsインストーラパッケージ — arton <artonx@...>

[#44771] Cookie::parse() の仕様について — "Makoto Kuwata" <kwa@...>

[#44773] PHPとの関数対照表 — "tadashi nagao" <tadashi.nagao@...>

[#44780] cgi.rb : Mac でも NEEDS_BINMODE が true に — "S_Konno(今野 滋)" <sk@...>

[#44781] complex.rb — "5.5" <5.5@...>

[#44782] $stdin.rewind が exec した子プロセスに伝わらない? — SATOH Fumiyasu <fumiyas@...>

[#44793] モデル理論アプローチ — "tadashi nagao" <tadashi.nagao@...>

[#44794] [ANN] isi-1.1.5 released — NISHIMATSU Takeshi <t_nissie@...>

[#44795] [ANN] RHG strikes back 第3回 — Yugui <yugui@...>

[#44796] Rubyを使ってSuicaの乗車履歴を取得し、GoogleMapsなどで表示 — akio0911@...

[#44799] [ANN]Miyako1.5pre5公開しました+Wiki公開しました — cyross@...

[#44800] [ANN] update Ruby/Tk for Ruby(1.9|1.8) and Tcl/Tk8.5 — Hidetoshi NAGAI <nagai@...>

[#44801] CentOS5 インストール時のはまり報告 — "ARAI Shunichi" <arai@...>

[#44804] [ANN]るびま23号リリース — "Masaya Konishi" <mkonishi1981@...>

[ruby-list:44711] Re: RDoc,RDフォーマットの公式文書はどこにあるのでしょうか

Thread

In This Thread

[#44709] Rails勉強会@東北第8回のお知らせ — 片平裕市 <yuichi_katahira@...>

[#44710] Rails勉強会@東北第9回のお知らせ(再送) — 片平裕市 <yuichi_katahira@...>

[#44712] Mysql not loaded — 遠藤　明 <endo4917@...>

[#44745] [ANN] Rails勉強会@東京第28回のお知らせ — "MOROHASHI Kyosuke" <moronatural@...>

[#44754] ruby-listをRSSで読めるようにしました — 前田剛 <nil@...>

[#44780] cgi.rb : Mac でも NEEDS_BINMODE が true に — "S_Konno(今野滋)" <sk@...>