Re: [O] Comments in @example in org.texi

[Nicolas Goaziou]

Hello,

Rasmus <address@hidden> 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