Add quotes to emacsclient arguments in examples

* doc/org-manual.org:
* lisp/org-protocol.el: Quote emacsclient arguments
in examples to prevent interpreting of ampersands as intent
to run processes in background by bash and similar shells.
Single quotes may cause a problem with cmd.exe, so use
double quotes despite they are a bit less safe in bash and Co.
This commit is contained in:
Maxim Nikulin 2021-03-28 23:38:59 +07:00 committed by Kyle Meyer
parent a17243f9a5
commit 4de2fff87d
2 changed files with 4 additions and 4 deletions

View File

@ -19535,7 +19535,7 @@ passed to Emacs through the =emacsclient= command, so you also need to
ensure an Emacs server is running. More precisely, when the
application calls
: emacsclient org-protocol://PROTOCOL?key1=val1&key2=val2
: emacsclient "org-protocol://PROTOCOL?key1=val1&key2=val2"
#+texinfo: @noindent
Emacs calls the handler associated to {{{var(PROTOCOL)}}} with
@ -19558,7 +19558,7 @@ Using the ~store-link~ handler, you can copy links, to that they can
be inserted using {{{kbd(M-x org-insert-link)}}} or yanking. More
precisely, the command
: emacsclient org-protocol://store-link?url=URL&title=TITLE
: emacsclient "org-protocol://store-link?url=URL&title=TITLE"
#+texinfo: @noindent
stores the following link:
@ -19587,7 +19587,7 @@ javascript:location.href='org-protocol://store-link?url='+
Activating the "capture" handler pops up a =Capture= buffer in Emacs,
using acapture template.
: emacsclient org-protocol://capture?template=X&url=URL&title=TITLE&body=BODY
: emacsclient "org-protocol://capture?template=X&url=URL&title=TITLE&body=BODY"
To use this feature, add a bookmark with an arbitrary name, e.g.,
=Org: capture=, and enter this as =Location=:

View File

@ -49,7 +49,7 @@
;; 4.) Try this from the command line (adjust the URL as needed):
;;
;; $ emacsclient \
;; org-protocol://store-link?url=http:%2F%2Flocalhost%2Findex.html&title=The%20title
;; "org-protocol://store-link?url=http:%2F%2Flocalhost%2Findex.html&title=The%20title"
;;
;; 5.) Optionally add custom sub-protocols and handlers:
;;