* bug#36883: Make Gnus documentation clearer ("dumbquotes")
@ 2019-07-31 22:02 Keith Thompson
2019-09-23 22:43 ` Lars Ingebrigtsen
0 siblings, 1 reply; 2+ messages in thread
From: Keith Thompson @ 2019-07-31 22:02 UTC (permalink / raw)
To: 36883; +Cc: Keith Thompson
Emacs 26.2.90, Gnus v5.1
The Gnus info documentation includes the following:
‘W d’
Treat M****s*** sm*rtq**t*s according to
‘gnus-article-dumbquotes-map’ (‘gnus-article-treat-dumbquotes’).
Note that this function guesses whether a character is a sm*rtq**t*
or not, so it should only be used interactively.
Sm*rtq**t*s are M****s***’s unilateral extension to the character
map in an attempt to provide more quoting characters. If you see
something like ‘\222’ or ‘\264’ where you’re expecting some kind of
apostrophe or quotation mark, then try this wash.
I suggest changing "M****s***" to "Micrsoft" and "sm*rtq**t*s" to "smartquotes"
throughout.
I'd also suggest changing the command names "article-treat-dumbquotes"
and "gnus-article-treat-dumbquotes" to refer to "smartquotes" rather than
"dumbquotes", probably keeping the existing names as aliases.
IMHO documentation should make it easy to search without being
an obstacle to understanding. I don't object to snark, but it shoudn't
come at the expense of clarity.
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2019-09-23 22:43 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2019-07-31 22:02 bug#36883: Make Gnus documentation clearer ("dumbquotes") Keith Thompson
2019-09-23 22:43 ` Lars Ingebrigtsen
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.