Richard Stallman <r...@gnu.org> writes: > NOTE: Is it absolute;y necessary to cross post to emacs-devel and > emacs-orgmode?
This branch of the discussion is also about Org mode development. And we discuss Org mode development in our mailing list. Not all Org mode users and contributors are subscribed to emacs-devel, so they would miss this thread if I did not cross-post. > Could you please explain in a few lines what sort of jobs org-protocol.el > does? > The doc you sent > ... > > describes in a low-level way _how_ to use it, but in order to think > about that, the first thing I need to know is _what jobs it can do_. 1. Send web pages (urls, page title, text selection) from browser to Emacs buffers. This is often used to "bookmark" pages using Emacs. 2. Save web links from browser/command line into Org link kill ring. 3. Locate and open local source of web pages in Emacs. For example, when users have a local git clone of Org wiki pages (https://orgmode.org/worg/), they can open Org mode file corresponding to any Org wiki page opened in browser in Emacs. All the above can also be done from command line or by invoking system URI handler - from any application that knows how to open custom URI schema. (1) and (2) are specific to Org mode and will be left as a part of Org package. But the core framework and maybe (3) might be upstreamed. The above can also be achieved by invoking emacsclient --eval, but org-protocol (1) makes it safer as only pre-defined Elisp code will be evaluated, preventing security issues; (2) integrates with OS URI handlers. > > With org-protocol, one can also make Emacs receive data from browser and > > perform any action defined by custom handler function - all fully > > configurable and not necessarily related to Org mode. > > Could you state a few examples? In addition to the above 3 examples there are many possibilities. Say, one can take some proprietary web page like reddit, and make it open using Emacs reddit frontend. Or save a quick note right from terminal outside Emacs emacsclient "org-protocol://capture?title=A quick note for later" > Also, how is this related to Org mode? Why call it "org-protocol" rather > tham some other name? (1) is using org-capture library to put the received url/title/annotation into user-defined template and save the filled template into Org files. (2) is using `org-store-link' to save url/title as Org mode link. > > 17.16.3 The open-source protocol > > ... The open-source handler is designed to help with editing local > > sources when reading a document.. > > What document does that come from? Org mode manual. You can evaluate (info "(org)Protocols") to get there in Emacs. -- 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>