ruby-list

Toshです。

> > あ、いや。これはこの後に書いたメソッドをHeadlineでならべちゃえば、
> > 目次作るくらいの事はできるけどね、ってやつです。それで不十分なら
> > もちょっと解決策を考えなきゃなりませんね。
> 
> 考えましょう (^^

とりあえず、やってみました。
RDtoolのバージョンアップも併せて rdtool-0.5.2.tar.gz の名前でin.coming
に置きました。  よろしくお願いします。＞まともとさん
# RDtool自体の変更は(Ruby本の影響で)Enumerable includeしたり、moduleで
# 名前空間分けてみたり、です。

rd/rd2html-mindex.rbなるライブラリがRDからメソッドの名前を捜し出して、
メソッドの索引付きHTMLを出力するためのものです。
具体的にはHeadlineのtitleとDescListのtermに「#」や「::」がある場合に
それぞれインスタンスメソッド、クラスメソッドか定数、とみなして、索引
のエントリにしています。
rd/rdvisitor.rbのRDは実際にこの形式で書かれたRDになってますので、
実際に試してどんな感じだか判ると思います。
make install してもrd/rd2html-mindex.rbはインストールされないので手で
インストールしてください。

てなわけで、こんな感じだとどうでしょ？＞あらいさん
これだと、周りへの影響はほとんど無しで機能を実現できるのですが、まだ
不十分ですか？
# あ、適当にでっちあげたのでコードは汚いですが御勘弁を。

> > そういうのは別に構わないし、あれば便利な物はあったほうがいいかと
> > 思います。
> > ただ、僕は保守的なのか割とRD自体の機能をどんどん追加していってそれ
> > を実現するのに消極的な(というか結構きっぱり反対してるかも(^^;;)だけで。
> > そういうわけで、これもRD自体のシンタックスに手をいれること
> > になるので、慎重な態度をとってしまうのですね。
> 
> 厳しいですね。でも、メンテナのこういう厳格な態度っ
> てのはどうやら必要不可欠なもののようです。

いや、僕はRD自体のメンテナってわけじゃないんですが、いいだしっぺ
なので割と深く関わってる、って感じでしょうか。
厳しい(と言うかうるさい)のは性格でしょう。(^^;;

> ポリシーがあるからこそ、良いものが出来る。説得する
> ならそれなりの材料を持ってこいってところでしょうか。
> (説得下手には辛いところ)

RDのポリシーは「人間が読みやすいものを」かと思ってます。
プログラムのドキュメントはメンテナンスが重要なので、人間が見て
一目で構造が把握できるようなものでないとメンテがむずかしくなる、
ってのが前提かと。
これは僕の勝手な考えで他の人がどう思ってるのかは知りませんが。

> > RD自体のドキュメントも書かなきゃならんような気もしてますが、
> > さぼってます、すみません。
> 
> がんばってくださいね。RDの例にもなりますし。

RDの例ですが、RDtoolに含まれる *.rb ファイルにはほとんどRDが含まれて
います。rd2texiのテストの時には使ってみてください。

> > RD自体がとりあえずHTMLとLaTeXあたりを参考に最低限のものだけを
> > 詰め込んだ、って感じなので、本当に情報が足りてない可能性はあり
> > ますね。僕はtexiわからないので、どこらへんが足らないのかよく
> > わからないんですが。
> 
> メソッド索引！(ひつこいって ^^)。西本さんの
> ruby-info.elは本当に便利ですよ。Emacs上で
> emacs-lispを書いてるときに簡単に関数や変数のヘルプ
> が見れますが、あんな感じ(そのもの)です。Emacs で
> ruby書いてる人は使わなきゃ損だと思う。

メソッド索引ちょっと本格的に考えてみましょう。
あれば便利そうですし。
要はメソッド索引が簡単にできればいいわけですから、RDの仕様に
盛り込む事まで考えなくても、メソッド索引付きのRDの作成を支援
するツールとか、rd/rd2html-mindex.rbの様な方向で進めても、目的
は果たせそうですね。

最後に余談。
RDtoolのバージョンアップのせいでrd2texi-lib.rbはそのまんまだと動かなく
なっちゃってます。すみません。＞あらいさん
具体的には
* Class定義をまるごとmodule RD ... endで囲ってしまうようにしてください。
* rd2html-lib.rbでラベルの前処理をしていた部分はRDVisitor#prepare_labels
  にお引っ越ししました。ただこれは(明示的に呼ばないと何もしませんので)
  ほっといても動くと思います。
* RDElementにEnumerableがincludeされた為にArray#+などの暗黙にto_aを使って
  型変換をする可能性のあるメソッドを使ってると思わぬバグを引き起こすかも。
あたりを修正してみてください。

それでは。
# なんかみょ〜に忙しいので、全体的に反応が遅れてます。すみません。

---
Tosh
Toshiro Kuwabara

Thread

Prev Next

In This Thread

Prev Next

[#18226] Ruby 本ってば、うれしいなー — Atsuko Yoshida <atsuko@...>

[#18229] [book-bug]p.270,273,305 — "ISIHARA HIROSI" <ishihara-h@...>

[#18233] [book] blade.nagaokaut.ac.jp/ruby/ruby-list/ — Shin-ichiro Hara <sinara@...>

[#18235] [book-bug] p.261 — YOKOYAMA Takehiro <tac@...>

[#18236] Ruby AP 展示会出展 — Yoshida Masato <yoshidam@...>

[#18242] Re: i++ に見る性格の差 — toyofuku@...

[#18247] [book bug] 82, 186 — KIMURA Koichi <kbk@...>

[#18252] http-access.rb で state != :META — SETSURA <setsura@...>

[#18265] アクセス制御について — Tadashige Morii <m_tada@...>

[#18279] [book bug] p.557 — kenn@...

[#18293] [book] 新宿紀伊國屋売り上げ情報 — Noritsugu Nakamura <nnakamur@...>

[#18303] Float#step が欲しい・・・ — 伊藤 友裕 <j6398015@...>

[#18307] Re: <=> — Toyofuku <toyofuku@...>

[#18308] DRb|drb|druby + iterator — Masatoshi SEKI <m_seki@...>

[#18310] Re: 変数、代入 — "Takehiko Ueki" <takehiko@...>

[#18327] [book][]= メソッド — Noritsugu Nakamura <nnakamur@...>

[#18332] rubyTk の Tk は何がお勧めですか？ — Sakae Kobayashi <sakae@...>

[#18338] オブジェクトの非同一性判定 — Ayanosuke <aya@...>

[#18341] [book] missing prec.c — Minero Aoki <aamine@...>

[#18345] jsort — Koretsugu Daigoro <tmmcross@...>

[#18347] Re: <=> — Toyofuku <toyofuku@...>

[#18348] Is there ext/GD for gd-1.7.x — "OGAWA, Hiroshi Santa" <santa@...>

[#18354] Re: <=> — Toyofuku <toyofuku@...>

[#18356] [book] gets — KANEKO Naoshi <wbs01621@...>

[#18361] Proc in a loop — ttate@...

[#18371] [book] IO/Enumerable — Tadayoshi Funaba <tadf@...>

[#18374] regular pattern — Katsuya Tanaka <tanaka@...>

[#18375] コマンドラインベースの電卓 — Kouichi Isobe <isobe@...>

[#18402] bug of regexp and book errata — Yoshiki Wada <wada@...>

[#18404] ruby-1.4.2 for NetBSD/alpha — SHIROYAMA Takayuki <psi@...>

[#18406] ruby 1.4.2 for NeXTSTEP — SHIROYAMA Takayuki <psi@...>

[#18408] [BUG] debug.rb(?) — Chikanaga Tomoyuki <hekitou@...>

[#18413] document writer — Kazuhiro Yoshida <moriq.kazuhiro@...>

[#18417] Re: document writer — Kazuhiro Yoshida <moriq.kazuhiro@...>

[#18420] bindrv on oracle — 中村暁史 Nakamura Akifumi <BXQ04723@...>

[#18422] ruby-1.4.2-2.{i386,src}.rpm — Naoki Kawakami <knao@...>

[#18425] joke (Re: [ruby-dev:8247] Re: 例外を処理する 2 項演算子) — gotoken@... (GOTO Kentaro)

[#18429] ビット演算について — Tadashige Morii <m_tada@...>

[#18432] [GTK] signal_connect_after — gotoken@... (GOTO Kentaro)

[#18442] Re: <=> — toyofuku@...

[#18443] ruby とベンチマーク — Noritsugu Nakamura <nnakamur@...>

[#18447] mswin32 でのファイル名の大 / 小文字 — "U.Nakamura" <usa@...>

[#18451] [book-bug]p89 http get — KANEKO Naoshi <wbs01621@...>

[#18467] Array doesn't include Comparable — kjana@... (YANAGAWA Kazuhisa)

[#18469] rbdoc-0.0.3 — Kazuhiro Yoshida <moriq.kazuhiro@...>

[#18471] SMF class — Tadayoshi Funaba <tadf@...>

[#18474] オープンソースまつり — matz@... (Yukihiro Matsumoto)

[#18475] Re: オープンソースまつり — KIMURA Koichi <kbk@...>

[#18476] paramclass — gotoken@... (GOTO Kentaro)

[#18477] [book] csv_split — Kazuhiro Nishiyama <nishiyama@...1.tiki.ne.jp>

[#18478] [book] p.255 — とみたまさひろ <tommy@...>

[#18479] ruby 1.4.2 can't compile ?? — ゆうたん☆ <yu-tan@...>

[#18480] ruby 1.4.2 can't compile ?? — ゆうたん☆ <yu-tan@...>

[#18485] Linux magazine 12/1999 — WATANABE Tetsuya <tetsu@...>

[#18490] [CFV] icompetition — gotoken@... (GOTO Kentaro)

[#18494] `make test' failure on Cygwin build w/ --enable-shared — Mimpei MORISHITA <mimpei@...>

[#18501] 関数 ` の動作 — Keisuke CHIBA <chiba@...>

[#18502] TMail bug report — Shugo Maeda <shugo@...>

[#18517] 自分の IP を獲得する方法 — Suguru Kakishita <kakky@...>

[#18521] Is there errata? — Mimpei MORISHITA <mimpei@...>

[#18526] アイコンコンテスト（ファイル用） — Hoshino Hitoshi <zin@...>

[#18529] [book] — Toyofuku <toyofuku@...>

[#18533] cover animal for Ruby book — Koretsugu Daigoro <tmmcross@...>

[#18536] How to upload file*s* — Toyofuku <toyofuku@...>

[#18539] [book] $*, etc. — Yasuhiro Fukuma <yasuf@...>

[#18541] Ruby/*PDF* — kinneko <ydate@...>

[#18542] clone of Gtk+ widget — Takayuki YAMAGUCHI <tyamaguchi@...>

[#18544] Readline.readline and signal trap — Chikanaga Tomoyuki <chikanaga@...>

[#18545] 変数の型チェック — "Hideaki Takata" <hideakit@...3.dion.ne.jp>

[#18555] EUC to JIS by Kconv — nosuzuki@... (Norio Suzuki)

[#18560] [book] p.190 — とみたまさひろ <tommy@...>

[#18570] RubyUnit — Masaki Suketa<CQN02273@...>

[#18576] Re: ruby-1.4.2 NeXT Port — SHIROYAMA Takayuki <psi@...>

[#18580] — tokoma@... (中川 誠)

[#18582] Regexp source — Kazuhiro Nishiyama <nishiyama@...1.tiki.ne.jp>

[#18583] Re: How to upload file*s* — Toyofuku <toyofuku@...>

[#18584] [REQ] [].grep(pat) #=> [] — gotoken@... (GOTO Kentaro)

[#18589] icompetition closed — gotoken@... (GOTO Kentaro)

[#18603] coding style — Shugo Maeda <shugo@...>

[#18608] swigruby-0.3 — Masaki Fukushima <fukusima@...>

[#18303] Float#step が欲しい・・・ — 伊藤　友裕 <j6398015@...>

[#18536] How to upload files — Toyofuku <toyofuku@...>

[#18541] Ruby/PDF — kinneko <ydate@...>

[#18580] — tokoma@... (中川誠)

[#18583] Re: How to upload files — Toyofuku <toyofuku@...>

[#18664] Re: ruby から SQL Server — たむら　けんいち<ken-ichi.tamura@...>

[#18807] protected なメソッドの再定義 — YAMASHITA Junji (山下純司) <ys_jyunji@...>