/src/

ut.texi' + +texi{pre,post}.dat these files will be put before and after the + result + +fix.sh calls emacs in order to update all the nodes and + menus. After this, makeinfo will convert the + texinfo-source to the info-file(s). Assumption: + the texi-source is called `@out.texi' + +fix.el the elisp-file executed by emacs. Two calls to + 'texinfo-all-menus-update are necessary in + some cases + +fix_hack executable shell script that fixes the results + of the underscore hack. {\ptt \char'137} is + back-translated to a simple underscore. This is + needed for the texindex program + +handy.el some handy Emacs-macro's that helped converting + ``old'' documentation to a format that could be + understood by the converter scipt (partparse.py). + (You don't really need this, but, as the name + says, these macros are "handy") + +A Million thanks for Jan-Hein B\"uhrman for writing and debugging the +convertor and related scripts, and for fixing the LaTeX sources and +writing new macros for myformat.sty! diff --git a/Doc/fix.el b/Doc/fix.el new file mode 100644 index 0000000..f25a935 --- /dev/null +++ b/Doc/fix.el @@ -0,0 +1,6 @@ +; load the new texinfo package (2.xx) if not installed by default +(setq load-path + (cons "/ufs/jh/lib/emacs/texinfo" load-path)) +(find-file "@out.texi") +(texinfo-all-menus-update t) +(texinfo-all-menus-update t) diff --git a/Doc/fix_hack b/Doc/fix_hack new file mode 100755 index 0000000..8c97729 --- /dev/null +++ b/Doc/fix_hack @@ -0,0 +1 @@ +sed -e 's/{\\ptt[ ]*\\char[ ]*'"'"'137}/_/g' <"$1" > "@$1" && mv "@$1" $1 diff --git a/Doc/info/texipost.dat b/Doc/info/texipost.dat new file mode 100644 index 0000000..7897e44 --- /dev/null +++ b/Doc/info/texipost.dat @@ -0,0 +1,23 @@ +@node Function Index, , , +@unnumbered Function Index + +@printindex fn + +@node Variable Index, , , +@unnumbered Variable Index + +@printindex vr + +@node Module Index, , , +@unnumbered Module Index + +@printindex pg + +@node Concept Index, , , +@unnumbered Concept Index + +@printindex cp + +@summarycontents +@contents +@bye diff --git a/Doc/info/texipre.dat b/Doc/info/texipre.dat new file mode 100644 index 0000000..b834f8b --- /dev/null +++ b/Doc/info/texipre.dat @@ -0,0 +1,93 @@ +\input texinfo @c -*-texinfo-*- +@c %**start of header +@setfilename python-lib.info +@settitle Python library reference +@setchapternewpage odd +@footnotestyle end +@c %**end of header + +@ifinfo +This file describes the built-in types, exceptions and functions and the +standard modules that come with the Python system. It assumes basic +knowledge about the Python language. For an informal introduction to +the language, see the Python Tutorial. The Python Reference Manual +gives a more formal definition of the language. (These manuals are not +yet available in INFO or Texinfo format.) + +Copyright (C) 1991, 1992 by Stichting Mathematisch Centrum, Amsterdam, +The Netherlands. + + All Rights Reserved + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation, and that the names of Stichting Mathematisch +Centrum or CWI not be used in advertising or publicity pertaining to +distribution of the software without specific, written prior permission. + +STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO +THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND +FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE +FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES +WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN +ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT +OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +@end ifinfo + +@titlepage +@title Python library reference +@author Guido van Rossum + +@c The following two commands start the copyright page. +@page +@vskip 0pt plus 1filll +Copyright @copyright{} 1991, 1992 by Stichting Mathematisch Centrum, +Amsterdam, The Netherlands. + +@center All Rights Reserved + +Permission to use, copy, modify, and distribute this software and its +documentation for any purpose and without fee is hereby granted, +provided that the above copyright notice appear in all copies and that +both that copyright notice and this permission notice appear in +supporting documentation, and that the names of Stichting Mathematisch +Centrum or CWI not be used in advertising or publicity pertaining to +distribution of the software without specific, written prior permission. + +STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO +THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND +FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE +FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES +WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN +ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT +OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +@end titlepage + + +@node Top, Overview, (dir), (dir) +@top The Python library + +@ifinfo +This file describes the built-in types, exceptions and functions and the +standard modules that come with the Python system. It assumes basic +knowledge about the Python language. For an informal introduction to +the language, see the @cite{Python Tutorial}. The @cite{Python +Reference Manual} gives a more formal definition of the language. +(These manuals are not yet available in INFO or Texinfo format.) + +This version corresponds roughly to Python version 0.9.8 (yet to be +released). + +@strong{Warning:} we have just finished converting the original LaTeX +manual into Texinfo. This is a difficult process and it is quite +possible that errors have been introduced in the conversion. Please +report any errors you find by e-mail to the author, +@t{Guido.van.Rossum@@cwi.nl}. + +@end ifinfo + +@c placeholder for the master menu -- patched by texinfo-all-menus-update +@menu +@end menu diff --git a/Doc/lib.tex b/Doc/lib.tex index 1bad16b..bb00ab3 100644 --- a/Doc/lib.tex +++ b/Doc/lib.tex @@ -1,4 +1,5 @@ \documentstyle[twoside,11pt,myformat]{report} +%\includeonly{lib5} \title{\bf Python Library Reference @@ -15,7 +16,8 @@ \makeindex \begin{document} - +%\showthe\fam +%\showthe\ttfam \pagenumbering{roman} \maketitle @@ -42,7 +44,6 @@ language. \pagebreak \pagenumbering{arabic} - \include{lib1} % intro; built-in types, functions and exceptions \include{lib2} % built-in modules \include{lib3} % standard modules diff --git a/Doc/lib/lib.tex b/Doc/lib/lib.tex index 1bad16b..bb00ab3 100644 --- a/Doc/lib/lib.tex +++ b/Doc/lib/lib.tex @@ -1,4 +1,5 @@ \documentstyle[twoside,11pt,myformat]{report} +%\includeonly{lib5} \title{\bf Python Library Reference @@ -15,7 +16,8 @@ \makeindex \begin{document} - +%\showthe\fam +%\showthe\ttfam \pagenumbering{roman} \maketitle @@ -42,7 +44,6 @@ language. \pagebreak \pagenumbering{arabic} - \include{lib1} % intro; built-in types, functions and exceptions \include{lib2} % built-in modules \include{lib3} % standard modules diff --git a/Doc/myformat.sty b/Doc/myformat.sty index 609ee81..398c2f3 100644 --- a/Doc/myformat.sty +++ b/Doc/myformat.sty @@ -13,7 +13,7 @@ \parskip = 2mm % Frequently used system name -\newcommand{\UNIX}{U{\sc nix}} +%\newcommand{\UNIX}{U{\sc nix}} % Variable used by begin code command \newlength{\codewidth} @@ -40,7 +40,9 @@ % Underscores are not magic throughout the Python documentation. % This still only gives the right effect in the tt font!!! -\catcode`_=12 +\def\_{\ifnum\fam=\ttfam \char'137\else{\tt\char'137}\fi} +\catcode`\_=12 +\catcode`\_=\active\def_{\ifnum\fam=\ttfam \char'137 \else{\tt\char'137}\fi} % Define \itembreak: force the text after an item to start on a new line \newcommand{\itembreak}{ @@ -94,22 +96,104 @@ } % Define \funcitem{func}{args}: define a function item -\newcommand{\funcitem}[2]{ -\ttindex{#1} -\item[{\tt #1(#2)}] +\newcommand{\funcitem}[2]{% +\ttindex{#1}% +%\item[{\tt #1(#2)}] +\item[\code{#1(\varvars{#2})}]