mirror of
git://git.sv.gnu.org/emacs.git
synced 2026-01-03 18:41:25 -08:00
Merge from origin/emacs-25
50650cbDoc fixes for fclist and grep5e814e0Minor doc fixes for quoting3347a73`nreverse' the marker pairs list1a4127dUse save-excursion in xref-location-marker moreab3ba91shell-quote-argument DIR when appropriate922c7a3Rework xref-query-replace-in-results3fe3510* lisp/replace.el (query-replace-read-from): Use minibuffer-w...0932b94Fix todo-mode bug involving archived items (bug#23447)e68ad1f; * etc/NEWS: Tiny edit. (Bug#23432)adc80b7; * test/automated/xref-tests.el: Add copyright and license.4d8fd9cHandle "empty line" regexp in xref searchesf559b37Add tests for xref-collect-matches6428aa0Use grep-find-ignored-directories instead of vc-directory-exc...6f82d8eClear buffer-undo-list when showing xrefsc68a091Note the quote translation in `message' in section "incompati...52f86a7* etc/NEWS: Mention (message "%s" (format ...)).93703c5(Common Keywords): Correct what missing :group means79e5800Improve documentation of Dired's 'A' and 'Q' commands2ea2a2fDoc fixes for quoting8544b98posnp doc clarification805204fMention what a missing :group doesec554d7Fix documentation of dired-aux search/replace commands
This commit is contained in:
commit
89ce83b202
29 changed files with 343 additions and 157 deletions
|
|
@ -1100,10 +1100,13 @@ These examples show typical uses of @code{error}:
|
|||
error symbol @code{error}, and a list containing the string returned by
|
||||
@code{format-message}.
|
||||
|
||||
In a format string containing single quotes, curved quotes @t{‘like
|
||||
this’} and grave quotes @t{`like this'} work better than straight
|
||||
quotes @t{'like this'}, as @code{error} typically formats every
|
||||
straight quote as a curved closing quote.
|
||||
The @code{text-quoting-style} variable controls what quotes are
|
||||
generated; @xref{Keys in Documentation}. A call using a format like
|
||||
@t{"Missing `%s'"} with grave accents and apostrophes typically
|
||||
generates a message like @t{"Missing ‘foo’"} with matching curved
|
||||
quotes. In contrast, a call using a format like @t{"Missing '%s'"}
|
||||
with only apostrophes typically generates a message like @t{"Missing
|
||||
’foo’"} with only closing curved quotes, an unusual style in English.
|
||||
|
||||
@strong{Warning:} If you want to use your own string as an error message
|
||||
verbatim, don't just write @code{(error @var{string})}. If @var{string}
|
||||
|
|
|
|||
|
|
@ -66,9 +66,12 @@ cause confusion.}
|
|||
|
||||
@kindex group@r{, customization keyword}
|
||||
@item :group @var{group}
|
||||
Put this customization item in group @var{group}. When you use
|
||||
@code{:group} in a @code{defgroup}, it makes the new group a subgroup of
|
||||
@var{group}.
|
||||
Put this customization item in group @var{group}. If this keyword is
|
||||
missing from a customization item, it'll be placed in the same group
|
||||
that was last defined (in the current file).
|
||||
|
||||
When you use @code{:group} in a @code{defgroup}, it makes the new
|
||||
group a subgroup of @var{group}.
|
||||
|
||||
If you use this keyword more than once, you can put a single item into
|
||||
more than one group. Displaying any of those groups will show this
|
||||
|
|
|
|||
|
|
@ -265,10 +265,13 @@ properties, it is displayed with the specified faces (@pxref{Faces}).
|
|||
The string is also added to the @file{*Messages*} buffer, but without
|
||||
text properties (@pxref{Logging Messages}).
|
||||
|
||||
In a format string containing single quotes, curved quotes @t{‘like
|
||||
this’} and grave quotes @t{`like this'} work better than straight
|
||||
quotes @t{'like this'}, as @code{message} typically formats every
|
||||
straight quote as a curved closing quote.
|
||||
The @code{text-quoting-style} variable controls what quotes are
|
||||
generated; @xref{Keys in Documentation}. A call using a format like
|
||||
@t{"Missing `%s'"} with grave accents and apostrophes typically
|
||||
generates a message like @t{"Missing ‘foo’"} with matching curved
|
||||
quotes. In contrast, a call using a format like @t{"Missing '%s'"}
|
||||
with only apostrophes typically generates a message like @t{"Missing
|
||||
’foo’"} with only closing curved quotes, an unusual style in English.
|
||||
|
||||
In batch mode, the message is printed to the standard error stream,
|
||||
followed by a newline.
|
||||
|
|
|
|||
|
|
@ -335,10 +335,14 @@ specifies @var{mapvar}'s value as the keymap for any following
|
|||
@item ‘
|
||||
@itemx `
|
||||
(left single quotation mark and grave accent) both stand for a left quote.
|
||||
This generates a left single quotation mark, an apostrophe, or a grave
|
||||
accent depending on the value of @code{text-quoting-style}.
|
||||
|
||||
@item ’
|
||||
@itemx '
|
||||
(right single quotation mark and apostrophe) both stand for a right quote.
|
||||
This generates a right single quotation mark or an apostrophe
|
||||
depending on the value of @code{text-quoting-style}.
|
||||
|
||||
@item \=
|
||||
quotes the following character and is discarded; thus, @samp{\=`} puts
|
||||
|
|
|
|||
|
|
@ -842,8 +842,14 @@ if any.
|
|||
This function acts like @code{format}, except it also converts any
|
||||
curved single quotes in @var{string} as per the value of
|
||||
@code{text-quoting-style}, and treats grave accent (@t{`}) and
|
||||
apostrophe (@t{'}) as if they were curved single quotes. @xref{Keys
|
||||
in Documentation}.
|
||||
apostrophe (@t{'}) as if they were curved single quotes.
|
||||
|
||||
A format that quotes with grave accents and apostrophes @t{`like
|
||||
this'} typically generates curved quotes @t{‘like this’}. In
|
||||
contrast, a format that quotes with only apostrophes @t{'like this'}
|
||||
typically generates two closing curved quotes @t{’like this’}, an
|
||||
unusual style in English. @xref{Keys in Documentation}, for how the
|
||||
@code{text-quoting-style} variable affects generated quotes.
|
||||
@end defun
|
||||
|
||||
@cindex @samp{%} in format
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue