1998-03-03 18:02:19 -04:00
|
|
|
\documentclass{manual}
|
* ext.tex: documentation for extending, reference counts, and embedding
(formerly ../misc/{EXTENDING,REFCNT,EMBEDDING}). Also affects Makefile.
* text2latex.py: script to do part of the conversion from an plain ASCI
text file (in my particular style) to LaTeX.
(Chapter/section/subsection headers, and verbatim sections.)
* partparse.py, texipre.dat, fix.el, Makefile: Minor cleanup of latex ->
info conversion process (at least it works again, and with less
debugging output). Removed fix.sh.
* lib1.tex (section{Built-in Functions}): adapt description of str() and
repr() to new situation.
* lib3.tex (Module os): added exec*() variants.
* lib3.tex (Module posix): added execve().
* lib2.tex (Module array): documented reality; remove typecode and
itemsize, add byteswap, rename read/write to fromfile/tofile, and
re-alphabetized.
* lib1.tex (Built-in Functions): renamed bagof() to filter().
1993-11-05 10:45:11 -04:00
|
|
|
|
1998-12-23 01:02:08 -04:00
|
|
|
% XXX PM explain how to add new types to Python
|
1995-03-13 12:55:23 -04:00
|
|
|
|
1994-08-01 09:22:53 -03:00
|
|
|
\title{Extending and Embedding the Python Interpreter}
|
* ext.tex: documentation for extending, reference counts, and embedding
(formerly ../misc/{EXTENDING,REFCNT,EMBEDDING}). Also affects Makefile.
* text2latex.py: script to do part of the conversion from an plain ASCI
text file (in my particular style) to LaTeX.
(Chapter/section/subsection headers, and verbatim sections.)
* partparse.py, texipre.dat, fix.el, Makefile: Minor cleanup of latex ->
info conversion process (at least it works again, and with less
debugging output). Removed fix.sh.
* lib1.tex (section{Built-in Functions}): adapt description of str() and
repr() to new situation.
* lib3.tex (Module os): added exec*() variants.
* lib3.tex (Module posix): added execve().
* lib2.tex (Module array): documented reality; remove typecode and
itemsize, add byteswap, rename read/write to fromfile/tofile, and
re-alphabetized.
* lib1.tex (Built-in Functions): renamed bagof() to filter().
1993-11-05 10:45:11 -04:00
|
|
|
|
1994-10-06 07:29:26 -03:00
|
|
|
\input{boilerplate}
|
1993-11-23 12:28:45 -04:00
|
|
|
|
* ext.tex: documentation for extending, reference counts, and embedding
(formerly ../misc/{EXTENDING,REFCNT,EMBEDDING}). Also affects Makefile.
* text2latex.py: script to do part of the conversion from an plain ASCI
text file (in my particular style) to LaTeX.
(Chapter/section/subsection headers, and verbatim sections.)
* partparse.py, texipre.dat, fix.el, Makefile: Minor cleanup of latex ->
info conversion process (at least it works again, and with less
debugging output). Removed fix.sh.
* lib1.tex (section{Built-in Functions}): adapt description of str() and
repr() to new situation.
* lib3.tex (Module os): added exec*() variants.
* lib3.tex (Module posix): added execve().
* lib2.tex (Module array): documented reality; remove typecode and
itemsize, add byteswap, rename read/write to fromfile/tofile, and
re-alphabetized.
* lib1.tex (Built-in Functions): renamed bagof() to filter().
1993-11-05 10:45:11 -04:00
|
|
|
% Tell \index to actually write the .idx file
|
|
|
|
\makeindex
|
|
|
|
|
|
|
|
\begin{document}
|
|
|
|
|
|
|
|
\maketitle
|
|
|
|
|
1998-07-28 18:55:19 -03:00
|
|
|
\ifhtml
|
|
|
|
\chapter*{Front Matter\label{front}}
|
|
|
|
\fi
|
|
|
|
|
1994-10-06 07:29:26 -03:00
|
|
|
\input{copyright}
|
|
|
|
|
1999-02-16 19:06:32 -04:00
|
|
|
|
* ext.tex: documentation for extending, reference counts, and embedding
(formerly ../misc/{EXTENDING,REFCNT,EMBEDDING}). Also affects Makefile.
* text2latex.py: script to do part of the conversion from an plain ASCI
text file (in my particular style) to LaTeX.
(Chapter/section/subsection headers, and verbatim sections.)
* partparse.py, texipre.dat, fix.el, Makefile: Minor cleanup of latex ->
info conversion process (at least it works again, and with less
debugging output). Removed fix.sh.
* lib1.tex (section{Built-in Functions}): adapt description of str() and
repr() to new situation.
* lib3.tex (Module os): added exec*() variants.
* lib3.tex (Module posix): added execve().
* lib2.tex (Module array): documented reality; remove typecode and
itemsize, add byteswap, rename read/write to fromfile/tofile, and
re-alphabetized.
* lib1.tex (Built-in Functions): renamed bagof() to filter().
1993-11-05 10:45:11 -04:00
|
|
|
\begin{abstract}
|
|
|
|
|
|
|
|
\noindent
|
1995-03-20 10:24:09 -04:00
|
|
|
Python is an interpreted, object-oriented programming language. This
|
1999-02-15 12:20:25 -04:00
|
|
|
document describes how to write modules in C or \Cpp{} to extend the
|
1995-03-20 10:24:09 -04:00
|
|
|
Python interpreter with new modules. Those modules can define new
|
|
|
|
functions but also new object types and their methods. The document
|
|
|
|
also describes how to embed the Python interpreter in another
|
|
|
|
application, for use as an extension language. Finally, it shows how
|
|
|
|
to compile and link extension modules so that they can be loaded
|
|
|
|
dynamically (at run time) into the interpreter, if the underlying
|
|
|
|
operating system supports this feature.
|
|
|
|
|
|
|
|
This document assumes basic knowledge about Python. For an informal
|
1999-11-10 12:01:43 -04:00
|
|
|
introduction to the language, see the
|
|
|
|
\citetitle[../tut/tut.html]{Python Tutorial}. The
|
|
|
|
\citetitle[../ref/ref.html]{Python Reference Manual} gives a more
|
|
|
|
formal definition of the language. The
|
|
|
|
\citetitle[../lib/lib.html]{Python Library Reference} documents the
|
|
|
|
existing object types, functions and modules (both built-in and
|
|
|
|
written in Python) that give the language its wide application range.
|
* ext.tex: documentation for extending, reference counts, and embedding
(formerly ../misc/{EXTENDING,REFCNT,EMBEDDING}). Also affects Makefile.
* text2latex.py: script to do part of the conversion from an plain ASCI
text file (in my particular style) to LaTeX.
(Chapter/section/subsection headers, and verbatim sections.)
* partparse.py, texipre.dat, fix.el, Makefile: Minor cleanup of latex ->
info conversion process (at least it works again, and with less
debugging output). Removed fix.sh.
* lib1.tex (section{Built-in Functions}): adapt description of str() and
repr() to new situation.
* lib3.tex (Module os): added exec*() variants.
* lib3.tex (Module posix): added execve().
* lib2.tex (Module array): documented reality; remove typecode and
itemsize, add byteswap, rename read/write to fromfile/tofile, and
re-alphabetized.
* lib1.tex (Built-in Functions): renamed bagof() to filter().
1993-11-05 10:45:11 -04:00
|
|
|
|
1999-02-15 12:20:25 -04:00
|
|
|
For a detailed description of the whole Python/C API, see the separate
|
1999-11-10 12:01:43 -04:00
|
|
|
\citetitle[../api/api.html]{Python/C API Reference Manual}.
|
1997-10-07 11:40:16 -03:00
|
|
|
|
* ext.tex: documentation for extending, reference counts, and embedding
(formerly ../misc/{EXTENDING,REFCNT,EMBEDDING}). Also affects Makefile.
* text2latex.py: script to do part of the conversion from an plain ASCI
text file (in my particular style) to LaTeX.
(Chapter/section/subsection headers, and verbatim sections.)
* partparse.py, texipre.dat, fix.el, Makefile: Minor cleanup of latex ->
info conversion process (at least it works again, and with less
debugging output). Removed fix.sh.
* lib1.tex (section{Built-in Functions}): adapt description of str() and
repr() to new situation.
* lib3.tex (Module os): added exec*() variants.
* lib3.tex (Module posix): added execve().
* lib2.tex (Module array): documented reality; remove typecode and
itemsize, add byteswap, rename read/write to fromfile/tofile, and
re-alphabetized.
* lib1.tex (Built-in Functions): renamed bagof() to filter().
1993-11-05 10:45:11 -04:00
|
|
|
\end{abstract}
|
|
|
|
|
1998-01-13 18:25:02 -04:00
|
|
|
\tableofcontents
|
* ext.tex: documentation for extending, reference counts, and embedding
(formerly ../misc/{EXTENDING,REFCNT,EMBEDDING}). Also affects Makefile.
* text2latex.py: script to do part of the conversion from an plain ASCI
text file (in my particular style) to LaTeX.
(Chapter/section/subsection headers, and verbatim sections.)
* partparse.py, texipre.dat, fix.el, Makefile: Minor cleanup of latex ->
info conversion process (at least it works again, and with less
debugging output). Removed fix.sh.
* lib1.tex (section{Built-in Functions}): adapt description of str() and
repr() to new situation.
* lib3.tex (Module os): added exec*() variants.
* lib3.tex (Module posix): added execve().
* lib2.tex (Module array): documented reality; remove typecode and
itemsize, add byteswap, rename read/write to fromfile/tofile, and
re-alphabetized.
* lib1.tex (Built-in Functions): renamed bagof() to filter().
1993-11-05 10:45:11 -04:00
|
|
|
|
1993-11-05 13:11:16 -04:00
|
|
|
|
2001-08-20 16:30:29 -03:00
|
|
|
\input{extending}
|
|
|
|
\input{newtypes}
|
2002-03-09 06:06:14 -04:00
|
|
|
\input{building}
|
2001-08-20 16:30:29 -03:00
|
|
|
\input{windows}
|
|
|
|
\input{embedding}
|
2000-09-08 19:54:53 -03:00
|
|
|
|
2000-09-21 18:35:22 -03:00
|
|
|
|
|
|
|
\appendix
|
|
|
|
\chapter{Reporting Bugs}
|
|
|
|
\input{reportingbugs}
|
|
|
|
|
2001-06-20 18:37:34 -03:00
|
|
|
\chapter{History and License}
|
|
|
|
\input{license}
|
|
|
|
|
* ext.tex: documentation for extending, reference counts, and embedding
(formerly ../misc/{EXTENDING,REFCNT,EMBEDDING}). Also affects Makefile.
* text2latex.py: script to do part of the conversion from an plain ASCI
text file (in my particular style) to LaTeX.
(Chapter/section/subsection headers, and verbatim sections.)
* partparse.py, texipre.dat, fix.el, Makefile: Minor cleanup of latex ->
info conversion process (at least it works again, and with less
debugging output). Removed fix.sh.
* lib1.tex (section{Built-in Functions}): adapt description of str() and
repr() to new situation.
* lib3.tex (Module os): added exec*() variants.
* lib3.tex (Module posix): added execve().
* lib2.tex (Module array): documented reality; remove typecode and
itemsize, add byteswap, rename read/write to fromfile/tofile, and
re-alphabetized.
* lib1.tex (Built-in Functions): renamed bagof() to filter().
1993-11-05 10:45:11 -04:00
|
|
|
\end{document}
|