From 901a41e7575e6fb4625d0e419fffc2deb95352cb Mon Sep 17 00:00:00 2001 From: Fred Drake Date: Tue, 1 Jul 2003 16:17:50 +0000 Subject: [PATCH] normalize markup for consistency --- Doc/ext/newtypes.tex | 31 ++++++++++++++++--------------- 1 file changed, 16 insertions(+), 15 deletions(-) diff --git a/Doc/ext/newtypes.tex b/Doc/ext/newtypes.tex index 2b915f3f44e..cd5fe55ed1f 100644 --- a/Doc/ext/newtypes.tex +++ b/Doc/ext/newtypes.tex @@ -158,7 +158,7 @@ to \class{noddy.Noddy}. \end{verbatim} This is so that Python knows how much memory to allocate when you call -\cfunction{PyObject_New}. +\cfunction{PyObject_New()}. \begin{verbatim} 0, /* tp_itemsize */ @@ -192,7 +192,7 @@ For now, all we want to be able to do is to create new \class{Noddy} objects. To enable object creation, we have to provide a \member{tp_new} implementation. In this case, we can just use the default implementation provided by the API function -\cfunction{PyType_GenericNew}. We'd like to just assign this to the +\cfunction{PyType_GenericNew()}. We'd like to just assign this to the \member{tp_new} slot, but we can't, for portability sake, On some platforms or compilers, we can't statically initialize a structure member with a function defined in another C module, so, instead, we'll @@ -209,7 +209,7 @@ All the other type methods are \NULL, so we'll go over them later --- that's for a later section! Everything else in the file should be familiar, except for some code -in \cfunction{initnoddy}: +in \cfunction{initnoddy()}: \begin{verbatim} if (PyType_Ready(&noddy_NoddyType) < 0) @@ -315,7 +315,7 @@ which is assigned to the \member{tp_dealloc} member: \end{verbatim} This method decrements the reference counts of the two Python -attributes. We use \cfunction{Py_XDECREF} here because the +attributes. We use \cfunction{Py_XDECREF()} here because the \member{first} and \member{last} members could be \NULL. It then calls the \member{tp_free} member of the object's type to free the object's memory. Note that the object's type might not be @@ -362,14 +362,14 @@ and install it in the \member{tp_new} member: The new member is responsible for creating (as opposed to initializing) objects of the type. It is exposed in Python as the -\method{__new__} method. See the paper titled ``Unifying types and -classes in Python'' for a detailed discussion of the \method{__new__} +\method{__new__()} method. See the paper titled ``Unifying types and +classes in Python'' for a detailed discussion of the \method{__new__()} method. One reason to implement a new method is to assure the initial values of instance variables. In this case, we use the new method to make sure that the initial values of the members \member{first} and \member{last} are not \NULL. If we didn't care whether the initial -values were \NULL, we could have used \cfunction{PyType_GenericNew} as -our new method, as we did before. \cfunction{PyType_GenericNew} +values were \NULL, we could have used \cfunction{PyType_GenericNew()} as +our new method, as we did before. \cfunction{PyType_GenericNew()} initializes all of the instance variable members to NULLs. The new method is a static method that is passed the type being @@ -422,7 +422,7 @@ by filling the \member{tp_init} slot. \end{verbatim} The \member{tp_init} slot is exposed in Python as the -\method{__init__} method. It is used to initialize an object after +\method{__init__()} method. It is used to initialize an object after it's created. Unlike the new method, we can't guarantee that the initializer is called. The initializer isn't called when unpickling objects and it can be overridden. Our initializer accepts arguments @@ -550,8 +550,8 @@ definition: Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /*tp_flags*/ \end{verbatim} -We rename \cfunction{initnoddy} to \cfunction{initnoddy2} -and update the module name passed to \cfunction{Py_InitModule3}. +We rename \cfunction{initnoddy()} to \cfunction{initnoddy2()} +and update the module name passed to \cfunction{Py_InitModule3()}. Finally, we update our \file{setup.py} file to build the new module: @@ -661,7 +661,7 @@ static PyMemberDef Noddy_members[] = { With these changes, we can assure that the \member{first} and \member{last} members are never NULL so we can remove checks for \NULL values in almost all cases. This means that most of the -\cfunction{Py_XDECREF} calls can be converted to \cfunction{Py_DECREF} +\cfunction{Py_XDECREF()} calls can be converted to \cfunction{Py_DECREF()} calls. The only place we can't change these calls is in the deallocator, where there is the possibility that the initialization of these members failed in the constructor. @@ -723,8 +723,8 @@ Noddy_traverse(Noddy *self, visitproc visit, void *arg) \end{verbatim} For each subobject that can participate in cycles, we need to call the -\cfunction{visit} function, which is passed to the traversal method. -The \cfunction{visit} function takes as arguments the subobject and +\cfunction{visit()} function, which is passed to the traversal method. +The \cfunction{visit()} function takes as arguments the subobject and the extra argument \var{arg} passed to the traversal method. We also need to provide a method for clearing any subobjects that can @@ -751,7 +751,8 @@ Noddy_dealloc(Noddy* self) } \end{verbatim} -Finally, we add the \constant{Py_TPFLAGS_HAVE_GC} flag to the class flags: +Finally, we add the \constant{Py_TPFLAGS_HAVE_GC} flag to the class +flags: \begin{verbatim} Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE | Py_TPFLAGS_HAVE_GC, /*tp_flags*/