[latex3-commits] [git/LaTeX3-latex3-latex2e] gh953: some docu for #953 (456ea8c2)

[Frank Mittelbach]

Repository : https://github.com/latex3/latex2e
On branch  : gh953
Link       : https://github.com/latex3/latex2e/commit/456ea8c27dc0f5059b807377745e63c271ac7197

>---------------------------------------------------------------

commit 456ea8c27dc0f5059b807377745e63c271ac7197
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Mon Nov 14 10:17:58 2022 +0100

    some docu for #953


>---------------------------------------------------------------

456ea8c27dc0f5059b807377745e63c271ac7197
 base/doc/ltnews37.tex | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/base/doc/ltnews37.tex b/base/doc/ltnews37.tex
index 827a8f2e..094796dd 100644
--- a/base/doc/ltnews37.tex
+++ b/base/doc/ltnews37.tex
@@ -159,6 +159,41 @@
 \githubissue{943}
 
 
+\subsection{\pkg{doc}: Support the \pkg{upquote} package}
+
+The default quote and backquote characters in typewriter fonts are
+typographical quotes, e.g., the input
+\begin{verbatim}
+   verb*/`prog 'my input'`/
+\end{verbatim}
+ is rendered as \verb*/`prog 'my input'`/ and not as
+%
+\begingroup              % code to mimic upquote.sty
+\catcode`'=\active
+\catcode``=\active
+\makeatletter
+\g at addto@macro\@noligs
+   {\let'\textquotesingle
+    \let`\textasciigrave
+    \ifx\encodingdefault\upquote at OTone
+    \ifx\ttdefault\upquote at cmtt
+    \def'{\char13 }%
+    \def`{\char18 }%
+    \fi\fi}
+\endgroup
+%
+\verb*/`prog 'my input'`/ as preferred by many programmers.
+
+This can be adjusted, for example, with the \pkg{upquote} package,
+which results in the second output. However, for historical reasons
+\pkg{doc} had its own definition of \cs{verb} and \env{verbatim} and
+as a consequence the two packages did not cooperate.  This has now
+been fixed and loading \pkg{upquote} together with \pkg{doc} has the
+desired effect.
+%
+\githubissue{953}
+
+
 \subsection{A further hook for shipping out pages}
 
 Since October 2020 the shipout process offers a number of hooks to