From mboxrd@z Thu Jan 1 00:00:00 1970 From: =?utf-8?Q?Fran=C3=A7ois?= Allisson Subject: [PATCH] Update documentation on handling internal links Date: Tue, 08 Jan 2013 22:10:49 +0100 Message-ID: <87a9sje5ye.fsf@allisson.co> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Return-path: Received: from eggs.gnu.org ([208.118.235.92]:33941) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TsgQc-0007Yl-6G for emacs-orgmode@gnu.org; Tue, 08 Jan 2013 16:09:47 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TsgQZ-0000Hq-UY for emacs-orgmode@gnu.org; Tue, 08 Jan 2013 16:09:46 -0500 Received: from relay3-d.mail.gandi.net ([217.70.183.195]:44093) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TsgQZ-0000He-Mh for emacs-orgmode@gnu.org; Tue, 08 Jan 2013 16:09:43 -0500 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: Org mode --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hi, The attached documentation patch updates 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'. Furthermore, it mentions that (require 'org-id) is necessary for `org-id-link-to-org-use-id' to work. Perhaps it is not what should be done. Shall org-id be required by default? Best, and thanks all for 7.9.3a ! I'm testing. Fran=C3=A7ois --=-=-= Content-Type: text/x-diff; charset=utf-8 Content-Disposition: attachment; filename=0001-org.texi-Update-documentation-on-org-id-link-to-org-.patch Content-Transfer-Encoding: quoted-printable >From 0dc2100e3ce1da1f6a5738dd0cbc13e39d39e433 Mon Sep 17 00:00:00 2001 From: Fran=C3=A7ois Allisson Date: Tue, 8 Jan 2013 21:54:19 +0100 Subject: [PATCH] org.texi: Update documentation on `org-id-link-to-org-us= e-id' --- doc/org.texi | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/doc/org.texi b/doc/org.texi index 6625ed8..35adfa9 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -3445,13 +3445,15 @@ 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.}. -@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{In order to use +@code{org-id} facilities, @code{(require 'org-id)} has to be found in yo= ur +@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 -- 1.7.10.4 --=-=-=--