From mboxrd@z Thu Jan  1 00:00:00 1970
From: Rasmus <rasmus@gmx.us>
Subject: Re: template for writing Emacs manuals in Org
Date: Wed, 18 May 2016 18:43:53 +0200
Message-ID: <87mvnnfh9y.fsf@gmx.us>
References: <87eg955clk.fsf@ericabrahamsen.net> <87wpmt7u5i.fsf@gmx.us>
	<m2k2it7spp.fsf@tsdye.com> <87r3d1u5yn.fsf@saiph.selenimh>
	<m2eg917ko2.fsf@tsdye.com> <87eg91ten0.fsf@saiph.selenimh>
	<m260uc7nhc.fsf@tsdye.com> <87a8jou24u.fsf@saiph.selenimh>
	<m237pg7cr6.fsf@tsdye.com>
	<87futgikda.fsf@alphaville.usersys.redhat.com> <87oa83afi5.fsf@gmx.us>
	<4BDEAAA9-55A2-4886-80E1-ECF273D4C7E1@gmail.com>
	<87bn43xrqs.fsf@saiph.selenimh>
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]:47167)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <rasmus@gmx.us>) id 1b34Zn-0007Mg-8j
	for emacs-orgmode@gnu.org; Wed, 18 May 2016 12:44:04 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <rasmus@gmx.us>) id 1b34Zi-0002Vt-96
	for emacs-orgmode@gnu.org; Wed, 18 May 2016 12:44:02 -0400
Received: from mout.gmx.net ([212.227.17.21]:62305)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <rasmus@gmx.us>) id 1b34Zh-0002Vc-Vc
	for emacs-orgmode@gnu.org; Wed, 18 May 2016 12:43:58 -0400
In-Reply-To: <87bn43xrqs.fsf@saiph.selenimh> (Nicolas Goaziou's message of
	"Wed, 18 May 2016 18:20:27 +0200")
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"
	<emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: jonathan.leechpepin@gmail.com
Cc: emacs-orgmode@gnu.org

Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:

> Hello,
>
> Jonathan Leech-Pepin <jonathan.leechpepin@gmail.com> writes:
>
>> I=E2=80=99m trying to remember why I didn=E2=80=99t implement indexes as=
 properties
>> (it may well have been because I simply didn=E2=80=99t consider it). Ass=
uming
>> there=E2=80=99s nothing in the exporter to prevent converting properties=
 to
>> text after headlines it could work. Treat comma separated values as
>> separate entries.
>
> Index entries are not section wide. It doesn't sound right to attach
> them to properties drawers.

In many cases an index entry is referring explicitly to a specific
heading.  Example:

    ** Installation
       :PROPERTIES:
       :DESCRIPTION: How to install a downloaded version of Org-mode
       :END:

    #+cindex: installation

In such cases I=E2=80=99d prefer to able to attach the index specifically t=
o the
heading.  Much the same way that I prefer to give a heading a custom_id
property rather than putting a <<label>> after a headline.

> Besides, the {{{cindex()}}} macro is not used anymore.  There is the
> CINDEX keyword, which is slightly better.

My bad, I must have accidentally looked at the version before your recent
changes.  The keyword is already better.

> I guess we could use #+INDEX instead, but it would require to add an
> information specific to Texinfo (index type), which would probably
> defeat the simplicity of the solution.

Either is fine.  Though I don=E2=80=99t think it=E2=80=99s less simple to h=
ave a key.

   #+index: key :type cindex.

Rasmus

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