[Python-checkins] python/dist/src/Doc/api concrete.tex,1.28,1.29

[loewis at users.sourceforge.net]

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

Modified Files:
	concrete.tex 
Log Message:
Make CObjects mutable. Fixes #477441.


Index: concrete.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/api/concrete.tex,v
retrieving revision 1.28
retrieving revision 1.29
diff -C2 -d -r1.28 -r1.29
*** concrete.tex	19 Oct 2003 07:32:23 -0000	1.28
--- concrete.tex	19 Oct 2003 18:30:00 -0000	1.29
***************
*** 2480,2489 ****
  
  \begin{cfuncdesc}{int}{PyCObject_Check}{PyObject *p}
!   Returns true if its argument is a \ctype{PyCObject}.
  \end{cfuncdesc}
  
  \begin{cfuncdesc}{PyObject*}{PyCObject_FromVoidPtr}{void* cobj,
                                                      void (*destr)(void *)}
!   Creates a \ctype{PyCObject} from the \code{void *}\var{cobj}.  The
    \var{destr} function will be called when the object is reclaimed,
    unless it is \NULL.
--- 2480,2489 ----
  
  \begin{cfuncdesc}{int}{PyCObject_Check}{PyObject *p}
!   Return true if its argument is a \ctype{PyCObject}.
  \end{cfuncdesc}
  
  \begin{cfuncdesc}{PyObject*}{PyCObject_FromVoidPtr}{void* cobj,
                                                      void (*destr)(void *)}
!   Create a \ctype{PyCObject} from the \code{void *}\var{cobj}.  The
    \var{destr} function will be called when the object is reclaimed,
    unless it is \NULL.
***************
*** 2492,2496 ****
  \begin{cfuncdesc}{PyObject*}{PyCObject_FromVoidPtrAndDesc}{void* cobj,
  	                          void* desc, void (*destr)(void *, void *)}
!   Creates a \ctype{PyCObject} from the \ctype{void *}\var{cobj}.  The
    \var{destr} function will be called when the object is reclaimed.
    The \var{desc} argument can be used to pass extra callback data for
--- 2492,2496 ----
  \begin{cfuncdesc}{PyObject*}{PyCObject_FromVoidPtrAndDesc}{void* cobj,
  	                          void* desc, void (*destr)(void *, void *)}
!   Create a \ctype{PyCObject} from the \ctype{void *}\var{cobj}.  The
    \var{destr} function will be called when the object is reclaimed.
    The \var{desc} argument can be used to pass extra callback data for
***************
*** 2499,2509 ****
  
  \begin{cfuncdesc}{void*}{PyCObject_AsVoidPtr}{PyObject* self}
!   Returns the object \ctype{void *} that the \ctype{PyCObject}
    \var{self} was created with.
  \end{cfuncdesc}
  
  \begin{cfuncdesc}{void*}{PyCObject_GetDesc}{PyObject* self}
!   Returns the description \ctype{void *} that the \ctype{PyCObject}
    \var{self} was created with.
  \end{cfuncdesc}
  
--- 2499,2515 ----
  
  \begin{cfuncdesc}{void*}{PyCObject_AsVoidPtr}{PyObject* self}
!   Return the object \ctype{void *} that the \ctype{PyCObject}
    \var{self} was created with.
  \end{cfuncdesc}
  
  \begin{cfuncdesc}{void*}{PyCObject_GetDesc}{PyObject* self}
!   Return the description \ctype{void *} that the \ctype{PyCObject}
    \var{self} was created with.
+ \end{cfuncdesc}
+ 
+ \begin{cfuncdesc}{int}{PyCObject_SetVoidPtr}{PyObject* self, void* cobj}
+   Set the void pointer inside \var{self} to \var{cobj}. 
+   The \ctype{PyCObject} must not have an associated destructor.
+   Return true on success, false on failure.
  \end{cfuncdesc}