Document 'N' format character for Py_BuildValue -- like 'O' but doesn't INCREF.

gvanrossum · gvanrossum · commit d358afeec003 · 1998-12-23T05:02:08.000Z
diff --git a/Doc/ext/ext.tex b/Doc/ext/ext.tex
@@ -1,6 +1,6 @@
 \documentclass{manual}
 
-% XXX PM Modulator
+% XXX PM explain how to add new types to Python
 
 \title{Extending and Embedding the Python Interpreter}
 
@@ -942,6 +942,11 @@ \section{The \cfunction{Py_BuildValue()} Function
 \item[\samp{S} (object) {[PyObject *]}]
 Same as \samp{O}.
 
+\item[\samp{N} (object) {[PyObject *]}]
+Same as \samp{O}, except it doesn't increment the reference count on
+the object.  Useful when the object is created by a call to an object
+constructor in the argument list.
+
 \item[\samp{O\&} (object) {[\var{converter}, \var{anything}]}]
 Convert \var{anything} to a Python object through a \var{converter}
 function.  The function is called with \var{anything} (which should be
