Comments in @example in org.texi

Comments in @example in org.texi

[Rasmus]

Hi,

In org.texi, sometimes examples have comments with (·) and sometimes with
@r{·}.  E.g.

   @example
   #+TOC: headlines 1 local  (insert local TOC, with direct children only)
   @end example

And

   @example
   #+INCLUDE: "~/.emacs" :lines "5-10"   @r{Include lines 5 to 10, 10 excluded}
   @end example

Is there any logic behind when @r{·} and when (·) is used?  Or should we
try to make it more coherent?

Thanks,
Rasmus

-- 
This is the kind of tedious nonsense up with which I will not put

Re: Comments in @example in org.texi

[Nicolas Goaziou]

Hello,

Rasmus <rasmus@gmx.us> writes:

> In org.texi, sometimes examples have comments with (·) and sometimes with
> @r{·}.  E.g.
>
>    @example
>    #+TOC: headlines 1 local  (insert local TOC, with direct children only)
>    @end example
>
> And
>
>    @example
>    #+INCLUDE: "~/.emacs" :lines "5-10"   @r{Include lines 5 to 10, 10 excluded}
>    @end example
>
> Is there any logic behind when @r{·} and when (·) is used?

I don't think so.

> Or should we try to make it more coherent?

IMO @r{.} should be used everywhere in these situations.


Regards,

-- 
Nicolas Goaziou

Re: Comments in @example in org.texi

[Rasmus]

Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:

>> Or should we try to make it more coherent?
>
> IMO @r{.} should be used everywhere in these situations.

I pushed a commit that removs the ()-comments I could find.

—Rasmus

-- 
m-mm-mmm-mmmm bacon!

Re: Comments in @example in org.texi

[Nicolas Goaziou]

Rasmus <rasmus@gmx.us> writes:

> I pushed a commit that removs the ()-comments I could find.

Thank you.

Regards,