diff options
author | Paul Eggert <eggert@cs.ucla.edu> | 2016-08-05 14:07:00 -0700 |
---|---|---|
committer | Paul Eggert <eggert@cs.ucla.edu> | 2016-08-05 14:07:00 -0700 |
commit | 1a86b5d6074d26d1a3a978cb52b2147b6f359694 (patch) | |
tree | 5b609435fb29b6f62766ddd51d8649013913970e /doc | |
parent | c5823cdae3de078e6db58df25769011ef3e52f36 (diff) | |
parent | d4c6774f40b6ae1fad091f66e8e43913bc9a2724 (diff) |
Merge from origin/emacs-25
d4c6774 Fix missing point information in undo
3a9d629 Avoid crashes when buffer modification hooks clobber match data
178b2f5 Note combine-and-quote-strings doesn't shell quote
dec7567 Explain when package-initialize isn't called
113d1e2 Fix escaping in sh-indent-after-continuation docstr
80e2044 ; * etc/NEWS: Improve previous change.
5bb9e6c ; * etc/NEWS: Document how to avoid horizontal scroll bars.
38f4b8e Clarify the documentation of back-references in replacements
Diffstat (limited to 'doc')
-rw-r--r-- | doc/emacs/search.texi | 12 | ||||
-rw-r--r-- | doc/lispref/os.texi | 10 | ||||
-rw-r--r-- | doc/lispref/processes.texi | 5 |
3 files changed, 18 insertions, 9 deletions
diff --git a/doc/emacs/search.texi b/doc/emacs/search.texi index d841934c85..b41214df1a 100644 --- a/doc/emacs/search.texi +++ b/doc/emacs/search.texi @@ -1356,12 +1356,12 @@ Replace every match for @var{regexp} with @var{newstring}. it can refer to all or part of what is matched by the @var{regexp}. @samp{\&} in @var{newstring} stands for the entire match being replaced. @samp{\@var{d}} in @var{newstring}, where @var{d} is a -digit, stands for whatever matched the @var{d}th parenthesized -grouping in @var{regexp}. (This is called a ``back reference''.) -@samp{\#} refers to the count of replacements already made in this -command, as a decimal number. In the first replacement, @samp{\#} -stands for @samp{0}; in the second, for @samp{1}; and so on. For -example, +digit starting from 1, stands for whatever matched the @var{d}th +parenthesized grouping in @var{regexp}. (This is called a ``back +reference''.) @samp{\#} refers to the count of replacements already +made in this command, as a decimal number. In the first replacement, +@samp{\#} stands for @samp{0}; in the second, for @samp{1}; and so on. +For example, @example M-x replace-regexp @key{RET} c[ad]+r @key{RET} \&-safe @key{RET} diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi index 38dde26d03..08c69d37c5 100644 --- a/doc/lispref/os.texi +++ b/doc/lispref/os.texi @@ -155,9 +155,13 @@ It loads your abbrevs from the file specified by option @samp{--batch} was specified. @item -If @code{package-enable-at-startup} is non-@code{nil}, it calls the -function @code{package-initialize} to activate any optional Emacs Lisp -package that has been installed. @xref{Packaging Basics}. +It calls the function @code{package-initialize} to activate any +optional Emacs Lisp package that has been installed. @xref{Packaging +Basics}. However, Emacs doesn't initialize packages when +@code{package-enable-at-startup} is @code{nil} or when it's started +with one of the options @samp{-q}, @samp{-Q}, or @samp{--batch}. To +initialize packages in the latter case, @code{package-initialize} +should be called explicitly (e.g., via the @samp{--funcall} option). @vindex after-init-time @item diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi index f859b3adde..cd1201276e 100644 --- a/doc/lispref/processes.texi +++ b/doc/lispref/processes.texi @@ -215,6 +215,11 @@ converting user input in the minibuffer, a Lisp string, into a list of string arguments to be passed to @code{call-process} or @code{start-process}, or for converting such lists of arguments into a single Lisp string to be presented in the minibuffer or echo area. +Note that if a shell is involved (e.g., if using +@code{call-process-shell-command}), arguments should still be +protected by @code{shell-quote-argument}; +@code{combine-and-quote-strings} is @emph{not} intended to protect +special characters from shell evaluation. @defun split-string-and-unquote string &optional separators This function splits @var{string} into substrings at matches for the |