1998-03-03 22:02:19 +00:00
|
|
|
\documentclass{manual}
|
1997-05-15 21:43:21 +00:00
|
|
|
|
1997-10-07 14:38:54 +00:00
|
|
|
\title{Python/C API Reference Manual}
|
1997-05-15 21:43:21 +00:00
|
|
|
|
|
|
|
\input{boilerplate}
|
|
|
|
|
2001-01-17 18:04:31 +00:00
|
|
|
\makeindex % tell \index to actually write the .idx file
|
1997-05-15 21:43:21 +00:00
|
|
|
|
|
|
|
|
|
|
|
\begin{document}
|
|
|
|
|
|
|
|
\maketitle
|
|
|
|
|
1998-07-28 21:55:19 +00:00
|
|
|
\ifhtml
|
|
|
|
\chapter*{Front Matter\label{front}}
|
|
|
|
\fi
|
|
|
|
|
1997-05-15 21:43:21 +00:00
|
|
|
\input{copyright}
|
|
|
|
|
|
|
|
\begin{abstract}
|
|
|
|
|
|
|
|
\noindent
|
2000-04-03 15:42:13 +00:00
|
|
|
This manual documents the API used by C and \Cpp{} programmers who
|
1998-02-16 06:15:35 +00:00
|
|
|
want to write extension modules or embed Python. It is a companion to
|
1999-11-09 17:03:03 +00:00
|
|
|
\citetitle[../ext/ext.html]{Extending and Embedding the Python
|
|
|
|
Interpreter}, which describes the general principles of extension
|
|
|
|
writing but does not document the API functions in detail.
|
1997-05-15 21:43:21 +00:00
|
|
|
|
2001-10-12 19:01:43 +00:00
|
|
|
\warning{The current version of this document is incomplete. I hope
|
|
|
|
that it is nevertheless useful. I will continue to work on it, and
|
|
|
|
release new versions from time to time, independent from Python source
|
|
|
|
code releases.}
|
1997-12-30 04:38:44 +00:00
|
|
|
|
1997-05-15 21:43:21 +00:00
|
|
|
\end{abstract}
|
|
|
|
|
1998-01-13 22:25:02 +00:00
|
|
|
\tableofcontents
|
1997-05-15 21:43:21 +00:00
|
|
|
|
|
|
|
|
2001-10-12 19:01:43 +00:00
|
|
|
\input{intro}
|
|
|
|
\input{veryhigh}
|
|
|
|
\input{refcounting}
|
|
|
|
\input{exceptions}
|
|
|
|
\input{utilities}
|
|
|
|
\input{abstract}
|
|
|
|
\input{concrete}
|
|
|
|
\input{init}
|
|
|
|
\input{memory}
|
|
|
|
\input{newtypes}
|
2001-03-22 16:30:17 +00:00
|
|
|
|
|
|
|
|
2000-04-03 15:42:13 +00:00
|
|
|
% \chapter{Debugging \label{debugging}}
|
|
|
|
%
|
|
|
|
% XXX Explain Py_DEBUG, Py_TRACE_REFS, Py_REF_DEBUG.
|
1997-12-30 04:38:44 +00:00
|
|
|
|
|
|
|
|
2000-09-21 21:35:22 +00:00
|
|
|
\appendix
|
|
|
|
\chapter{Reporting Bugs}
|
|
|
|
\input{reportingbugs}
|
|
|
|
|
2001-06-20 21:39:12 +00:00
|
|
|
\chapter{History and License}
|
|
|
|
\input{license}
|
|
|
|
|
2001-01-17 18:04:31 +00:00
|
|
|
\input{api.ind} % Index -- must be last
|
1997-05-15 21:43:21 +00:00
|
|
|
|
|
|
|
\end{document}
|