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

[mondragon at users.sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/api
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv8622/Doc/api

Modified Files:
	init.tex 
Log Message:
Enable the profiling of C functions (builtins and extensions)


Index: init.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/api/init.tex,v
retrieving revision 1.15
retrieving revision 1.16
diff -C2 -d -r1.15 -r1.16
*** init.tex	18 Mar 2004 01:38:11 -0000	1.15
--- init.tex	24 Mar 2004 21:57:07 -0000	1.16
***************
*** 727,740 ****
    function as \var{obj}, \var{frame} is the frame object to which the
    event pertains, \var{what} is one of the constants
!   \constant{PyTrace_CALL}, \constant{PyTrace_EXCEPT},
!   \constant{PyTrace_LINE} or \constant{PyTrace_RETURN}, and \var{arg}
    depends on the value of \var{what}:
  
    \begin{tableii}{l|l}{constant}{Value of \var{what}}{Meaning of \var{arg}}
      \lineii{PyTrace_CALL}{Always \NULL.}
!     \lineii{PyTrace_EXCEPT}{Exception information as returned by
                              \function{sys.exc_info()}.}
      \lineii{PyTrace_LINE}{Always \NULL.}
      \lineii{PyTrace_RETURN}{Value being returned to the caller.}
    \end{tableii}
  \end{ctypedesc}
--- 727,745 ----
    function as \var{obj}, \var{frame} is the frame object to which the
    event pertains, \var{what} is one of the constants
!   \constant{PyTrace_CALL}, \constant{PyTrace_EXCEPTION},
!   \constant{PyTrace_LINE}, \constant{PyTrace_RETURN},
!   \constant{PyTrace_C_CALL}, \constant{PyTrace_C_EXCEPTION},
!   or \constant{PyTrace_C_RETURN}, and \var{arg}
    depends on the value of \var{what}:
  
    \begin{tableii}{l|l}{constant}{Value of \var{what}}{Meaning of \var{arg}}
      \lineii{PyTrace_CALL}{Always \NULL.}
!     \lineii{PyTrace_EXCEPTION}{Exception information as returned by
                              \function{sys.exc_info()}.}
      \lineii{PyTrace_LINE}{Always \NULL.}
      \lineii{PyTrace_RETURN}{Value being returned to the caller.}
+     \lineii{PyTrace_C_CALL}{Name of function being called.}
+     \lineii{PyTrace_C_EXCEPTION}{Always \NULL.}
+     \lineii{PyTrace_C_RETURN}{Always \NULL.}
    \end{tableii}
  \end{ctypedesc}
***************
*** 748,752 ****
  \end{cvardesc}
  
! \begin{cvardesc}{int}{PyTrace_EXCEPT}
    The value of the \var{what} parameter to a \ctype{Py_tracefunc}
    function when an exception has been raised.  The callback function
--- 753,757 ----
  \end{cvardesc}
  
! \begin{cvardesc}{int}{PyTrace_EXCEPTION}
    The value of the \var{what} parameter to a \ctype{Py_tracefunc}
    function when an exception has been raised.  The callback function
***************
*** 771,774 ****
--- 776,794 ----
  \end{cvardesc}
  
+ \begin{cvardesc}{int}{PyTrace_C_CALL}
+   The value for the \var{what} parameter to \ctype{Py_tracefunc}
+   functions when a C function is about to be called.
+ \end{cvardesc}
+ 
+ \begin{cvardesc}{int}{PyTrace_C_EXCEPTION}
+   The value for the \var{what} parameter to \ctype{Py_tracefunc}
+   functions when a C function has thrown an exception.
+ \end{cvardesc}
+ 
+ \begin{cvardesc}{int}{PyTrace_C_RETURN}
+   The value for the \var{what} parameter to \ctype{Py_tracefunc}
+   functions when a C function has returned.
+ \end{cvardesc}
+ 
  \begin{cfuncdesc}{void}{PyEval_SetProfile}{Py_tracefunc func, PyObject *obj}
    Set the profiler function to \var{func}.  The \var{obj} parameter is