[Python-checkins] python/dist/src/Doc/api abstract.tex,1.23,1.24

gvanrossum@users.sourceforge.net gvanrossum@users.sourceforge.net
Wed, 09 Apr 2003 11:02:27 -0700


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

Modified Files:
	abstract.tex 
Log Message:
Try to discourage use of PyObject_Type().


Index: abstract.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/api/abstract.tex,v
retrieving revision 1.23
retrieving revision 1.24
diff -C2 -d -r1.23 -r1.24
*** abstract.tex	25 Jan 2003 07:48:13 -0000	1.23
--- abstract.tex	9 Apr 2003 18:02:23 -0000	1.24
***************
*** 320,323 ****
--- 320,328 ----
    \exception{SystemError} and returns \NULL.  This is equivalent to
    the Python expression \code{type(\var{o})}.
+   This function increments the reference count of the return value.
+   There's really no reason to use this function instead of the
+   common expression \code{\var{o}->ob_type}, which returns a pointer
+   of type \code{PyTypeObject *}, except when the incremented reference
+   count is needed.
    \bifuncindex{type}
  \end{cfuncdesc}