mirror of
https://github.com/python/cpython.git
synced 2025-11-11 14:44:57 +00:00
Use \citetitle as appropriate.
This commit is contained in:
parent
9fa76f1090
commit
e15eb35fd0
6 changed files with 47 additions and 44 deletions
|
|
@ -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:
|
||||||
|
|
||||||
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.
|
||||||
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.
|
||||||
|
|
||||||
\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 @@
|
||||||
|
|
||||||
\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
|
||||||
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.
|
||||||
|
|
||||||
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.
|
||||||
\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.
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue