[Python-checkins] python/dist/src/Doc/api newtypes.tex,1.13,1.14

[gvanrossum@users.sourceforge.net]

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

Modified Files:
	newtypes.tex 
Log Message:
Add some fine points: METH_KEYWORDS implies METH_VARARGS, and ob_size
is no longer unused in type objects.


Index: newtypes.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/api/newtypes.tex,v
retrieving revision 1.13
retrieving revision 1.14
diff -C2 -d -r1.13 -r1.14
*** newtypes.tex	31 May 2002 21:00:18 -0000	1.13
--- newtypes.tex	6 Aug 2002 17:18:56 -0000	1.14
***************
*** 222,226 ****
  convention or a binding convention.  Of the calling convention flags,
  only \constant{METH_VARARGS} and \constant{METH_KEYWORDS} can be
! combined.  Any of the calling convention flags can be combined with a
  binding flag.
  
--- 222,228 ----
  convention or a binding convention.  Of the calling convention flags,
  only \constant{METH_VARARGS} and \constant{METH_KEYWORDS} can be
! combined (but note that \constant{METH_KEYWORDS} alone is equivalent
! to \code{\constant{METH_VARARGS} | \constant{METH_KEYWORDS}}).
! Any of the calling convention flags can be combined with a
  binding flag.
  
***************
*** 336,344 ****
  \verbatiminput{typestruct.h}
  
! The type object structure extends the \ctype{PyVarObject} structure,
! though it does not actually need the the \member{ob_size} field.  The
! inclusion of this field is a historical accident that must be
! maintained to ensure binary compatibility between new versions of
! Python and older compiled extensions.
  
  \begin{cmemberdesc}{PyObject}{PyObject*}{_ob_next}
--- 338,347 ----
  \verbatiminput{typestruct.h}
  
! The type object structure extends the \ctype{PyVarObject} structure.
! The \member{ob_size} field is used for dynamic types (created
! by  \function{type_new()}, usually called from a class statement).
! Note that \cdata{PyType_Type} (the metatype) initializes
! \member{tp_itemsize}, which means that its instances (i.e. type
! objects) \emph{must} have the \member{ob_size} field.
  
  \begin{cmemberdesc}{PyObject}{PyObject*}{_ob_next}
***************
*** 1489,1492 ****
--- 1492,1496 ----
  \begin{ctypedesc}[getcharbufferproc]{int (*getcharbufferproc)
                              (PyObject *self, int segment, const char **ptrptr)}
+ [Guido: the description is missing!]
  \end{ctypedesc}