Kaydet (Commit) e15eb35f authored tarafından Fred Drake's avatar Fred Drake

Use \citetitle as appropriate.

üst 9fa76f10
...@@ -31,8 +31,8 @@ implemented as functions in the module. Not all operations possible in ...@@ -31,8 +31,8 @@ implemented as functions in the module. Not all operations possible in
parameters will occasionally be different in Python (input and output parameters will occasionally be different in Python (input and output
buffers, especially). All methods and functions have a \code{__doc__} buffers, especially). All methods and functions have a \code{__doc__}
string describing their arguments and return values, and for string describing their arguments and return values, and for
additional description you are referred to \emph{Inside Macintosh} or additional description you are referred to \citetitle{Inside
similar works. Macintosh} or similar works.
The following modules are documented here: The following modules are documented here:
...@@ -92,8 +92,9 @@ One additional function is available: ...@@ -92,8 +92,9 @@ One additional function is available:
This module is the Macintosh implementation of the \module{os.path} This module is the Macintosh implementation of the \module{os.path}
module. It is most portably accessed as module. It is most portably accessed as
\module{os.path}\refstmodindex{os.path}. Refer to the \emph{Python Library \module{os.path}\refstmodindex{os.path}. Refer to the
Reference} for documentation of \module{os.path}. \citetitle[../lib/lib.html]{Python Library Reference} for
documentation of \module{os.path}.
The following functions are available in this module: The following functions are available in this module:
\function{normcase()}, \function{normcase()},
......
...@@ -16,7 +16,7 @@ Manager, \program{finder} aliases and the Standard File package. ...@@ -16,7 +16,7 @@ Manager, \program{finder} aliases and the Standard File package.
Whenever a function or method expects a \var{file} argument, this Whenever a function or method expects a \var{file} argument, this
argument can be one of three things:\ (1) a full or partial Macintosh argument can be one of three things:\ (1) a full or partial Macintosh
pathname, (2) an \pytype{FSSpec} object or (3) a 3-tuple \code{(\var{wdRefNum}, pathname, (2) an \pytype{FSSpec} object or (3) a 3-tuple \code{(\var{wdRefNum},
\var{parID}, \var{name})} as described in \emph{Inside \var{parID}, \var{name})} as described in \citetitle{Inside
Macintosh:\ Files}. A description of aliases and the Standard File Macintosh:\ Files}. A description of aliases and the Standard File
package can also be found there. package can also be found there.
...@@ -202,7 +202,7 @@ resource. ...@@ -202,7 +202,7 @@ resource.
\subsection{FInfo Objects \label{finfo-objects}} \subsection{FInfo Objects \label{finfo-objects}}
See \emph{Inside Macintosh: Files} for a complete description of what See \citetitle{Inside Macintosh: Files} for a complete description of what
the various fields mean. the various fields mean.
\begin{memberdesc}[FInfo]{Creator} \begin{memberdesc}[FInfo]{Creator}
......
...@@ -24,16 +24,18 @@ ...@@ -24,16 +24,18 @@
\noindent \noindent
This library reference manual documents Python's extensions for the This library reference manual documents Python's extensions for the
Macintosh. It should be used in conjunction with the \emph{Python Macintosh. It should be used in conjunction with the
Library Reference}, which documents the standard library and built-in \citetitle[../lib/lib.html]{Python Library Reference}, which documents
types. the standard library and built-in types.
This manual assumes basic knowledge about the Python language. For an This manual assumes basic knowledge about the Python language. For an
informal introduction to Python, see the \emph{Python Tutorial}; the informal introduction to Python, see the
\emph{Python Reference Manual} remains the highest authority on \citetitle[../tut/tut.html]{Python Tutorial}; the
syntactic and semantic questions. Finally, the manual entitled \citetitle[../ref/ref.html]{Python Reference Manual} remains the
\emph{Extending and Embedding the Python Interpreter} describes how to highest authority on syntactic and semantic questions. Finally, the
add new extensions to Python and how to embed it in other applications. manual entitled \citetitle[../ext/ext.html]{Extending and Embedding
the Python Interpreter} describes how to add new extensions to Python
and how to embed it in other applications.
\end{abstract} \end{abstract}
......
...@@ -32,15 +32,18 @@ extensive standard library are available in source or binary form ...@@ -32,15 +32,18 @@ extensive standard library are available in source or binary form
without charge for all major platforms, and can be freely distributed. without charge for all major platforms, and can be freely distributed.
This reference manual describes the syntax and ``core semantics'' of This reference manual describes the syntax and ``core semantics'' of
the language. It is terse, but attempts to be exact and complete. The the language. It is terse, but attempts to be exact and complete.
semantics of non-essential built-in object types and of the built-in The semantics of non-essential built-in object types and of the
functions and modules are described in the \emph{Python Library built-in functions and modules are described in the
Reference}. For an informal introduction to the language, see the \citetitle[../lib/lib.html]{Python Library Reference}. For an
\emph{Python Tutorial}. For \C{} or \Cpp{} programmers, two additional informal introduction to the language, see the
manuals exist: \emph{Extending and Embedding the Python Interpreter} \citetitle[../tut/tut.html]{Python Tutorial}. For C or
describes the high-level picture of how to write a Python extension \Cpp{} programmers, two additional manuals exist:
module, and the \emph{Python/C API Reference Manual} describes the \citetitle[../ext/ext.html]{Extending and Embedding the Python
interfaces available to C/C++ programmers in detail. Interpreter} describes the high-level picture of how to write a Python
extension module, and the \citetitle[../api/api.html]{Python/C API
Reference Manual} describes the interfaces available to
C/\Cpp{} programmers in detail.
\end{abstract} \end{abstract}
......
...@@ -29,9 +29,9 @@ text. ...@@ -29,9 +29,9 @@ text.
Every Python implementation comes with a number of built-in and Every Python implementation comes with a number of built-in and
standard modules. These are not documented here, but in the separate standard modules. These are not documented here, but in the separate
\emph{Python Library Reference} document. A few built-in modules are \citetitle[../lib/lib.html]{Python Library Reference} document. A few
mentioned when they interact in a significant way with the language built-in modules are mentioned when they interact in a significant way
definition. with the language definition.
\section{Notation\label{notation}} \section{Notation\label{notation}}
......
...@@ -629,28 +629,25 @@ dictionary; \member{__class__} is the instance's class. ...@@ -629,28 +629,25 @@ dictionary; \member{__class__} is the instance's class.
\ttindex{__class__}} \ttindex{__class__}}
\item[Files] \item[Files]
A file object represents an open file. File objects are created by the A file\obindex{file} object represents an open file. File objects are
\function{open()} built-in function, and also by created by the \function{open()}\bifuncindex{open} built-in function,
\function{os.popen()}, \function{os.fdopen()}, and the and also by
\method{makefile()} method of socket objects (and perhaps by other \withsubitem{(in module os)}{\ttindex{popen()}}\function{os.popen()},
functions or methods provided by extension modules). The objects \function{os.fdopen()}, and the
\code{sys.stdin}, \code{sys.stdout} and \code{sys.stderr} are \method{makefile()}\withsubitem{(socket method)}{\ttindex{makefile()}}
initialized to file objects corresponding to the interpreter's method of socket objects (and perhaps by other functions or methods
standard input, output and error streams. See the \emph{Python provided by extension modules). The objects
Library Reference} for complete documentation of file objects. \ttindex{sys.stdin}\code{sys.stdin},
\obindex{file} \ttindex{sys.stdout}\code{sys.stdout} and
\indexii{C}{language} \ttindex{sys.stderr}\code{sys.stderr} are initialized to file objects
\index{stdio} corresponding to the interpreter's standard\index{stdio} input, output
\bifuncindex{open} and error streams. See the \citetitle[../lib/lib.html]{Python Library
\withsubitem{(in module os)}{\ttindex{popen()}} Reference} for complete documentation of file objects.
\withsubitem{(socket method)}{\ttindex{makefile()}}
\withsubitem{(in module sys)}{ \withsubitem{(in module sys)}{
\ttindex{stdin} \ttindex{stdin}
\ttindex{stdout} \ttindex{stdout}
\ttindex{stderr}} \ttindex{stderr}}
\ttindex{sys.stdin}
\ttindex{sys.stdout}
\ttindex{sys.stderr}
\item[Internal types] \item[Internal types]
A few types used internally by the interpreter are exposed to the user. A few types used internally by the interpreter are exposed to the user.
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment