mirror of
https://github.com/python/cpython.git
synced 2025-11-02 14:41:33 +00:00
a610f9f8c1
the libdis.tex file I'm about to check in. I'm not sure this is really an optimal solution yet, but it may be the best alternative. It avoids describing the instructions as either data items or functions. This change was discussed with Guido. (Guido: Take a look at the LaTeX output for this; if this is reasonable I'll go ahead and update the perl code in myformat.perl to match.)
234 lines
6.8 KiB
TeX
234 lines
6.8 KiB
TeX
%
|
|
% myformat.sty for the Python doc [updated to work with Latex2e]
|
|
%
|
|
|
|
% Increase printable page size (copied from fullpage.sty)
|
|
\topmargin 0pt
|
|
\advance \topmargin by -\headheight
|
|
\advance \topmargin by -\headsep
|
|
|
|
\textheight 8.9in
|
|
|
|
\oddsidemargin 0pt
|
|
\evensidemargin \oddsidemargin
|
|
\marginparwidth 0.5in
|
|
|
|
\textwidth 6.5in
|
|
|
|
% Style parameters and macros used by most documents here
|
|
\raggedbottom
|
|
\sloppy
|
|
\parindent = 0mm
|
|
\parskip = 2mm
|
|
|
|
% Variable used by begin code command
|
|
\newlength{\codewidth}
|
|
|
|
% Command to start a code block (follow this by \begin{verbatim})
|
|
\newcommand{\bcode}{
|
|
% Calculate the text width for the minipage:
|
|
\setlength{\codewidth}{\linewidth}
|
|
\addtolength{\codewidth}{-\parindent}
|
|
%
|
|
\par
|
|
\vspace{3mm}
|
|
\indent
|
|
\begin{minipage}[t]{\codewidth}
|
|
}
|
|
|
|
% Command to end a code block (precede this by \end{verbatim})
|
|
\newcommand{\ecode}{
|
|
\end{minipage}
|
|
\vspace{3mm}
|
|
\par
|
|
\noindent
|
|
}
|
|
|
|
% Underscore hack (only act like subscript operator if in math mode)
|
|
%
|
|
% The following is due to Mark Wooding (the old version didn't work with
|
|
% Latex 2e.
|
|
|
|
\DeclareRobustCommand\hackscore{%
|
|
\ifmmode_\else\textunderscore\fi%
|
|
}
|
|
\begingroup
|
|
\catcode`\_\active
|
|
\def\next{%
|
|
\AtBeginDocument{\catcode`\_\active\def_{\hackscore{}}}%
|
|
}
|
|
\expandafter\endgroup\next
|
|
|
|
%
|
|
% This is the old hack, which didn't work with 2e.
|
|
% If you're still using Latex 2.09, you can give it a try if the above fails.
|
|
%
|
|
%\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}
|
|
|
|
% Define \itembreak: force the text after an item to start on a new line
|
|
\newcommand{\itembreak}{
|
|
\mbox{}
|
|
\\*[0mm]
|
|
}
|
|
|
|
% Command to generate two index entries (using subentries)
|
|
\newcommand{\indexii}[2]{\index{#1!#2}\index{#2!#1}}
|
|
|
|
% And three entries (using only one level of subentries)
|
|
\newcommand{\indexiii}[3]{\index{#1!#2 #3}\index{#2!#3, #1}\index{#3!#1 #2}}
|
|
|
|
% And four (again, using only one level of subentries)
|
|
\newcommand{\indexiv}[4]{
|
|
\index{#1!#2 #3 #4}
|
|
\index{#2!#3 #4, #1}
|
|
\index{#3!#4, #1 #2}
|
|
\index{#4!#1 #2 #3}
|
|
}
|
|
|
|
% Command to generate a reference to a function, statement, keyword, operator
|
|
\newcommand{\stindex}[1]{\indexii{statement}{#1@{\tt#1}}}
|
|
\newcommand{\kwindex}[1]{\indexii{keyword}{#1@{\tt#1}}}
|
|
\newcommand{\opindex}[1]{\indexii{operator}{#1@{\tt#1}}}
|
|
\newcommand{\exindex}[1]{\indexii{exception}{#1@{\tt#1}}}
|
|
\newcommand{\obindex}[1]{\indexii{object}{#1}}
|
|
\newcommand{\bifuncindex}[1]{\index{#1@{\tt#1} (built-in function)}}
|
|
|
|
% Add an index entry for a module
|
|
\newcommand{\modindex}[2]{\index{#1@{\tt#1} (#2module)}}
|
|
\newcommand{\bimodindex}[1]{\modindex{#1}{built-in }}
|
|
\newcommand{\stmodindex}[1]{\modindex{#1}{standard }}
|
|
|
|
% Additional string for an index entry
|
|
\newcommand{\indexsubitem}{}
|
|
\newcommand{\ttindex}[1]{\index{#1@{\tt#1} \indexsubitem}}
|
|
|
|
% Define \itemjoin: some negative vspace to join two items together
|
|
\newcommand{\itemjoin}{
|
|
\mbox{}
|
|
\vspace{-\itemsep}
|
|
\vspace{-\parsep}
|
|
}
|
|
|
|
% Define \funcitem{func}{args}: define a function item
|
|
\newcommand{\funcitem}[2]{%
|
|
\ttindex{#1}%
|
|
\item[\code{#1(\varvars{#2})}]
|
|
\
|
|
}
|
|
|
|
|
|
% from user-level, fulllineitems should be called as an environment
|
|
\def\fulllineitems{\list{}{\labelwidth \leftmargin \labelsep 0pt
|
|
\rightmargin 0pt \topsep -\parskip \partopsep \parskip
|
|
\itemsep -\parsep
|
|
\let\makelabel\itemnewline}}
|
|
\let\endfulllineitems\endlist
|
|
|
|
|
|
% cfuncdesc should be called as
|
|
% \begin{cfuncdesc}{type}{name}{arglist}
|
|
% ... description ...
|
|
% \end{cfuncdesc}
|
|
\newcommand{\cfuncline}[3]{\item[\code{#1 #2(\varvars{#3})}]\ttindex{#2}}
|
|
\newcommand{\cfuncdesc}[3]{\fulllineitems\cfuncline{#1}{#2}{#3}}
|
|
\let\endcfuncdesc\endfulllineitems
|
|
|
|
\newcommand{\cvarline}[2]{\item[\code{#1 #2}]\ttindex{#2}}
|
|
\newcommand{\cvardesc}[2]{\fulllineitems\cvarline{#1}{#2}}
|
|
\let\endcvardesc\endfulllineitems
|
|
|
|
\newcommand{\ctypeline}[1]{\item[\code{#1}]\ttindex{#1}}
|
|
\newcommand{\ctypedesc}[1]{\fulllineitems\ctypeline{#1}}
|
|
\let\endctypedesc\endfulllineitems
|
|
|
|
% funcdesc should be called as an \begin{funcdesc} ... \end{funcdesc}
|
|
\newcommand{\funcline}[2]{\item[\code{#1(\varvars{#2})}]\ttindex{#1}}
|
|
\newcommand{\funcdesc}[2]{\fulllineitems\funcline{#1}{#2}}
|
|
\let\endfuncdesc\endfulllineitems
|
|
\newcommand{\optional}[1]{{\ \Large[}{#1}\hspace{0.5mm}{\Large]}\ }
|
|
|
|
|
|
% same for excdesc
|
|
\newcommand{\excline}[1]{\item[\code{#1}]\ttindex{#1}}
|
|
\newcommand{\excdesc}[1]{\fulllineitems\excline{#1}}
|
|
\let\endexcdesc\endfulllineitems
|
|
|
|
% same for datadesc
|
|
\newcommand{\dataline}[1]{\item[\code{#1}]\ttindex{#1}}
|
|
\newcommand{\datadesc}[1]{\fulllineitems\dataline{#1}}
|
|
\let\enddatadesc\endfulllineitems
|
|
|
|
|
|
% opcodedesc should be called as an \begin{opcodedesc} ... \end{opcodedesc}
|
|
\newcommand{\opcodeline}[2]{\item[\code{#1\quad\varvars{#2}}]\ttindex{#1}}
|
|
\newcommand{\opcodedesc}[2]{\fulllineitems\opcodeline{#1}{#2}}
|
|
\let\endopcodedesc\endfulllineitems
|
|
|
|
|
|
% Define \dataitem{name}: define a data item
|
|
\newcommand{\dataitem}[1]{%
|
|
\ttindex{#1}%
|
|
\item[{\tt #1}]
|
|
\
|
|
}
|
|
|
|
% Define \excitem{name}: define an exception item
|
|
\newcommand{\excitem}[1]{%
|
|
\ttindex{#1}%
|
|
\item[{\tt #1}]
|
|
\itembreak
|
|
}
|
|
|
|
\let\nodename=\label
|
|
|
|
%% For these commands, use \command{} to get the typography right, not
|
|
%% {\command}. This works better with the texinfo translation.
|
|
\newcommand{\ABC}{{\sc abc}}
|
|
\newcommand{\UNIX}{{\sc Unix}}
|
|
\newcommand{\ASCII}{{\sc ascii}}
|
|
\newcommand{\Cpp}{C\protect\raisebox{.18ex}{++}}
|
|
\newcommand{\C}{C}
|
|
\newcommand{\EOF}{{\sc eof}}
|
|
\newcommand{\NULL}{\code{NULL}}
|
|
|
|
% 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{\tt #1}}}
|
|
|
|
\newcommand{\kbd}[1]{\mbox{\tt #1}}
|
|
\newcommand{\key}[1]{\mbox{\tt #1}}
|
|
\newcommand{\samp}[1]{\mbox{`\code{#1}'}}
|
|
\newcommand{\var}[1]{\mbox{\it#1\/}}
|
|
\let\file=\samp
|
|
\newcommand{\dfn}[1]{{\em #1\/}}
|
|
\renewcommand{\emph}[1]{{\em #1\/}}
|
|
\newcommand{\strong}[1]{{\bf #1}}
|
|
|
|
\newcommand{\varvars}[1]{{\def\,{\/{\char`\,}}\var{#1}}}
|
|
|
|
\newif\iftexi\texifalse
|
|
\newif\iflatex\latextrue
|
|
|
|
\newenvironment{tableii}[4]{\begin{center}\def\lineii##1##2{\csname#2\endcsname{##1}&##2\\}\begin{tabular}{#1}\hline#3\\
|
|
\hline}{\hline\end{tabular}\end{center}}
|
|
|
|
\newenvironment{tableiii}[5]{\begin{center}\def\lineiii##1##2##3{\csname#2\endcsname{##1}&##2&##3\\}\begin{tabular}{#1}\hline#3\\
|
|
\hline}{\hline\end{tabular}\end{center}}
|
|
|
|
\newcommand{\itemnewline}[1]{\@tempdima\linewidth
|
|
\advance\@tempdima \leftmargin\makebox[\@tempdima][l]{#1}}
|
|
|
|
\newcommand{\sectcode}[1]{{\tt #1}}
|
|
|
|
% Cross-referencing (AMK)
|
|
% Sample usage:
|
|
% \begin{seealso}
|
|
% \seemodule{rand}{Uniform random number generator}; % Module xref
|
|
% \seetext{{\em Encyclopedia Britannica}}. % Ref to a book
|
|
% \end{seealso}
|
|
|
|
\newenvironment{seealso}[0]{{\bf See Also: }}{\par}
|
|
\newcommand{\seemodule}[2]{\ref{module-#1}: {\tt #1} (#2)}
|
|
\newcommand{\seetext}[1]{\par{#1}}
|