[Python-checkins] python/dist/src/Doc/api utilities.tex,1.5,1.6

[tim_one@users.sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/api
In directory usw-pr-cvs1:/tmp/cvs-serv13269/python/Doc/api

Modified Files:
	utilities.tex 
Log Message:
The Py_REF_DEBUG/COUNT_ALLOCS/Py_TRACE_REFS macro minefield:  added
more trivial lexical helper macros so that uses of these guys expand
to nothing at all when they're not enabled.  This should help sub-
standard compilers that can't do a good job of optimizing away the
previous "(void)0" expressions.

Py_DECREF:  There's only one definition of this now.  Yay!  That
was that last one in the family defined multiple times in an #ifdef
maze.

Py_FatalError():  Changed the char* signature to const char*.

_Py_NegativeRefcount():  New helper function for the Py_REF_DEBUG
expansion of Py_DECREF.  Calling an external function cuts down on
the volume of generated code.  The previous inline expansion of abort()
didn't work as intended on Windows (the program often kept going, and
the error msg scrolled off the screen unseen).  _Py_NegativeRefcount
calls Py_FatalError instead, which captures our best knowledge of
how to abort effectively across platforms.


Index: utilities.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/api/utilities.tex,v
retrieving revision 1.5
retrieving revision 1.6
diff -C2 -d -r1.5 -r1.6
*** utilities.tex	17 Jun 2002 15:44:18 -0000	1.5
--- utilities.tex	9 Jul 2002 02:57:01 -0000	1.6
***************
*** 59,63 ****
  \section{Process Control \label{processControl}}
  
! \begin{cfuncdesc}{void}{Py_FatalError}{char *message}
    Print a fatal error message and kill the process.  No cleanup is
    performed.  This function should only be invoked when a condition is
--- 59,63 ----
  \section{Process Control \label{processControl}}
  
! \begin{cfuncdesc}{void}{Py_FatalError}{const char *message}
    Print a fatal error message and kill the process.  No cleanup is
    performed.  This function should only be invoked when a condition is