From: "NAKAMURA, Hiroshi" <nakahiro@...>
Date: 2000-10-05T17:55:35+09:00
Subject: [ruby-list:25319] Re: =begin, =end

なひです．

> From: rubikitch
> Sent: Thursday, October 05, 2000 4:18 PM

元記事から補足>
> > もし「現在も今後もドキュメントのためである」ということであれば，
元記事から補足<

> > > いっそ、ruby (インタプリタ) で埋め込みドキュメントだけ出力するって
> > > いうのは変でしょうか ?
> > 
> > これに賛成です．
> 同じく賛成。

なひの賛成は条件付きです．それでも「同じく」と言ってもらったと
思っていいですか？

	/	/	/

> > 提案1. RDの先頭の=beginと末尾の=endはなくてもよいことにする．
> > 提案2. =begin header〜=end headerみたいな拡張も避けて，別の文法を
> >   導入する．例えば=RDbegin〜=RDend．これならRuby本体が混乱しない．
> 提案1の方を考えているらしい。

なひの提案は二者択一でなくて両方です．

> =beginと=endを省略したときは、自動的にファイルの先頭と末尾にそれらがついてるもの
> とみなすのがごく自然なのでしょう。

=beginと=endはRubyの構文なので，
「なかったらついてるとみなす」のではなく，
「本来あるべきでない」とすべき，というのがなひの主旨です．

# 例えば
#   =begin
#   =begin
#   =セクション1
#   =end
# というRubyスクリプトから，
#   =begin
#   =セクション1
# というドキュメントを抜き出してRDtoolでhtmlにしたら，
# =beginを特別扱いせず，h1が2個できるべき，ということ．

で，RD用の構文（メタ情報の埋め込みなど）は，=beginと=endではなく，
違ったものにしませんか？
=begin〜=endの中にあり，すなわちRubyに「これはドキュメントだ」と
認定された文書の中には，別に何が入っていても構いません．
RDでもRTでもHTMLでもなんでも．
ただ，それら（今回は特にRD）が=begin〜=endという文字列を含むのは，
混乱を招くのでやめましょう，ということです．

=RDbegin〜=RDendが変なら（変だけど），
<RD>〜</RD>でもいいです（これも変だなぁ）．