From mboxrd@z Thu Jan 1 00:00:00 1970 From: =?utf-8?Q?Fran=C3=A7ois?= Allisson Subject: Re: [PATCH] Update documentation on handling internal links Date: Wed, 09 Jan 2013 12:42:16 +0100 Message-ID: <8738ya37mv.fsf@allisson.co> References: <87a9sje5ye.fsf@allisson.co>,<87ip772tgy.fsf@bzg.ath.cx> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Return-path: Received: from eggs.gnu.org ([208.118.235.92]:41237) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Tsu20-0003w4-8E for emacs-orgmode@gnu.org; Wed, 09 Jan 2013 06:41:20 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Tsu1t-0007Br-L4 for emacs-orgmode@gnu.org; Wed, 09 Jan 2013 06:41:16 -0500 Received: from relay3-d.mail.gandi.net ([217.70.183.195]:45349) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Tsu1t-0007Bh-Dv for emacs-orgmode@gnu.org; Wed, 09 Jan 2013 06:41:09 -0500 In-reply-to: <87ip772tgy.fsf@bzg.ath.cx> 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: Bastien Cc: Org mode --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Le vendredi 8 mars 2013 =C3=A0 23h35, Bastien a =C3=A9crit: > Can you update your patch mentioning this and adding a commit message > and adding TINYCHANGE at the end? Here it is. Fran=C3=A7ois --=-=-= Content-Type: text/x-diff; charset=utf-8 Content-Disposition: attachment; filename=0001-org.texi-Update-documentation-on-internal-link-handl.patch Content-Transfer-Encoding: quoted-printable >From 169d8382f01b8914e002313032c2d123c86b913a Mon Sep 17 00:00:00 2001 From: Fran=C3=A7ois Allisson Date: Wed, 9 Jan 2013 12:32:09 +0100 Subject: [PATCH] org.texi: Update documentation on internal link handling * Update the mention to the obsolete variable `org-link-to-org-use-id' with a mention to the newer variable `org-id-link-to-org-use-id'. * Mention the need to load the org-id library. TINYCHANGE --- doc/org.texi | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/doc/org.texi b/doc/org.texi index 8b0a59f..c6e5b70 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -3445,13 +3445,16 @@ be the description@footnote{If the headline conta= ins a timestamp, it will be removed from the link and result in a wrong link---you should avoid putt= ing timestamp in the headline.}. =20 -@vindex org-link-to-org-use-id +@vindex org-id-link-to-org-use-id @cindex property, CUSTOM_ID @cindex property, ID If the headline has a @code{CUSTOM_ID} property, a link to this custom I= D will be stored. In addition or alternatively (depending on the value of -@code{org-link-to-org-use-id}), a globally unique @code{ID} property wil= l be -created and/or used to construct a link. So using this command in Org +@code{org-id-link-to-org-use-id}), a globally unique @code{ID} property = will +be created and/or used to construct a link@footnote{The library @code{or= g-id} +must first be loaded, either through @code{org-customize} by enabling +@code{id} in @code{org-modules} , or by adding @code{(require 'org-id)} = in +your @file{.emacs}.}. So using this command in Org buffers will potentially create two links: a human-readable from the cus= tom ID, and one that is globally unique and works even if the entry is moved= from file to file. Later, when inserting the link, you need to decide which = one --=20 1.7.10.4 --=-=-=--