Nick Dokos <nicholas.do...@hp.com> writes: > François Pinard <pin...@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_r...@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.domi...@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.
From git log -Sdefun\ org-publish-validate-link ,---- | commit b05bc10e6794c902df679b906d8bd6ec3f5633a9 | Author: Bastien Guerry <b...@altern.org> | Date: Sun Mar 2 14:14:52 2008 +0000 | | Cleaned up code. | `---- -Bernt > > It was originally introduced with the following commit: > > ,---- > | commit 8fd900c6842d6f8d216ae6989b34c8de4a874e79 > | Author: Carsten Dominik <domi...@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