Removed an obsolete hack that's been commented out for a long time.
Added comments to various sections.
diff --git a/Doc/texinputs/python.sty b/Doc/texinputs/python.sty
index ad3e4a7..009caaf 100644
--- a/Doc/texinputs/python.sty
+++ b/Doc/texinputs/python.sty
@@ -228,16 +228,6 @@
}
\expandafter\endgroup\next
-%
-% This is the old hack, which didn't work with 2e.
-% You should not need this since the rest of the documentation is now
-% LaTeX2e-only.
-%
-%\def\_{\ifnum\fam=\ttfamily \char'137\else{\tt\char'137}\fi}
-%\catcode`\_=12
-%\catcode`\_=\active\def_{\ifnum\fam=\ttfamily \char'137 \else{\tt\char'137}\fi}
-
-
%% Lots of index-entry generation support.
@@ -328,6 +318,12 @@
\endgroup%
}
+
+% Now for a lot of semantically-loaded environments that do a ton of magical
+% things to get the right formatting and index entries for the stuff in
+% Python modules and C API.
+
+
% {fulllineitems} is used in one place in libregex.tex, but is really for
% internal use in this file.
%
@@ -499,6 +495,8 @@
\newcommand{\EOF}{{\sc eof}}
\newcommand{\NULL}{\sectcode{NULL}}
+% Also for consistency: spell Python "Python", not "python"!
+
% code is the most difficult one...
\newcommand{\code}[1]{{\@vobeyspaces\@noligs\def\{{\char`\{}\def\}{\char`\}}\def\~{\char`\~}\def\^{\char`\^}\def\e{\char`\\}\def\${\char`\$}\def\#{\char`\#}\def\&{\char`\&}\def\%{\char`\%}%
\mbox{\codefont{#1}}}}
@@ -554,6 +552,8 @@
\let\member=\sectcode
\let\method=\sectcode
+\newcommand{\pytype}[1]{#1} % built-in Python type
+
\let\cfunction=\sectcode
\let\ctype=\sectcode
\let\cdata=\sectcode