Max Nikulin <maniku...@gmail.com> writes: > Ihor, Hugo raised a question how to interpret nil returned by > :insert-description functions. Do you have any opinion? I do not like > the idea to consider it as an error since string is expected. I would > prefer to call `org-link-make-description-function' as a fallback. > > On 17/07/2022 04:20, Hugo Heagren wrote: >>> Can you also update the documentation for >>> org-link-make-description-function? >> >> I'm not sure what sort of documentation you have in mind? What should >> I add? > > I have no idea what Ihor means. From my point of view, mention of > :insert-description and `org-link-parameters' may give a hint to users.
Let me clarify. The new :insert-description parameter is a more fine-grained equivalent to already existing org-link-make-description-function. The latter can, de facto, return string or nil - it is passed to `read-string' as INITIAL-INPUT argument. So, I suggested interpreting nil return value in :insert-description just as it is already interpreted in org-link-make-description-function. Further, I asked to document that nil value is allowed - both in :insert-description docstring section and in org-link-make-description-function docstring. Best, Ihor