青木です。

  In mail "[ruby-reference-manual:66] Re: 作業マニュアル #1 (フォーマット変換)"
  Kazuhiro NISHIYAMA <zn@m...> wrote:

> 西山和広です。

> >   * object      オブジェクト (ほぼ ARGF と ENV 専用)
> 
> 他にはSCRIPT_LINES__とか?

SCRIPT_LINES__ には特異メソッドはないので関係ありません。


> > レベル 2 ヘッダ (「==」) には以下の種類があります。
> > 
> >   * Singleton Methods
> >   * Private Singleton Methods
> >   * Instance Methods
> >   * Private Instance Methods
> >   * Module Functions
> >   * Constants
> >   * Special Variables
> 
> Structはどうなりますか?

困ってるところです。


> RD方式だと別々のVerbatimにしたいと思ったら
> 間にVerbatim以外を挟むかインデントを下げて
> いかないといけないという問題があります。

そういうドキュメントは書くべきではないので、問題だとは思いません。
また、どうしても連続して書きたければ //emlist を使えば回避でき
ます。


> > === 箇条書き
> > 
> > 箇条書きはインデント + '*' です。インデントなしは不可。
> 
> これは単純に技術的な興味からの質問なのですが、
> インデント必須なのはどういう利点があるのでしょうか?
> tracで使われているwikiの記法(たぶんMoinMoin記法)でも
> インデント必須なので、何か利点があるのだと思うのですが。

冒頭に「*args」と書いても箇条書きにならないで済むのは利点かと。

もっとも、「*args」はインデントしてもリストにならないという
別の問題があるのですが、そういうときはやっぱり //emlist が
使えるので問題ありません。

# さらに細かいことを言えば
# 「* args」でないと箇条書きにはならなかったりする……


> > === ハイパーリンク
> 
> >   * [[url:http://i.loveruby.net]]  URL http://i.loveruby.net にリンク
> 
> これは任意のURLにリンクできてもあんまりうれしくない、
> RDでURL:を付け忘れると言うのを結構見たことがあった、
> という点から、http,https,ftpぐらいを特別扱いして
> リンクにするというので良いのではないかと思います。
> (telnetとかgopherとかのリンクがはれてもうれしくなさそう)

嬉しくないなら記述を長くしておいたほうがよいと思うので、
現状でよいでしょう。

--
青木峰郎

--
ML: ruby-reference-manual@m...
使い方: http://QuickML.com/