From mboxrd@z Thu Jan 1 00:00:00 1970 From: Rasmus Subject: Comments in @example in org.texi Date: Tue, 13 Jan 2015 13:02:14 +0100 Message-ID: <87ppaikhx5.fsf@gmx.us> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:47330) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YB0B4-0002E4-IB for emacs-orgmode@gnu.org; Tue, 13 Jan 2015 07:02:31 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YB0B1-0000WP-Df for emacs-orgmode@gnu.org; Tue, 13 Jan 2015 07:02:30 -0500 Received: from plane.gmane.org ([80.91.229.3]:58224) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YB0B1-0000WJ-6f for emacs-orgmode@gnu.org; Tue, 13 Jan 2015 07:02:27 -0500 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1YB0Az-0004Fj-Hm for emacs-orgmode@gnu.org; Tue, 13 Jan 2015 13:02:25 +0100 Received: from 109.201.154.176 ([109.201.154.176]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 13 Jan 2015 13:02:25 +0100 Received: from rasmus by 109.201.154.176 with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 13 Jan 2015 13:02:25 +0100 List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-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: emacs-orgmode@gnu.org 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