mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-08-02 08:02:56 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

Use \citetitle in several places, and \programopt where appropriate.

Browse source
This commit is contained in:
Fred Drake 1999-11-10 16:01:43 +00:00
parent 698d5206aa
commit 9fa76f1090
1 changed files with 23 additions and 20 deletions
Download patch file Download diff file Expand all files Collapse all files

43
Doc/ext/ext.tex
View file

@ -44,15 +44,16 @@ dynamically (at run time) into the interpreter, if the underlying
operating system supports this feature. operating system supports this feature.
This document assumes basic knowledge about Python. For an informal This document assumes basic knowledge about Python. For an informal
introduction to the language, see the Python Tutorial. The \emph{Python introduction to the language, see the
Reference Manual} gives a more formal definition of the language. The \citetitle[../tut/tut.html]{Python Tutorial}. The
\emph{Python Library Reference} documents the existing object types, \citetitle[../ref/ref.html]{Python Reference Manual} gives a more
functions and modules (both built-in and written in Python) that give formal definition of the language. The
the language its wide application range. \citetitle[../lib/lib.html]{Python Library Reference} documents the
existing object types, functions and modules (both built-in and
written in Python) that give the language its wide application range.
For a detailed description of the whole Python/C API, see the separate For a detailed description of the whole Python/C API, see the separate
\emph{Python/C API Reference Manual}. \citetitle[../api/api.html]{Python/C API Reference Manual}.
\end{abstract} \end{abstract}
@ -179,9 +180,10 @@ argument to \keyword{raise}). A third variable contains the stack
traceback in case the error originated in Python code. These three traceback in case the error originated in Python code. These three
variables are the C equivalents of the Python variables variables are the C equivalents of the Python variables
\code{sys.exc_type}, \code{sys.exc_value} and \code{sys.exc_traceback} (see \code{sys.exc_type}, \code{sys.exc_value} and \code{sys.exc_traceback} (see
the section on module \module{sys} in the \emph{Python Library the section on module \module{sys} in the
Reference}). It is important to know about them to understand how \citetitle[../lib/lib.html]{Python Library Reference}). It is
errors are passed around. important to know about them to understand how errors are passed
around.
The Python API defines a number of functions to set various types of The Python API defines a number of functions to set various types of
exceptions. exceptions.
@ -286,10 +288,11 @@ initspam()
Note that the Python name for the exception object is Note that the Python name for the exception object is
\exception{spam.error}. The \cfunction{PyErr_NewException()} function \exception{spam.error}. The \cfunction{PyErr_NewException()} function
may create either a string or class, depending on whether the may create either a string or class, depending on whether the
\samp{-X} flag was passed to the interpreter. If \samp{-X} was used, \programopt{-X} flag was passed to the interpreter. If
\cdata{SpamError} will be a string object, otherwise it will be a \programopt{-X} was used, \cdata{SpamError} will be a string object,
class object with the base class being \exception{Exception}, otherwise it will be a class object with the base class being
described in the \emph{Python Library Reference} under ``Built-in \exception{Exception}, described in the
\citetitle[../lib/lib.html]{Python Library Reference} under ``Built-in
Exceptions.'' Exceptions.''
@ -462,8 +465,8 @@ Fortunately, the Python interpreter is easily called recursively, and
there is a standard interface to call a Python function. (I won't there is a standard interface to call a Python function. (I won't
dwell on how to call the Python parser with a particular string as dwell on how to call the Python parser with a particular string as
input --- if you're interested, have a look at the implementation of input --- if you're interested, have a look at the implementation of
the \samp{-c} command line option in \file{Python/pythonmain.c} from the \programopt{-c} command line option in \file{Python/pythonmain.c}
the Python source code.) from the Python source code.)
Calling a Python function is easy. First, the Python program must Calling a Python function is easy. First, the Python program must
somehow pass you the Python function object. You should provide a somehow pass you the Python function object. You should provide a
@ -1565,10 +1568,10 @@ exported, so it has to be learned only once.
Finally it should be mentioned that CObjects offer additional Finally it should be mentioned that CObjects offer additional
functionality, which is especially useful for memory allocation and functionality, which is especially useful for memory allocation and
deallocation of the pointer stored in a CObject. The details deallocation of the pointer stored in a CObject. The details
are described in the \emph{Python/C API Reference Manual} in the are described in the \citetitle[../api/api.html]{Python/C API
section ``CObjects'' and in the implementation of CObjects (files Reference Manual} in the section ``CObjects'' and in the
\file{Include/cobject.h} and \file{Objects/cobject.c} in the implementation of CObjects (files \file{Include/cobject.h} and
Python source code distribution). \file{Objects/cobject.c} in the Python source code distribution).
\chapter{Building C and \Cpp{} Extensions on \UNIX{} \chapter{Building C and \Cpp{} Extensions on \UNIX{}