From 9d6b216d4bd654f976cd889dec2f805f05f76428 Mon Sep 17 00:00:00 2001 From: Max Nikulin Date: Thu, 9 Feb 2023 22:31:51 +0700 Subject: [PATCH] ol.el: Recommend `browse-url' to `:follow' links * lisp/ol.el (org-link-parameters): Recommend the `browse-url' function for calling external protocol handlers in the docstring. This is indirect follow-up of the https://list.orgmode.org/3218434.44csPzL39Z@linux.fritz.box/ thread. --- lisp/ol.el | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/lisp/ol.el b/lisp/ol.el index 9e4781f6e..dd883ab29 100644 --- a/lisp/ol.el +++ b/lisp/ol.el @@ -109,6 +109,20 @@ (defcustom org-link-parameters nil Here, you may use `org-link-open-as-file' helper function for types similar to \"file\". + To invoke an external handler of specific URI scheme such as \"irc:\", + consider delegating the task to `browse-url', for details + see Info node `(emacs) Browse-URL'. + + (lambda (path &optional arg) + (browse-url (concat type \":\" path) arg)) + + Either ensure that a system-wide protocol handler is configured or + add an entry to `browse-url-handlers' for Emacs-28 and newer + or define `browse-url-browser-function' as alist for older versions. + The advantage of this approach is that the same handler + will be available for `goto-address-mode' + (see Info node `(emacs) Goto Address mode'). + `:export' Function that accepts four arguments: -- 2.25.1