[ruby-talk:00707] Re: Summary of discussion about RD (Re: Docum enta tion about RD?)

On 19 Aug, Toshiro Kuwabara wrote:
> Hi,
> 

[...]

>> Furthermore I think that references like (2) are other beasts as used
>> in (1) and (2).
>> 
>> Opinions?
> 
> Well... I suppose "((<...>))" has too much feature in gotoken's idea.
> It is good idea that we use different brace for reference to Element of Doc
> and resource of Internet. 
> And do we need reference to bibliography?? I don't think so...

Perhaps we wouldn岐 need it. But I have no special wishes here. :-)

[...]

> Oh....
> I assumed that your proposal include to require ANY formatter of RD to
> have a feature like "-use" and "-notuse" of [ruby-talk:687]. But it is
> my misunderstanding. I understand that we use "=begin <something>" for
> multiline comment and proper extension of RD formatters in your porposal.
> I suppose it is nice.:-)
> 

Do that mean, you like it? :-)

[...]

>> 
>> What `rd2xxx' doesn't know, should be ignored. So we are free for
>> extension not coming from the `rdtool' direction.
>> 
>> Opinions?
> 
> Sorry, my explanation wasn't enough.
> In Goto's proposal, we should write "<something>" not only after "=begin"
> but also after "=end" to make sure and to show that text between 
> "=begin <something>" and "=end <something>" is NOT RD.
> This is proposal not for semantics but for grammar.

I don't think, we should have to use that `=end <something>' construct.
`=begin <something>' should be enough, IMHO. If `=begin <something>'
would be enough, anybody could write `=end <something>' if he like it.
Because the whole `=end' line should ignored in any case!

I would find it very... hmm... strange, if the following would be
translated by rdtool...

=begin ignoreit
This section should be ignored because the =begin and =end line will
have the same text behind it?
=end ignorit

See the mispelling for `ignor(e)it'? So I think, my proposal would be
simpler and easier to handle. :-)

Hmm! To clean-up my proposal, I wish to sum it up, ok?

Please consider the following excerpt:

=begin
This is a section that should be considered by ((rdtool)).
=end

=begin blarb
whereas that would one, that should be ignored; doesn't matter how the
last line ends.
=end

=begin ァ$)(/$)/
This section should also be ignored!
=end lkrelrjlwelrtkltn

=begin .
Like that last section too (Have you seen the dot after the =begin? ;-)
=end .

Any understandings removed? ;-)))

> 
> ---
> Tosh

\cle