summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMaxim Nikulin <manikulin@gmail.com>2021-03-28 23:38:59 +0700
committerKyle Meyer <kyle@kyleam.com>2021-03-29 00:32:29 -0400
commit4de2fff87d11d75adbbc48fae1c0d6f0ec3fd6c0 (patch)
tree72cedb221640c623659f4cb1b11d73396407bc3c
parenta17243f9a52141d16045154d646d2dba2d301201 (diff)
downloadorg-mode-4de2fff87d11d75adbbc48fae1c0d6f0ec3fd6c0.tar.gz
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.
-rw-r--r--doc/org-manual.org6
-rw-r--r--lisp/org-protocol.el2
2 files changed, 4 insertions, 4 deletions
diff --git a/doc/org-manual.org b/doc/org-manual.org
index f4872fc..27d6ba5 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -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=:
diff --git a/lisp/org-protocol.el b/lisp/org-protocol.el
index 7f9a6ae..be74057 100644
--- a/lisp/org-protocol.el
+++ b/lisp/org-protocol.el
@@ -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:
;;