ruby-list

Toshです。

In message "[ruby-list:20017] Re: RD with method index (again)"
    on 00/01/03, Koji Arai <JCA02266@nifty.ne.jp> writes:
>((<ほげHOGE>))をそういう見出しが存在すれば((<ほげ(({HOGE}))>))
>とみなしてくれるのはうれしいかもしれないですが必要って程でも
>ないと思います。
>
># ちゃんとソースを見てないんですが、そもそも((<ほげ(({HOGE}))>))
># が許されない今の制限はどういう理由なんでしょう？

理由は、「僕がどういう仕様にしていいか判断がつかなかったので、ほったら
かしになっている」です。(^^;;

ラベルが
  == ほげHOGE
でリファレンスが
  ((<ほげ(({HOGE}))>))
だったら、上のラベルへの参照とみなしていいのか、とか。逆に
  == ほげ(({HOGE}))
に対して
  ((<ほげHOGE>))
だったら、どうか？とか。

identityの一致と言うものをどのように考えるのかが決まらなかったので
とりあえず保留にしておいて、一番単純なモノだけを実装してあります。

ここらへんのことを議論にフィードバックしなかったのはさぼってたからです。

>> トップレベルの定数は"main::Const"では？
>
>定数はクラスやモジュールで定義されるモノだからmainってことは
>ないと思います。
>
>HOGE = "hoge"
>puts Object.constants
>=> PLATFORM
>   ENV
>   ...
>   HOGE
>   ..

あ、勘違いしていました。すみません。

>> >> リファレンスマニュアルみたいな用途を想定されていると思いますが、
>> >> それ考えると"Class"をいちいち書くのが多少めんどくさいかもしれません。
>> >
>> >うーん、クラスの宣言も可ってのはどうです？
>私が口走った「クラスの宣言」っていうのはとりあえず置いといて・・・
>
>この辺りの便宜についてはもう少し様子見でもいいかと思います。
>"--- Class#method" の慣習はあくまでも慣習なので従いたくなけ
>ればクラス名省略しても(RDとしては)問題ないわけですし。

了解です。

>perldoc ならぬ rubydoc とかを考えたときこの程度のツールでは
>クラス名は特に必要ないですね。
>一方、大きめのリファレンスマニュアルのためには必要でして、どっ
>ちにでも対応できるのは利点と言えます。
>
>ただし、両者をマージしようとしたとき(小さいRDをあつめて1つの
>RDドキュメントとして何かをしたいとき)にクラス名を書いてない
>RDの存在が問題になるかも知れないですけど、それはそのときに考
>えたい気もする(あまり先を考えすぎて実装が遅れるのもちょっと
>嫌ですし)。

同意します。まだ暗中模索って感じですしね。

>作りました。えっとどうしようかな。in.comingに
>  ruby-man.rd.gz
>を置かせてもらいましたが、docにでも移動してください＞まつも
>とさん(ドキュメントのRAAってあり？)

見てみました。
今の段階でもこれだけのサイズのドキュメントにもなんとか対応できる
感じですね。すばらしい。

# クラス階層は自動生成できればうれしいかも。

>お試しで MethodList を実装してみたのでRDへのパッチをこのメー
>ルの最後につけます。

こっちはまだちゃんと見ていないのでまた後で。

>ruby-man.rdの中身ですが、texinfoからrdへの変換を行ったので多
>少構成が変わってます。
>
>あと、
>
>  "chapter"		=> "=",
>  "section"		=> "==",
>  "subsection"		=> "===",
>  "subsubsection"	=> "====",
>  "appendix"		=> "=",
>  "appendixsec"		=> "==",
>  "appendixsubsec"	=> "===",
>  "appendixsubsubsec"	=> "====",
>  "chapheading"		=> "+",
>  "majorheading"	=> "+",
>  "heading"		=> "++",
>  "subheading"		=> "+++",
>  "subsubheading"	=> "++++",
>
>のような変換を行いました。見出しのレベルの意味が違ったり存在
>しないレベルがあります。

見出しレベルは6つだと足りないでしょうか？

># 「スーパークラス」とかの項を@nodeにしてもしょうがない。
># これはどうしようかなぁ(rd2texi)。

HTMLで複数ページ出力するようになると、
  {HTMLのページ} <--> {Texinfoの@node}
の対応ですよね？

HTMLの複数ページ出力では、今のところ考えているのは
  * ユーザーの指定したレベルのHeadlineより上でページ分割。
    
    たとえば、"2"とかだと、"=", "=="の部分でページ分割。
    (ちょっと説明しづらい。Texinfoだと"="を"@chapter"とかに翻訳する
    ときに、その前に"@node"を置く事に、って感じでしょうか。)

  * "=begin"..."=end"で囲まれてるところをページ(ノード)の単位に。
    個人的には"=begin" ... "=end"にあまり意味を与えたくないものの、
    これだと結構柔軟に対応できそうなので、便利です。

>・オプションや用語集で、DESCLISTが使えなかったというのがありま
>  した。
>
>  :: label STRINGLINE
>
>  なんてのがあるといいのかなと漠然と考えてます。

これは、普通のDescListはなぜ使えなかったのでしょうか？

>・以下のようなのがありましたが、
>
>  --- Array.[](index ...)
>
>  ちょっとわかりにくい？
>
>  -> Array.[index ...]
>  という出力が得られますが
>
>  -> Array[index ...]
>  とした方が良かったですね。

>・以下のようなのもありました
>
>  --- ENV.delete(key)
>
>  "." は、「クラスメソッド」ということになってましたが、
>  "ENV"はクラスでもモジュールでもなかった(rd2texiとか作ると
>  「クラスメソッド」とかの分類になるなぁ。とりあえず気にしな
>  いでおこう)

ENVのようなのはかなり特殊なのでしょうがないでしょう。

>・センタリングがない
>
>  別に必要だとは思ってないです。

これからもたぶん無いと思います。

>・((<substitute|label>))
>
>  これ必要ですね。

必要なのですが、リファレンスは今後変更が大きそうなので、ちょっと落ち着
くまで実装はサボってます。

>> ただ、rubytk.rdを見ても思いましたが、やっぱり一番必要なのは複数ページの
>> HTMLに分割して出力する機能ですね。(^^;;
>
>あっこれ重要です。大きめのRDは変換に時間がかかるので小さいRD
>を個別に変換できるとよいのですが。(中間ファイルが必要になる
>けど私はそれでも構わない)

個別変換ですか。Marshal使ってTreeを出力してしまうとか。
考えておきます。

ただ、0.5.5にはIncludeもあるので、RDファイル自体の分割はできます。
<<< ruby-man-array.rd
とかすると、Texinfoの@inputと同じようにそこにRDファイルの内容が
そのまま書かれているのと同じように振舞います。
「個別に変換」とはちょっと違いますが、それなりに役に立つはずです。

>別件ですが、1つ気になってるのは
>
>  * ITEM
>
>    DESCRIPTION...
>
>でITEMの後にWHITELINEを要求されるのですがこれは本来必要ない
>ですよね？(DESCLISTは逆にWHITELINEを許さない)

問題をちょっと把握できてないので、的外れな事を書くかも知れません。

  : ITEM
    DESCRIPTION...

の場合、DecsListの一行目は特別扱いなのでItemListとは違います。
ITEMの部分はDescListのTermになって、2行目以降に継続する方法はありません。
ItemListの場合は一行目から普通のリスト内ブロックなので
  * ITEM
    DESCRIPTION...
と書くと、"ITEM"と"DESCRIPTION..."は同じTextBlockとみなされるはずです。
違うTextBlockにしたい時は間にWHITELINEが必要です。
あらいさんの問題ってこういうことでしょうか？

後半部分ですが、DescListの場合も
  :ITEM
   
   DESCLIST

は許されるようになってると思います。手元の簡単なテストではこれを通しま
した。ただ、リストにはルールの衝突が残っているので、大規模なドキュメント
になるとRaccが先読みしきれずにエラーがでるかもしれません。
もしそうでしたら、それはバグです。
# この衝突はなんとかしたいのですが、いまだに直し方がわからない。

---
Tosh
Toshiro Kuwabara

Thread

Prev Next

In This Thread

Prev Next

[#19998] benchmark.rb — gotoken@... (GOTO Kentaro)

[#20003] REQ: String#gsub — Tomoyuki Kosimizu <greentea@...2.so-net.ne.jp>

[#20018] ruby-1.4.3.tar.gz の日付 — Tadashige Morii <m_tada@...>

[#20028] xmltree — "Masatoshi SEKI" <m_seki@...>

[#20035] DocBook 4.0: ClassSynopsis — Yasushi Shoji <yashi@...>

[#20041] Re: xmltree — "Masatoshi SEKI" <m_seki@...>

[#20046] 1/0 — "Shigeo Kobayashi" <shigeo@...>

[#20053] == === case — "Shigeo Kobayashi" <shigeo@...>

[#20057] mirror.rb in Ruby Book — Takashi SATO <turmite@...>

[#20059] 改行がリダイレクトされない ruby1.4.3cygwin? — 中村暁史 Nakamura Akifumi <BXQ04723@...>

[#20077] Range expansion? — Akinori MUSHA aka knu <knu@...>

[#20083] non-block IO with TCPSocket — dn <daisuke@...>

[#20087] Re: a instance of Struct subclass on the block parameter (Re: Range expansion?) — Kazuhiro Yoshida <moriq.kazuhiro@...>

[#20097] Re: [REQ] ruby-math (Re: coerce) — Toyofuku <toyofuku@...>

[#20118] media watch 2000.01.08 — Noritsugu Nakamura <nnakamur@...>

[#20120] タブの出力について — 鮎川夏生 <natuki@...>

[#20123] TMail and Racc and RDtool — Masaki Suketa<CQN02273@...>

[#20131] String to Time — Yukihiko Eda <yuki-e@...>

[#20133] おききしたーいでーす — akimaru <akimaru@...>

[#20145] BUG? Parse Error and and — Tomoyuki Kosimizu <greentea@...2.so-net.ne.jp>

[#20150] Ruby BUG ?? — Sakae Kobayashi <sakae@...>

[#20162] proxy ftp — "Kikutani, Makoto" <kikutani@...>

[#20174] Ruby-book erratum — "K.Kodama" <kdm@...>

[#20175] class Polynomial — "K.Kodama" <kdm@...>

[#20176] Re: Complex#divmod — Masato KIYAMA <masato@...>

[#20178] [Gtk 0.22] Gtk::DrawingArea cannot pack in Gtk::VBox — h-isikaw@...

[#20184] [book] 付録 A — Kazuhiro Nishiyama <nishiyama@...1.tiki.ne.jp>

[#20185] [book] 8,9,10 章 — Kazuhiro Nishiyama <nishiyama@...1.tiki.ne.jp>

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

[#20187] Hash#index, Hash#indexes — Kazuhiro Nishiyama <nishiyama@...1.tiki.ne.jp>

[#20188] slashdot - The 2000 Beanies — Yasushi Shoji <yashi@...>

[#20191] thread について — Yasushi Abe (阿部靖司) <yasushi@...>

[#20192] timeout.rb の Thread.abort_on_exception = true — Matsuo Hisanori <hisanori@...>

[#20203] Gtk::ItemFactory の代替品を作ってみました — dellin <ogu@...>

[#20210] Ruby 強調表示定義ファイル for 秀丸 — Ayanosuke <aya@...>

[#20211] %Ruby — Shugo Maeda <shugo@...>

[#20215] racc debianized — akira yamada / やまだあきら <akira@...>

[#20219] catching exceptions in rb_eval_string() — OZAWA Sakuro <crouton@...>

[#20221] while TRUE と loop の違いを教えてください — Sakae Kobayashi <sakae@...>

[#20235] simple-chat-server.rb don't work on lynx — M_HANA <M_HANA@...0.sapporo-soft.ac.jp>

[#20237] Ruby/Tk multi interpreter — nagai@...

[#20240] eRuby banner — OZAWA Sakuro <crouton@...>

[#20243] (rd2) nl in Japanese chars — gotoken@... (GOTO Kentaro)

[#20246] Q: Singleton Class and Singleton Method — Tomoyuki Kosimizu <greentea@...2.so-net.ne.jp>

[#20249] FTP.open err for Windows95 — "Y Kataoka" <kataoka@...>

[#20274] RAA script — akira yamada / やまだあきら <akira@...>

[#20279] [ 雑談 ] メーリングリスト抜けますです〜 — Atsuko Yoshida <atsuko@...>

[#20284] ruby と論文と知名度 — Noritsugu Nakamura <nnakamur@...>

[#20300] net/http.rb — TAKAHASHI Masayoshi <maki@...>

[#20301] notify_observers in observer.rb — Matsuo Hisanori <hisanori@...>

[#20310] ワイルドカード有りのファイルの存在を調べたいのですが — 関口久之 <sekiguci@...>

[#20318] gtk: how to copy clist item into clipboard. — OZAWA Sakuro <crouton@...>

[#20320] TMail is too strict? — Shugo Maeda <shugo@...>

[#20337] — Norihito Shinzan <kabbalah@...>

[#20339] Telnet (login failed) — Kentaro Inagaki / 稲垣 健太郎 <inagaki@...>

[#20341] ftp.ruby-lang.org ([book][CD-ROM]README.txt) — SUGIHARA Hiroshi <maili31s@...>

[#20342] How to build ruby(current) with cygwin — KORIYAMA Naohiro <kory@...2.so-net.ne.jp>

[#20344] E-mail アドレスの確認・ DNS の MX など — ogino@...

[#20348] Ruby/LAPACK working group — gotoken@... (GOTO Kentaro)

[#20349] パスワードの crypt とチェック — Ayanosuke <aya@...>

[#20350] [PATCH] Ruby/Tk — Koji Arai <JCA02266@...>

[#20355] personal web server(win98) で ruby の cgi を実行したい — Hiroshi Saito <HiroshiSaito@...>

[#20363] media watch 2000.01.24 — Noritsugu Nakamura <nnakamur@...>

[#20369] divmod() — Yasushi Abe <yasushi@...>

[#20385] Re: class Polynomial — Toyofuku <toyofuku@...>

[#20393] eRuby で掲示板作ってみました — Noriyuki Okamoto <okamoto@...>

[#20394] ruby-1.4.3 port to HPUX 11.00 — matz@... (Yukihiro Matsumoto)

[#20400] Ruby win Icon — たむら けんいち<ken-ichi.tamura@...>

[#20409] Ruby/Gtk のバージョンを取得したい — dellin <ogu@...>

[#20413] File::open() マニュアル — とみたまさひろ <tommy@...>

[#20414] 3 桁毎にカンマを入れる — 堀川 久 <vzw00011@...>

[#20433] クラスメソッド呼び出しの parse error — Yoshiki Wada <wada@...>

[#20438] cygwin 版 Ruby での BLT 利用について — otokita@...

[#20445] Anquete for Object Day 2000 — Tomoyuki Kosimizu <greentea@...2.so-net.ne.jp>

[ruby-list:20022] Re: RD with method index (again)

Thread

In This Thread

[#20339] Telnet (login failed) — Kentaro Inagaki / 稲垣健太郎 <inagaki@...>

[#20400] Ruby win Icon — たむら　けんいち<ken-ichi.tamura@...>

[#20414] 3 桁毎にカンマを入れる — 堀川　久 <vzw00011@...>