From mboxrd@z Thu Jan  1 00:00:00 1970
From: Nick Dokos <nicholas.dokos@hp.com>
Subject: Re: org-publish-validate-link ?
Date: Mon, 27 Feb 2012 23:39:43 -0500
Message-ID: <7251.1330403983@alphaville>
References: <87ty2bbo9e.fsf@iro.umontreal.ca>
Reply-To: nicholas.dokos@hp.com
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 ([208.118.235.92]:35761)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <nicholas.dokos@hp.com>) id 1S2Er6-0005d0-5b
	for emacs-orgmode@gnu.org; Mon, 27 Feb 2012 23:40:05 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <nicholas.dokos@hp.com>) id 1S2Er3-00061V-AL
	for emacs-orgmode@gnu.org; Mon, 27 Feb 2012 23:40:03 -0500
Received: from g5t0008.atlanta.hp.com ([15.192.0.45]:46924)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <nicholas.dokos@hp.com>) id 1S2Er3-0005yZ-56
	for emacs-orgmode@gnu.org; Mon, 27 Feb 2012 23:40:01 -0500
In-Reply-To: Message from pinard@iro.umontreal.ca (=?us-ascii?Q?=3D=3Futf-?=
	=?us-ascii?Q?8=3FQ=3FFran=3DC3=3DA7ois=3F=3D?= Pinard)
	of "Mon\, 27 Feb 2012 23\:00\:45 EST." <87ty2bbo9e.fsf@iro.umontreal.ca>
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: =?us-ascii?Q?=3D=3Futf-8=3FQ=3FFran=3DC3=3DA7?=
	=?us-ascii?Q?ois=3F=3D?= Pinard <pinard@iro.umontreal.ca>
Cc: nicholas.dokos@hp.com, emacs-orgmode@gnu.org

Fran=C3=A7ois Pinard <pinard@iro.umontreal.ca> wrote:


> The manual, in [[info:org#Publishing%20links][Publishing links]],
> speaks about an *org-publish-validate-link* function which does not seem
> to exist in Org mode sources.  Is the function missing, or the
> documentation misleading? :-)
>=20

It was removed by Sebastian Rose in a cleaning binge back in 2010,
with the rationale that it was not being used anywhere:

,----
| commit 339d6fe4bbf7b9858c6323d01f32d0c73a4cd3a8
| Author: Sebastian Rose <sebastian_rose@gmx.de>
| Date:   Thu May 13 13:43:53 2010 +0200
|=20
|         ...
|=20=20=20=20=20
|     	* org-publish.el (org-publish-validate-link) was not used
|     	anywhere. Removed.
|=20=20=20=20=20
|         ...
`----

Apparently that had happened before because there is also this:

,----
| commit d1f91f7e936b1d3caf1b17f0fe755ee085256442
| Author: Carsten Dominik <carsten.dominik@gmail.com>
| Date:   Sun Nov 2 16:20:40 2008 +0100
|=20
|     Re-introduce the org-publish-validate-link function.
`----

but I cannot find the previous deletion.

It was originally introduced with the following commit:

,----
| commit 8fd900c6842d6f8d216ae6989b34c8de4a874e79
| Author: Carsten Dominik <dominik@nb-dominik2.science.uva.nl>
| Date:   Thu Jan 31 11:32:08 2008 +0100
|=20
|     Release 4.40
|=20
|     ...
|=20
| +;;;; Checking filenames against this hash
| +
| +
| +(defun org-publish-validate-link (link)
| +  (gethash (file-truename link) org-publish-files))
| +
| +
|=20
|     ...
`----

I presume it's time to add it back in, this time with a note: "Do NOT
delete: this function may look unused, but it's referred to from the
manual!"

Archaelogy is kind of fun ;-)

Nick