From mboxrd@z Thu Jan  1 00:00:00 1970
From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Subject: Re: Comments in @example in org.texi
Date: Tue, 13 Jan 2015 15:32:01 +0100
Message-ID: <871tmykazi.fsf@nicolasgoaziou.fr>
References: <87ppaikhx5.fsf@gmx.us>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:59874)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1YB2Ur-0003yG-0L
	for emacs-orgmode@gnu.org; Tue, 13 Jan 2015 09:31:10 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1YB2Um-0007t7-Mk
	for emacs-orgmode@gnu.org; Tue, 13 Jan 2015 09:31:04 -0500
Received: from relay5-d.mail.gandi.net ([2001:4b98:c:538::197]:60127)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1YB2Um-0007sT-I1
	for emacs-orgmode@gnu.org; Tue, 13 Jan 2015 09:31:00 -0500
In-Reply-To: <87ppaikhx5.fsf@gmx.us> (rasmus@gmx.us's message of "Tue, 13 Jan
	2015 13:02:14 +0100")
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
To: Rasmus <rasmus@gmx.us>
Cc: emacs-orgmode@gnu.org

Hello,

Rasmus <rasmus@gmx.us> writes:

> In org.texi, sometimes examples have comments with (=C2=B7) and sometimes=
 with
> @r{=C2=B7}.  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 exc=
luded}
>    @end example
>
> Is there any logic behind when @r{=C2=B7} and when (=C2=B7) 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,

--=20
Nicolas Goaziou