emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

master 74a4f3e: Improve formatting in text-quoting-style docstring


From: Stefan Kangas
Subject: master 74a4f3e: Improve formatting in text-quoting-style docstring
Date: Thu, 6 May 2021 10:37:18 -0400 (EDT)

branch: master
commit 74a4f3e043455364fddb1becc2da0c4be42e78e0
Author: Stefan Kangas <stefan@marxist.se>
Commit: Stefan Kangas <stefan@marxist.se>

    Improve formatting in text-quoting-style docstring
    
    * src/doc.c (syms_of_doc) <text-quoting-style>: Doc fix; improve
    formatting for readability.
---
 src/doc.c | 24 +++++++++++++-----------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/src/doc.c b/src/doc.c
index e179a12..63e0cbb 100644
--- a/src/doc.c
+++ b/src/doc.c
@@ -719,17 +719,19 @@ syms_of_doc (void)
 
   DEFVAR_LISP ("text-quoting-style", Vtext_quoting_style,
                doc: /* Style to use for single quotes in help and messages.
-Its value should be a symbol.  It works by substituting certain single
-quotes for grave accent and apostrophe.  This is done in help output
-\(but not for display of Info manuals) and in functions like `message'
-and `format-message'.  It is not done in `format'.
-
-`curve' means quote with curved single quotes ‘like this’.
-`straight' means quote with straight apostrophes \\='like this\\='.
-`grave' means quote with grave accent and apostrophe \\=`like this\\=';
-i.e., do not alter quote marks.  The default value nil acts like
-`curve' if curved single quotes are displayable, and like `grave'
-otherwise.  */);
+
+This works by substituting certain single quotes for grave accent and
+apostrophe.  This is done in help output (but not for display of Info
+manuals) and in functions like `message' and `format-message'.  It is
+not done in `format'.
+
+Its value should be one of these symbols:
+  `curve':    quote with curved single quotes ‘like this’.
+  `straight': quote with straight apostrophes \\='like this\\='.
+  `grave':    quote with grave accent and apostrophe \\=`like this\\=';
+             i.e., do not alter quote marks.
+  nil:        like `curve' if curved single quotes are displayable,
+             and like `grave' otherwise.  */);
   Vtext_quoting_style = Qnil;
 
   DEFVAR_BOOL ("internal--text-quoting-flag", text_quoting_flag,



reply via email to

[Prev in Thread] Current Thread [Next in Thread]