doc documentation (bug?): 'symbolic' name for \levelchar in \index{} example on page 11 produces garbled entry

[cfr42]

latex2e/base/doc.dtx

Line 977 in 22375e7

% \index{index entries\levelchar Special macros for \*}

gives as an example

\index{index entries\levelchar Special macros for \*}

but \levelchar can't work here as it results in

\indexentry{index entries\levelchar Special macros for \*}{1}

in the idx and

\item index entries\levelchar Special macros for \*\pfill 1

in the ind which results in a garbled entry.

% \iffalse
%<*driver>
\ProvidesFile{exp.dtx}[2024-07-26 v0.0]
\documentclass{ltxdoc}
\usepackage{exp}
\EnableCrossrefs
\CodelineIndex
\begin{document}
  \DocInput{exp.dtx}
\end{document}
%</driver>
% \fi
%
% Example\index{index entries\levelchar Special macros for \*}
%
% \MaybeStop{%
% \PrintIndex
% }
%
%\Finale

[muzimuzhi]

Also found a line of rollback comment is leaked into doc.pdf (v3.0p, 2024/04/26) thus takes up its first page.

diff --git a/base/doc.dtx b/base/doc.dtx
index 4cb8dd6b..3af0fa37 100644
--- a/base/doc.dtx
+++ b/base/doc.dtx
@@ -34,7 +34,7 @@
 %\catcode`\<=14
 %<+package|shortvrb>\NeedsTeXFormat{LaTeX2e}[1994/12/01]
 %<+package>
-% Any rollback request before 2016-02-15 we try to fulfill with the 2016 version:
+% ^^A Any rollback request before 2016-02-15 we try to fulfill with the 2016 version:
 %<+package>\DeclareRelease{}{1994-06-01}
 %<+package>                      {doc-2016-02-15.sty}
 %<+package>\DeclareRelease{v2.1g}{2016-02-15}

[github-actions]

This issue has been automatically marked as stale because it has not had recent activity.

[github-actions]

This issue has been automatically marked as stale because it has not had recent activity.

[FrankMittelbach]

ah put it in the wrong branch (but too lazy to undo all that) --- that branch will be merge soon as well