Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Open
cfr42 opened this issue Jul 27, 2024 · 2 comments

Comments

@cfr42
Copy link
Contributor

cfr42 commented Jul 27, 2024

% \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
@cfr42 cfr42 changed the title doc documentation bug: 'symbolic' name for \levelchar in \index{} example on page 11 produces garbled entry doc documentation (bug?): 'symbolic' name for \levelchar in \index{} example on page 11 produces garbled entry Jul 27, 2024
@muzimuzhi
Copy link
Contributor

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}

Copy link

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

4 participants