[ruby-talk:00953] Re: RDtool-0.5.0

Hi,
Sorry for my very late response.

In message "[ruby-talk:00918] Re: RDtool-0.5.0"
    on 99/11/10, YANAGAWA Kazuhisa <[e-mail]> writes:
>At first, I have to say what I've written on labels/references is
>implicitly supposing context-dependency, which is similar to scope
>rules and hierarchical namespaces seen in many programming languages.
>Sorry.

I see. But you didn't say that labels is like file system, right?
i.e. you don't want to indicate a label like "((<..::..::foo>))", OK?

>In message <[e-mail]>
>[e-mail] writes:
>
>> How can we distinguish in situation like following example?
>> 
>> = Foo
>> : Quux    <--- 1
>> 
>> == Quux   <--- 2
>> 
>> : Foo
>>    : Quux <--- 3
>> 
>> Which label is refered by ((<Foo::Quux>))??
>
>Well, 1 and 2 are not distinguishable even with my assumption.... Hmm,
>we can vary namespace separators for Chapter/Section headings and
>DescList's ones, say, ((<Foo/Quux>)) for 1 and ((<Foo::Quux>)) for 2.
>
># ((<Foo::Quux/Foo/Quux>)) for 3, if it is referred from out of Chapter
># Foo.
>
>However context-dependency is already too complex to `easy to write'
>document/program.  And the proposal above may lead us to more
>confusion.  Not so good :-<

I don't know whether your idea is good or bad, and I don't have
another good idea.
It works, at least, enough well, I think.

But "/" is already used for referencing to another file (See
[ruby-talk:00916]).  So, we have to choose one or two charactor to
use.

We must choose them carefully, because Reference have had already a
lot of meta-character. they must be enough simple for us to read,
to write and to learn.

Some character are already used, so we didn't use them, "/", "|".
And if a character is frequently used in Label, we shouldn't 
choose it. But if we need or want, it is available to be used as
meta-character. When Label include the character, we can 
double-quote Label like CSV. So, we can also use "::". For Example,
  ((<Reference::Constants::"Math::pi">))


FYI, POD seems not to have such method. When label conflict, only
1st one can be use, maybe.
But Ruby is OOL, so when you write reference with RD, Label confliction 
happens more frequently than POD, I think.

---
Tosh
Toshiro Kuwabara