small visual cleanup (with horrible input :-)) after fixes by kb

base/doc/ltnews40.tex

@@ -288,19 +288,19 @@ \subsection{Improved table tagging}
 The interface to this functionality is not finalized but can be
 accessed in the current release by specifying the row and columns to
 be treated as headers. For example
-
+%
 \begin{verbatim}
-\tagpdfsetup{
- table/header-rows={1,2},
- table/header-columns={1} }
+  \tagpdfsetup{
+   table/header-rows={1,2},
+   table/header-columns={1} }
 \end{verbatim}
 would specify that in the following tables the first two rows and
 first column of each row should be tagged as heading entries.
 
 Similarly you may add a RowSpan attributes to tag a cell that spans
 two rows using:
 \begin{verbatim}
-\tagpdfsetup{table/multirow={2}}
+  \tagpdfsetup{table/multirow={2}}
 \end{verbatim}
 
 
@@ -352,9 +352,9 @@ \subsection{Handling paragraph continuation}
 approach failed, e.g., with
 \begin{flushleft}
   \ttfamily
-\{\meta{local customizations}\\
-\cs{begin}\{equation\} a<b \cs{end}\{equation\}\} \\
-\meta{some text}
+\ \ \{\meta{local customizations}\\
+\ \ \cs{begin}\{equation\} a<b \cs{end}\{equation\}\} \\
+\ \ \meta{some text}
 \end{flushleft}
 the \meta{some text} incorrectly started a new paragraph.  Bug reports
 about this behavior can be traced back to the time \LaTeXe{} was
@@ -392,7 +392,10 @@ \subsection{Avoid bogus \enquote{no item} error}
 \githubissue{1460}
 
 
-\subsection{Switch to T1 as default encoding in documents using \cs{DocumentMetadata}}
+\subsection[Switch to T1 as default encoding in documents
+  using \cs{DocumentMetadata}]
+           {Switch to T1 as default encoding in documents\\\mbox\qquad
+  using \cs{DocumentMetadata}}
 
 As it is well known, the font encoding \texttt{OT1} supports only 128
 characters and has various problems and quirks notably for languages
@@ -416,7 +419,8 @@ \subsection{Switch to T1 as default encoding in documents using \cs{DocumentMeta
 
 \section{Code improvements}
 
-\subsection{Avoiding keyval option clashes between classes and packages}
+\subsection[Avoiding key--value option clashes between classes and packages]
+           {Avoiding key--value option clashes between classes\\\mbox\qquad and packages}
 
 In \LaTeX{} News~35~\cite{40:ltnews35} we introduced key--value option
 processing to the kernel. Following the standard for \LaTeXe{}
@@ -435,11 +439,11 @@ \subsection{Avoiding keyval option clashes between classes and packages}
 has been added. This can then be set to indicate that this key is not
 to be skipped. For example
 \begin{verbatim}
-\DeclareKeys{
-  draft .if = {ifl@cls@draft},
-  draft .pass-to-packages = true,
-  mode  .store = \cls@mode
-}
+  \DeclareKeys{
+    draft .if = {ifl@cls@draft},
+    draft .pass-to-packages = true,
+    mode  .store = \cls@mode
+  }
 \end{verbatim}
 in a class would create two options, \texttt{draft} and
 \texttt{mode}. The \texttt{draft} option will be treated in the normal
@@ -524,10 +528,11 @@ \subsection*{Fix existence check of document environments}
 trimming. Thus when the user-specified \meta{envname} consists of
 leading and/or trailing space(s), it may lead to erroneously silent
 environment declaration.  For example, in
-\begin{verbatim}
-  \NewDocumentEnvironment{myenv}{}{begin}{end}
-  \NewDocumentEnvironment{ myenv }{}{begin}{end}
-\end{verbatim}
+\begin{flushleft}
+\ttfamily
+\ \ \verb=\NewDocumentEnvironment{myenv}{}{begin}{end}=\\
+\ \ \verb*=\NewDocumentEnvironment{ myenv }{}{begin}{end}=\kern-1cm
+\end{flushleft}
 the first line defines a new environment \env{myenv} but the second
 line would check existence for \verb*| myenv | (which is not yet
 defined), then redefine \env{myenv} environment without raising any
@@ -554,7 +559,7 @@ \subsection{File list entries for rolled back packages/classes}
 not recorded in the file list used by \cs{listfiles}.  This has now
 been corrected so that the extended usage~\cite{40:ltnews39}
 \begin{verbatim}
-\listfiles[hashes,sizes]
+  \listfiles[hashes,sizes]
 \end{verbatim}
 now gives more complete and less confusing info.
 %
@@ -680,9 +685,9 @@ \subsection{\pkg{longtable}:\ Extend caption type}
 counter. This makes it easy to define an unnumbered variant of
 longtable:
 \begin{verbatim}
-\newenvironment{longtable*}
-  {\renewcommand\LTcaptype{}\longtable}
-  {\endlongtable}
+  \newenvironment{longtable*}
+    {\renewcommand\LTcaptype{}\longtable}
+    {\endlongtable}
 \end{verbatim}
 
 \subsection{\pkg{longtable}:\ Prevent \cs{pagegoal} exceeding maximum value}