From d2c4309d46529bac656f332677d2c5e199577845 Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Sun, 2 Aug 2015 12:43:20 -0700 Subject: [PATCH] Also mention "curly quotes" See Drew Adams's email in: http://lists.gnu.org/archive/html/emacs-devel/2015-08/msg00040.html * doc/lispref/help.texi (Keys in Documentation): Add index entry "curly quotes". * etc/NEWS: Use the phrase "curly quotes" too. --- doc/lispref/help.texi | 1 + etc/NEWS | 22 ++++++++++++---------- 2 files changed, 13 insertions(+), 10 deletions(-) diff --git a/doc/lispref/help.texi b/doc/lispref/help.texi index fde985d9b0b..779a0d581e2 100644 --- a/doc/lispref/help.texi +++ b/doc/lispref/help.texi @@ -349,6 +349,7 @@ string in Emacs Lisp. @defvar help-quote-translation @cindex curved quotes +@cindex curly quotes The value of this variable specifies the style @code{substitute-command-keys} uses when generating left and right quotes. If the variable's value is @code{?‘} (U+2018 LEFT SINGLE diff --git a/etc/NEWS b/etc/NEWS index 6dbe6b38b11..4ab80f53fd7 100644 --- a/etc/NEWS +++ b/etc/NEWS @@ -887,15 +887,15 @@ denied" instead of "permission denied". The old behavior was problematic in languages like German where downcasing rules depend on grammar. ** substitute-command-keys now replaces quotes. -That is, it replaces left single quotation marks (‘) by left quotes -and right single quotation marks (’) by right quotes. It also -replaces grave accents by left quotes, and apostrophes that match -grave accents by right quotes. As before, isolated apostrophes and -characters preceded by \= are output as-is. Left and right quotes are -determined by new custom variable ‘help-quote-translation’. ?‘ means -quote ‘like this’, ?' means quote 'like this', ?` means quote `like -this', and nil (default) means quote ‘like this’ if displayable and -'like this' otherwise. +That is, it converts documentation strings' quoting style as per the +value of the new custom variable ‘help-quote-translation’: ?‘ means +use curved quotes (also known as curly quotes) ‘like this’, ?' means +use apostrophes 'like this', ?` means use grave accent and apostrophe +`like this', and nil (default) means use curved quotes if displayable +and grave accent and apostrophe otherwise. Doc strings in source code +can use either curved quotes or grave accent and apostrophe. As +before, isolated apostrophes and characters preceded by \= are output +as-is. +++ ** The character classes [:alpha:] and [:alnum:] in regular expressions @@ -1014,7 +1014,9 @@ apostrophe `like-this'. The new style looks better on today's displays. In the new Electric Quote mode, you can enter curved single quotes into documentation by typing ` and '. Outside Electric Quote mode, you can enter them by typing ‘C-x 8 [’ and ‘C-x 8 ]’, or (if your Alt -key works) by typing ‘A-[’ and ‘A-]’. +key works) by typing ‘A-[’ and ‘A-]’. As described above under +‘help-quote-translation’, the user can specify how to display doc +string quotes. +++ ** Time-related changes: -- 2.39.2