Max Nikulin <maniku...@gmail.com> writes: >> Maybe better add this to "A.3 Adding Hyperlink Types" section of the manual? > > If you you believe that the (info "(org) Adding Hyperlink Types") > section should be expanded then a complete example is necessary, some > ideas may be picked from > > https://orgmode.org/worg/org-faq.html#mailto-links > https://orgmode.org/worg/org-faq.html#mid-url-handler > > While the manual section and the `org-link-parameters' docstring as the > reference may be cross-linked, some note on `browse-url' still may be > helpful in the latter.
I believe that examples like yours really belong to the manual, not to the docstring. Your example is the shortest possible way to define a new link type as opposed to writing a whole new library - something rather hard to achieve for less experienced users. So, I suggest to 1. Put your example to the beginning of "Adding Hyperlink Types" section of the manual as the simplest way to define a new link type and use ol-man as a more complex example if more features are needed. 2. Refer to (info "(org) Adding Hyperlink Types") from the docstring of `org-link-parameters'. WDYT? -- Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at <https://orgmode.org/>. Support Org development at <https://liberapay.com/org-mode>, or support my work at <https://liberapay.com/yantar92>