]> git.notmuchmail.org Git - notmuch/commit
emacs docs: rstdoc.el: consistent single quote conversions
authorTomi Ollila <tomi.ollila@iki.fi>
Fri, 9 Oct 2020 07:32:02 +0000 (10:32 +0300)
committerDavid Bremner <david@tethera.net>
Wed, 21 Oct 2020 09:55:39 +0000 (06:55 -0300)
commitbdb6956afdd2fca610c3bac0834636835793a831
tree2c0c22d2f0406b52ef7ff56aaa90301ff9ec3d23
parent45193bab16c728ba892a5d45fc62ef59e2a6ef85
emacs docs: rstdoc.el: consistent single quote conversions

With text-quoting-style 'grave keeps "'" and "`" quotes unaltered
for further processing done by this code (regardless of locale...).
The tools that read the reStructuredText markup generated can do
their styling instead.

Added temporary conversions of ' and ` to \001 and \002 so that
's and `s outside of `...' and `...` are converted separately
('s restored back to ' and `s converted to \`).

Both `...' and `...` are finally "converted" to `...` (not ``...``).
https://docutils.sourceforge.io/docs/user/rst/quickref.html documents
that as `interpreted text`:

 "The rendering and meaning of interpreted text is domain- or
  application-dependent. It can be used for things like index
  entries or explicit descriptive markup (like program identifiers)."

Which looks pretty much right.
emacs/rstdoc.el