diff options
| author | Alan Mackenzie <acm@muc.de> | 2017-09-21 20:31:06 +0000 |
|---|---|---|
| committer | Alan Mackenzie <acm@muc.de> | 2017-10-01 11:27:15 +0000 |
| commit | d5e4e004fa134cb81989bcf40c5d6c79b837301f (patch) | |
| tree | 7588a351b8bd89612cdb457979f84b5f9f90c826 /doc/lispref/help.texi | |
| parent | 1ba3471b9b443f0617662f4a50439bec211162ba (diff) | |
| download | emacs-d5e4e004fa134cb81989bcf40c5d6c79b837301f.tar.gz | |
Make text-quoting-style customizable. Introduce t and new meaning for nil.
A value of nil for text-quoting-style now means "no translation". t means
"Use curved quotes if displayable".
* src/doc.c (text-quoting-style (function)): modify for new semantics.
(text-quoting-style (variable)): Amend the doc string, set the default value
to t.
* lisp/cus-start.el: (top level): Create a customize entry for
text-quoting-style in group display.
* etc/NEWS: Amend the entry for text-quoting-style.
* doc/emacs/display.texi (Text Display): Describe the translation of ASCII
quotes to curved quotes, and how to influence or inhibit it.
* doc/lispref/control.texi (Signalling Errors)
* doc/lispref/display.texi (Displaying Messages)
* doc/lispref/strings.texi (Formatting Strings): Describe binding
text-quoting-style to nil to inhibit unwanted quote translation.
* doc/lispref/help.texi (Keys in Documentation): Change text-quoting-style
from a variable to a user option. Describe its changed set of values. State
that it can be customized freely.
Diffstat (limited to 'doc/lispref/help.texi')
| -rw-r--r-- | doc/lispref/help.texi | 31 |
1 files changed, 15 insertions, 16 deletions
diff --git a/doc/lispref/help.texi b/doc/lispref/help.texi index cb214113523..e1e98124e08 100644 --- a/doc/lispref/help.texi +++ b/doc/lispref/help.texi @@ -351,25 +351,24 @@ and @samp{\=\=} puts @samp{\=} into the output. @strong{Please note:} Each @samp{\} must be doubled when written in a string in Emacs Lisp. -@defvar text-quoting-style +@defopt text-quoting-style @cindex curved quotes @cindex curly quotes The value of this variable is a symbol that specifies the style Emacs -should use for single quotes in the wording of help and messages. -If the variable's value is @code{curve}, the style is -@t{‘like this’} with curved single quotes. If the value is -@code{straight}, the style is @t{'like this'} with straight -apostrophes. If the value is @code{grave}, -quotes are not translated and the style is @t{`like -this'} with grave accent and apostrophe, the standard style -before Emacs version 25. The default value @code{nil} -acts like @code{curve} if curved single quotes are displayable, and -like @code{grave} otherwise. - -This variable can be used by experts on platforms that have problems -with curved quotes. As it is not intended for casual use, it is not a -user option. -@end defvar +should use for single quotes in the wording of help and messages. If +the variable's value is @code{curve}, the style is @t{‘like this’} +with curved single quotes. If the value is @code{straight}, the style +is @t{'like this'} with straight apostrophes. If the value is +@code{nil} or @code{grave}, quotes are not translated and the style is +@t{`like this'} with grave accent and apostrophe, the standard style +before Emacs version 25. The default value @code{t} acts like +@code{curve} if curved single quotes seem to be displayable, and like +@code{nil} otherwise. + +This option is useful on platforms that have problems with curved +quotes. You can customize it freely according to your personal +preference. +@end defopt @defun substitute-command-keys string This function scans @var{string} for the above special sequences and |