mirror of
https://github.com/python/cpython.git
synced 2025-08-04 00:48:58 +00:00
copyright.tex: Add 1995 to copyright message.
lib.tex: add libimp; remove bogus warning about lineii. libmath.tex: document hypot(). libmd5.tex: rename md5.md5() to md5.new(). libposix.tex: document chown(). libposixfile.tex: openfile() instead of fileopen(). libsocket.tex: document gethostbyaddr(). libtypes.tex: add footnote explaining why readline() keeps the newline. ref3.tex: correct typos, add back*quotes to index. ref4.tex: don't use \verb inside footnote. ref5.tex: explain repr() and str() and add them + back*quotes to index. ref6.tex: correct typo, don't use \verb in footnote. ref7.tex: don't use \verb in footnote.
This commit is contained in:
parent
e5f8b60429
commit
31cce97374
26 changed files with 134 additions and 40 deletions
|
@ -470,7 +470,7 @@ A file object represents an open file. (It is a wrapper around a C
|
|||
\verb@open()@ built-in function, and also by \verb@posix.popen()@ and
|
||||
the \verb@makefile@ method of socket objects. \verb@sys.stdin@,
|
||||
\verb@sys.stdout@ and \verb@sys.stderr@ are file objects corresponding
|
||||
the the interpreter's standard input, output and error streams.
|
||||
to the interpreter's standard input, output and error streams.
|
||||
See the Python Library Reference for methods of file objects and other
|
||||
details.
|
||||
\obindex{file}
|
||||
|
@ -498,7 +498,7 @@ but they are mentioned here for completeness.
|
|||
Code objects represent executable code. The difference between a code
|
||||
object and a function object is that the function object contains an
|
||||
explicit reference to the function's context (the module in which it
|
||||
was defined) which a code object contains no context. There is no way
|
||||
was defined) while a code object contains no context. There is no way
|
||||
to execute a bare code object.
|
||||
\obindex{code}
|
||||
|
||||
|
@ -622,8 +622,12 @@ former decrements the reference count for \code{x} by one, but
|
|||
\code{x,__del__} is only called when its reference count reaches zero.
|
||||
|
||||
\item[\tt __repr__(self)]
|
||||
Called by the \verb@repr()@ built-in function and by conversions
|
||||
(reverse quotes) to compute the string representation of an object.
|
||||
Called by the \verb@repr()@ built-in function and by string conversions
|
||||
(reverse or backward quotes) to compute the string representation of an object.
|
||||
\indexii{string}{conversion}
|
||||
\indexii{reverse}{quotes}
|
||||
\indexii{backward}{quotes}
|
||||
\index{back-quotes}
|
||||
|
||||
\item[\tt __str__(self)]
|
||||
Called by the \verb@str()@ built-in function and by the \verb@print@
|
||||
|
|
|
@ -72,9 +72,9 @@ When a global name is not found in the global name space, it is
|
|||
searched in the list of ``built-in'' names (which is actually the
|
||||
global name space of the module \verb@__builtin__@). When a name is not
|
||||
found at all, the \verb@NameError@ exception is raised.%
|
||||
\footnote{If the code block contains \verb@exec@ statements or the
|
||||
construct \verb@from ... import *@, the semantics of names not
|
||||
explicitly mentioned in a \verb@global@ statement change subtly: name
|
||||
\footnote{If the code block contains {\tt exec} statements or the
|
||||
construct {\tt from \ldots import *}, the semantics of names not
|
||||
explicitly mentioned in a {\tt global} statement change subtly: name
|
||||
lookup first searches the local name space, then the global one, then
|
||||
the built-in one.}
|
||||
|
||||
|
|
|
@ -187,6 +187,9 @@ value prevails.
|
|||
|
||||
\subsection{String conversions}
|
||||
\indexii{string}{conversion}
|
||||
\indexii{reverse}{quotes}
|
||||
\indexii{backward}{quotes}
|
||||
\index{back-quotes}
|
||||
|
||||
A string conversion is a condition list enclosed in reverse (or
|
||||
backward) quotes:
|
||||
|
@ -214,6 +217,13 @@ dictionaries that contain a reference to themselves, directly or
|
|||
indirectly.)
|
||||
\obindex{recursive}
|
||||
|
||||
The built-in function \verb@repr()@ performs exactly the same
|
||||
conversion in its argument as enclosing it it reverse quotes does.
|
||||
The built-in function \verb@str()@ performs a similar but more
|
||||
user-friendly conversion.
|
||||
\bifuncindex{repr}
|
||||
\bifuncindex{str}
|
||||
|
||||
\section{Primaries} \label{primaries}
|
||||
\index{primary}
|
||||
|
||||
|
|
|
@ -166,7 +166,7 @@ sequence cannot add new items to a list).
|
|||
|
||||
If the primary is a mapping (dictionary) object, the subscript must
|
||||
have a type compatible with the mapping's key type, and the mapping is
|
||||
then asked to to create a key/datum pair which maps the subscript to
|
||||
then asked to create a key/datum pair which maps the subscript to
|
||||
the assigned object. This can either replace an existing key/value
|
||||
pair with the same key value, or insert a new key/value pair (if no
|
||||
key with the same value existed).
|
||||
|
@ -369,7 +369,7 @@ continue_stmt: "continue"
|
|||
\verb@continue@ may only occur syntactically nested in a \verb@for@ or
|
||||
\verb@while@ loop, but not nested in a function or class definition or
|
||||
\verb@try@ statement within that loop.\footnote{Except that it may
|
||||
currently occur within an \verb@except@ clause.}
|
||||
currently occur within an {\tt except} clause.}
|
||||
\stindex{for}
|
||||
\stindex{while}
|
||||
\indexii{loop}{statement}
|
||||
|
|
|
@ -299,7 +299,7 @@ default value is substituted. If a parameter has a default value, all
|
|||
following parameters must also have a default value --- this is a
|
||||
syntactic restriction that is not expressed by the grammar.%
|
||||
\footnote{Currently this is not checked; instead,
|
||||
\verb@def f(a=1,b)@ is interpreted as \verb@def f(a=1,b=None)@.}
|
||||
{\tt def f(a=1,b)} is interpreted as {\tt def f(a=1,b=None)}.}
|
||||
\indexiii{default}{parameter}{value}
|
||||
|
||||
Function call semantics are described in section \ref{calls}. When a
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue