Fix a number of typos and small grammatical nits pointed out by Detlef

freddrake · freddrake · commit dc12ec8ca0d9 · 1999-03-09T18:36:55.000Z
Lannert &lt;lannert@lannert.rz.uni-duesseldorf.de&gt;.

Added a comment explaining the cast in the method table for the
keyword arguments sample code, in response to another comment by
Detlef.
diff --git a/Doc/ext/ext.tex b/Doc/ext/ext.tex
@@ -255,7 +255,7 @@ \section{Intermezzo: Errors and Exceptions
 should probably be \cdata{PyExc_IOError}).  If something's wrong with
 the argument list, the \cfunction{PyArg_ParseTuple()} function usually
 raises \cdata{PyExc_TypeError}.  If you have an argument whose value
-which must be in a particular range or must satisfy other conditions,
+must be in a particular range or must satisfy other conditions,
 \cdata{PyExc_ValueError} is appropriate.
 
 You can also define a new exception that is unique to your module.
@@ -380,7 +380,7 @@ \section{The Module's Method Table and Initialization Function
 arguments should be passed to the function.  In this case, the C
 function should accept a third \samp{PyObject *} parameter which will
 be a dictionary of keywords.  Use \cfunction{PyArg_ParseTupleAndKeywords()}
-to parse the arguemts to such a function.
+to parse the arguments to such a function.
 
 The method table must be passed to the interpreter in the module's
 initialization function (which should be the only non-\code{static}
@@ -462,7 +462,7 @@ \section{Calling Python Functions from C
 somehow pass you the Python function object.  You should provide a
 function (or some other interface) to do this.  When this function is
 called, save a pointer to the Python function object (be careful to
-\cfunction{Py_INCREF()} it!) in a global variable --- or whereever you
+\cfunction{Py_INCREF()} it!) in a global variable --- or wherever you
 see fit. For example, the following function might be part of a module
 definition:
 
@@ -719,7 +719,7 @@ \section{Format Strings for \cfunction{PyArg_ParseTuple()}
 requested; however no proper range checking is done --- the most
 significant bits are silently truncated when the receiving field is
 too small to receive the value (actually, the semantics are inherited
-from downcasts in C --- your milage may vary).
+from downcasts in C --- your mileage may vary).
 
 A few other characters have a meaning in a format string.  These may
 not occur inside nested parentheses.  They are:
@@ -736,7 +736,7 @@ \section{Format Strings for \cfunction{PyArg_ParseTuple()}
 \item[\samp{:}]
 The list of format units ends here; the string after the colon is used
 as the function name in error messages (the ``associated value'' of
-the exceptions that \cfunction{PyArg_ParseTuple()} raises).
+the exception that \cfunction{PyArg_ParseTuple()} raises).
 
 \item[\samp{;}]
 The list of format units ends here; the string after the colon is used
@@ -866,6 +866,10 @@ \section{Keyword Parsing with \cfunction{PyArg_ParseTupleAndKeywords()}
 }
 
 static PyMethodDef keywdarg_methods[] = {
+    /* The cast of the function is necessary since PyCFunction values
+     * only take two PyObject* parameters, and keywdarg_parrot() takes
+     * three.
+     */
     {"parrot", (PyCFunction)keywdarg_parrot, METH_VARARGS|METH_KEYWORDS},
     {NULL,  NULL}   /* sentinel */
 };
@@ -1605,9 +1609,9 @@ \chapter{Building C and \Cpp{} Extensions on \UNIX{}
 \end{verbatim}
 
 to indicate that the modules defined in \file{Setup} are to be built
-as dynamically-linked linked modules.  A line containing only
-\samp{*static*} can be used to indicate the subsequently listed
-modules should be statically linked.
+as dynamically linked modules.  A line containing only \samp{*static*}
+can be used to indicate the subsequently listed modules should be
+statically linked.
 
 Here is a complete \file{Setup} file for building a
 \module{cPersistent} module:
@@ -1672,7 +1676,7 @@ \section{Module Definition Options \label{module-defn-options}}
 \end{tableii}
 
 Other compiler options can be included (snuck in) by putting them
-in variable variables.
+in variables.
 
 Source files can include files with \file{.c}, \file{.C}, \file{.cc},
 \file{.cpp}, \file{.cxx}, and \file{.c++} extensions. 
