| 
									
										
										
										
											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} |