ruby-list

Toshです。

# バグ修正版の"rdtool-0.5.7"をRAAに登録しました。
# 仕様がまだかたまっていないので、MethodListは先送りですが。

In message "[ruby-list:20044] Re: RD with method index (again)"
    on 00/01/04, Koji Arai <JCA02266@nifty.ne.jp> writes:
>> >うーん、どうしましょうね。一致判定ではインラインをとっぱらて
>> >もいいかなぁ。
>> 
>> そうそう、単純にインラインはとっぱらうとした場合に、空白文字は
>> どうするか、とかも悩んでました。"ほげ((({HOGE})))"(HOGEはカッコで
>> 括ってある事に注意)を読みやすい用に"ほげ( (({HOGE})) )とかつい
>> やりたくなるので、この場合は((<ほげ( HOGE )>))って書かないとだめ
>> なのか、とかです。
>
>一致判定では、空白もとっぱらう。
>
>行詰め(EmacsでM-q)したときにインラインが改行で別れることがた
>まにあります。

これは((<...>))は一語ってEmacsに教えてやれば大丈夫じゃないですか？
できないかな？

>=begin
>=foo bar
>((<foo
>bar>))
>=end
>
>この場合の扱いもキチッと決めたいな。
>
>((<foo
>bar>))
>
>は、
>
>((<foo bar>))
>
>と空白を間に挟んだ出力をするのが妥当でしょうね。
>
>で、その場合
>
>((<ほげ
>ほげ>))
>
>が、((<ほげ ほげ>))になるけど、その場合にも"= ほげほげ"は参
>照して欲しい・・・かな。

結構微妙なんですよね。なにがいいのか今の時点ではなんとも言えない
って感じで。難しいです。

>> >そういえば、ちょっと別の話ですが ruby-man.rd のとき、メソッ
>> >ドへの参照((<method>)) を((<(({method}))>))として扱いたいな
>> >と思いました。
>> 
>> 今でもネストの仕方が逆ならできます。(({((<method>))}))ならちゃんと
>> 通ると思いますよ。
>
>あぁ、これはRDtoolが自動でそう扱ってくれると良いかなというモ
>ノでした(この手の書く手間を省くためだけの要望は頭の隅にでも
>保管してもらえれば幸いです)。

わかりました。

でもこれはリファレンスとラベルの一致条件の問題をきちんと決めれば自ずと
導かれる事なので先送りでしょうね。

>> >1つの.rd は1つの.htmlじゃだめなんですか？
>> 
>> いや、「あれば便利かも」って程度のものです。それにTexinfoへの出力は
>> 複数ページHTMLへの出力をベースにした方が楽かと思います。
>
>大きめのマニュアルで、複数のRDや複数のHTMLのことを考えた場合、
>
>(1) 1つの.rdを複数のHTMLに自動で分割
>(2) 1つの.rdを1つのHTMLに対応させて出力する
>(3) 複数の.rdを1つのHTMLとして出力する
>
>が考えられますが、
>
>(1)は、今のところ特に必要とは思ってません(Texinfoのことは考
>えてないけど)。
>
>(2),(3)は、どっちか(または両方)が欲しいです。これは、前にも
>書いたように、RDtoolのの出力に要する時間を短縮したいという希
>望から来てます(なので、RDtoolが速ければ(1)の対応だけを考えて
>も良いと思います)。

僕はそもそもあらいさんがやりたいことは、「rubytk.rdやruby-man.rd
のような大きなサイズのドキュメントを書く場合に、修正する度に変換して
確認では時間がかかりすぎる。だから分割コンパイル(?)が必要。」って
考えだと思っていたのですが、あっていますか？

もしそれならば、
  * ドキュメントを複数の部分にわけて、それぞれを個別ファイルのRDに。
      array.rd, hash.rd, string.rd,...
  * 修正してテスト、のプロセスはそれらのファイル毎に。
  * まとめるための"ruby-man.rd"を用意してそこで個別のファイルをInclude
      % cat ruby-man.rd
        == Classes
        ...
        <<< array.rd
        <<< hash.rd
        <<< ...
        <<< string.rd
とかで、うまくできると思うのですが、これではだめなのですか？

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:20050] 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@...>