[Python-checkins] CVS: python/dist/src/Doc/api api.tex,1.56.2.9,1.56.2.10

[Fred L. Drake]

Update of /projects/cvsroot/python/dist/src/Doc/api
In directory weyr:/home/fdrake/projects/python/Doc-152p1/api

Modified Files:
      Tag: release152p1-patches
	api.tex 
Log Message:

Lots of minor markup adjustments to keep things clean.  Sought &
adjusted markup that can make LaTeX2HTML drop a space in the output.

Added explanation of where to find the installed header files for Unix 
& Windows.

Added a paragraph at the top of the high-level functions section
explaining the 'start' parameter, telling what the useful values are
and pointing to the specific explanations of each at the end of the
section.

Added a short section to the "Exception Handling" chapter describing
the deprecation of string exceptions and removal of the -X option in
future releases of the interpreter.

Filled in a few missing descriptions throughout the document, and
filled out a bunch more that were incomplete; many descriptions now
sport slick new exception information.

Re-structured the descripition of the API for complex numbers, clearly 
separating the C-type from the Python-type portions.

Commented out the "Debugging" chapter since it hasn't been written.


Index: api.tex
===================================================================
RCS file: /projects/cvsroot/python/dist/src/Doc/api/api.tex,v
retrieving revision 1.56.2.9
retrieving revision 1.56.2.10
diff -C2 -r1.56.2.9 -r1.56.2.10
*** api.tex	2000/02/16 16:07:43	1.56.2.9
--- api.tex	2000/02/21 16:52:23	1.56.2.10
***************
*** 21,25 ****
  
  \noindent
! This manual documents the API used by \C{} (or \Cpp{}) programmers who
  want to write extension modules or embed Python.  It is a companion to
  \emph{Extending and Embedding the Python Interpreter}, which describes
--- 21,25 ----
  
  \noindent
! This manual documents the API used by C (or \Cpp{}) programmers who
  want to write extension modules or embed Python.  It is a companion to
[...1602 lines suppressed...]
! XXX Explain Py_DEBUG, Py_TRACE_REFS, Py_REF_DEBUG.
  
  
--- 3377,3392 ----
  characters may be multi-byte characters. This implies that a buffer
  size of \var{N} does not mean there are \var{N} characters present.
  \end{ctypedesc}
  
  DL_IMPORT
  
  Py*_Check
  
+ _Py_NoneStruct
  
  
! % \chapter{Debugging \label{debugging}}
! %
! % XXX Explain Py_DEBUG, Py_TRACE_REFS, Py_REF_DEBUG.