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. 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