On 24/06/2025 04:40, Christian Moe wrote:
Charles Choi writes:
Patch v5 (fbed0861) of org-protocol.org <http://org-protocol.org/> rewrite.
Thanks! Applied now. (The build should happen in a few hours.)
Thank you, Christian.
Charles, do you plan further changes of org-protocol.org? Are you
interested in discussion of its modifications?
On 23/06/2025 02:26, Charles Choi wrote:
"nee"?
Definition: originally or formerly called.
Thanks. I was a bit confused by single variant "née" in
https://www.oxfordlearnersdictionaries.com/definition/english/nee
I have seen macOS/OSX variants, but I was not aware that X in Mac OS X
is actually v10.
From my point of view *obsolete* should be still available while
"remember" has been completely *removed*.
Changed to use “removed” instead of obsolete. My conventional (and
arguably dated) understanding of obsolete and deprecated is reflected in
this MDN document (https://developer.mozilla.org/en-US/docs/MDN/
Writing_guidelines/Experimental_deprecated_obsolete) where “obsolete”
meant unsupported and “deprecated” meant no longer recommended. That
said, given the ambiguity of “obsolete”, have made this change.
I should pay more attention to actual usage of "obsolete". It is more
ambiguous than I expected.
I find the following fragments at the end of sections for specific OSes almost
identical
I would consider moving a single instance to the common part. A remark
on macOS should not be annoying or distracting for Linux and Windows users.
Those sections have been consolidated into the common section.
I had in mind even more aggressive deduplication, see the attachment.
I do not think, the "3rd Party Applications" group is required. If it is
dropped then Captee becomes a sibling of browser bookmarklets.
diff --git a/org-contrib/org-protocol.org b/org-contrib/org-protocol.org
index e176bd84..6d86a500 100644
--- a/org-contrib/org-protocol.org
+++ b/org-contrib/org-protocol.org
@@ -141,28 +141,6 @@ ******* If you use Emacs < 30
: update-desktop-database ~/.local/share/applications/
-***** Test your Org protocol setup
-
-To test that Org protocol is setup and running, click on the JavaScript link
-below to store an Org link to this page.
-
-#+begin_export html
- <ul>
- <li><a href="javascript:storeLink();">Test Org protocol store-link</a></li>
- </ul>
-#+end_export
-
-In an Org buffer, use the binding ~C-c M-l~
-(~org-insert-last-stored-link~) to paste the recently stored Org link.
-
-***** Setup Org protocol capture
-See [[#capture][Setup Org protocol capture]] in the common section.
-
-***** Construct Org protocol URL Request
-See [[#construct-url-request][Construct Org protocol URL request]] in the common section.
-
------
-
*** macOS
***** Setup Emacs Server
@@ -207,28 +185,6 @@ ***** Setup the Org protocol scheme handler
below.
#+end_blindtext
-***** Test your Org protocol setup
-
-To test that Org protocol is setup and running, click on the JavaScript link
-below to store an Org link to this page.
-
-#+begin_export html
- <ul>
- <li><a href="javascript:storeLink();">Test Org protocol store-link</a></li>
- </ul>
-#+end_export
-
-In an Org buffer, use the binding ~C-c M-l~
-(~org-insert-last-stored-link~) to paste the recently stored Org link.
-
-***** Setup Org protocol capture
-See [[#capture][Setup Org protocol capture]] in the common section.
-
-***** Construct Org protocol URL request
-See [[#construct-url-request][Construct Org protocol URL request]] in the common section.
-
------
-
*** Windows
***** Setup Emacs Server
@@ -267,6 +223,7 @@ ***** Setup the Org protocol scheme handler
@="\"C:\\Programme\\Emacs\\emacs\\bin\\emacsclientw.exe\" \"%1\""
#+end_example
+*** Common
***** Test your Org protocol setup
To test that Org protocol is setup and running, click on the JavaScript link
@@ -281,14 +238,6 @@ ***** Test your Org protocol setup
In an Org buffer, use the binding ~C-c M-l~
(~org-insert-last-stored-link~) to paste the recently stored Org link.
-***** Setup Org protocol capture
-See [[#capture][Setup Org protocol capture]] in the common section.
-
-***** Construct Org protocol URL request
-See [[#construct-url-request][Construct Org protocol URL request]] in the common section.
-
------
-*** Common
***** Setup Org protocol capture
:PROPERTIES:
:CUSTOM_ID: capture
@@ -361,6 +310,9 @@ ***** Setup Org protocol capture
)))
#+end_src
+The next step is configuring applications to
+[[#construct-url-request][Construct =org-protocol:/capture= URL request]].
+
***** Setup Org protocol open source
#+begin_warningbox
