[Python-checkins] python/dist/src/Doc/api newtypes.tex,1.15,1.16

[rhettinger@users.sourceforge.net]

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

Modified Files:
	newtypes.tex 
Log Message:
Document type and semantics of the tp_print return value.  Closes SF 606464.


Index: newtypes.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/api/newtypes.tex,v
retrieving revision 1.15
retrieving revision 1.16
diff -C2 -d -r1.15 -r1.16
*** newtypes.tex	14 Aug 2002 20:59:38 -0000	1.15
--- newtypes.tex	10 Sep 2002 13:48:01 -0000	1.16
***************
*** 527,531 ****
  
    The print function is called with the same signature as
!   \cfunction{PyObject_Print()}: \code{tp_print(PyObject *self, FILE
    *file, int flags)}.  The \var{self} argument is the instance to be
    printed.  The \var{file} argument is the stdio file to which it is
--- 527,531 ----
  
    The print function is called with the same signature as
!   \cfunction{PyObject_Print()}: \code{int tp_print(PyObject *self, FILE
    *file, int flags)}.  The \var{self} argument is the instance to be
    printed.  The \var{file} argument is the stdio file to which it is
***************
*** 536,539 ****
--- 536,541 ----
    when the \constant{Py_PRINT_RAW} flag bit is clear, the instance
    should be printed the same was as \member{tp_repr} would format it.
+   It should return \code{-1} and set an exception condition when an
+   error occurred during the comparison.
  
    It is possible that the \member{tp_print} field will be deprecated.