Re: org-publish-validate-link ?

[Nick Dokos <nicholas.dokos@hp.com>]

François 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? :-)
> 

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
| 
|         ...
|     
|     	* org-publish.el (org-publish-validate-link) was not used
|     	anywhere. Removed.
|     
|         ...
`----

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
| 
|     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
| 
|     Release 4.40
| 
|     ...
| 
| +;;;; Checking filenames against this hash
| +
| +
| +(defun org-publish-validate-link (link)
| +  (gethash (file-truename link) org-publish-files))
| +
| +
| 
|     ...
`----

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