From: Toshiro Kuwabara <toshirok@...3.so-net.ne.jp>
Date: 2000-06-25T23:56:37+09:00
Subject: [ruby-list:23507] Re: rd2texi-lib.rb 最新版？

Toshです。

In message "[ruby-list:23503] Re: rd2texi-lib.rb 最新版？"
    on 00/06/25, Koji Arai <JCA02266@nifty.ne.jp> writes:
>> >というか、rdtoolの方を全然追えてません。
>> 
>> rd2texi-lib.rbが出た後にインターフェイスごと中身を大幅に変更した
>> 僕です。ごめんなさい〜。
>
>今日、作ってみたらそうでもなかったです。本当にサボってただけ
>なのでした。

一応、理由無く内部をいじっているわけでもないので、(古いバージョンの)
rb2texi-lib.rbでrb2html-lib.rbとコードが重複している部分をmoduleにし
た、とかではなかったかと思います。
rd2texi-lib.rbに変更を強いただけの利益があればよいのですが。

>> >RDで見出しのレベルを減らすなら、
>> >
>> >= 参照ありの見出し (@chapter, @section, ...)
>> >
>> >+ 参照なしの見出し (@chapheading, heading, ...)
>> >
>> >とかして頂けると texinfo にはうれしいかも。(ruby-man.rd は未
>> >だにこの形を想定してます)
>> 
>> これってなぜでしたっけ？
>> 全部参照ありの見出しだと良くない事がおきるのでしょうか？
>
>私もはっきり覚えてないのですが(おい)、例えば、Rubyのリファレ
>ンスマニュアルのTexinfo でいえば、
>
>  インクルードしているモジュール:
>  クラスメソッド:
>  メソッド:
>
>とかが、@section とかになる必要はないわけで、
>Texinfo版などでは、@subsubheading にしてます。
>
>でも、上記の例では良く考えれば、DescList 使えばいいだけの話
>でした。他の部分でも工夫次第で何とかなるかも知れません。早速、
>取り下げます。すみません。

む〜、そうですか。

RD版Rubyマニュアルはあれだけサイズのでかいものなので、現状のRDの
問題点とかも強調されやすいと思います。それに、RDドキュメントのひとつ
の典型になるものなので結構得る所大きいかとも思うのです。

ですから、新井さんの方でもしなにか気づいたらまた指摘してくださると
うれしいです。
たとえば、「メソッド:」とかをDescListにするとさらにその下にMethodList
が来るのでインデントが深くなりすぎるかも、とか。

>> NodeとかTexinfo特有(?)の概念の影響ですか？
>
>Texinfo特有の概念といえば、そうなのでしょうね。Texinfoには、
>印刷物を考慮した4種類の見出し(番号つき、番号なし、付録、目次
>に現れない見出し)がありますから。
># ただし、私使い方を間違えていたような気がしてきました。(- -;

なるほど。

---
Tosh
Toshiro Kuwabara