The situation is slightly different for function return values.
While passing a reference to most functions does not change your
ownership responsibilities for that reference, many functions that
-return a referece to an object give you ownership of the reference.
+return a reference to an object give you ownership of the reference.
The reason is simple: in many cases, the returned object is created
on the fly, and the reference you get is the only reference to the
object. Therefore, the generic functions that return object
In addition, the following macro sets are provided for calling the
Python memory allocator directly, without involving the C API functions
listed above. However, note that their use does not preserve binary
-compatibility accross Python versions and is therefore deprecated in
+compatibility across Python versions and is therefore deprecated in
extension modules.
\cfunction{PyMem_MALLOC()}, \cfunction{PyMem_REALLOC()}, \cfunction{PyMem_FREE()}.
build/release/install mechanics.
\end{abstract}
-% The ugly "%begin{latexonly}" pseudo-environment supresses the table
+% The ugly "%begin{latexonly}" pseudo-environment suppresses the table
% of contents for HTML generation.
%
%begin{latexonly}
\end{verbatim}
This will affect all builds of this module distribution, whether or not
-you explcitly specify \command{build\_ext}. If you include
+you explicitly specify \command{build\_ext}. If you include
\file{setup.cfg} in your source distribution, it will also affect
end-user builds---which is probably a bad idea for this option, since
always building extensions in-place would break installation of the
\var{extra_preargs} and \var{extra_postargs} are implementation- dependent.
On platforms that have the notion of a command-line (e.g. \UNIX,
DOS/Windows), they are most likely lists of strings: extra
-command-line arguments to prepand/append to the compiler command
+command-line arguments to prepend/append to the compiler command
line. On other platforms, consult the implementation class
documentation. In any event, they are intended as an escape hatch
for those occasions when the abstract compiler framework doesn't
For ``central processing unit.'' Many style guides say this
should be spelled out on the first use (and if you must use it,
do so!). For the Python documentation, this abbreviation should
- be avoided since there's no reasonable way to predict which occurance
+ be avoided since there's no reasonable way to predict which occurrence
will be the first seen by the reader. It is better to use the
word ``processor'' instead.
\LaTeX{} provides a variety of environments even without the
additional markup provided by the Python-specific document classes
- introducted in the next section. The following environments are
+ introduced in the next section. The following environments are
provided as part of standard \LaTeX{} and are being used in the
standard Python documentation; descriptions will be added here as
time allows.
\end{envdesc}
\begin{envdesc}{excclassdesc}{\p{name}\p{constructor parameters}}
- Descibe an exception defined by a class. \var{constructor
+ Describe an exception defined by a class. \var{constructor
parameters} should not include the \var{self} parameter or
the parentheses used in the call syntax. To describe an
exception class without describing the parameters to its
with release \var{version}. The text given as \var{what to do}
should recommend something to use instead. It should be
complete sentences. The entire deprecation notice will be
- presented as a separate paragraph; it should either preceed or
+ presented as a separate paragraph; it should either precede or
succeed the description of the deprecated feature.
\end{macrodesc}
\begin{envdesc}{notice}{\op{type}}
Label some paragraphs as being worthy of additional attention from
- the reader. What sort of attention is warrented can be indicated
+ the reader. What sort of attention is warranted can be indicated
by specifying the \var{type} of the notice. The only values
defined for \var{type} are \code{note} and \code{warning}; these
are equivalent in intent to the inline markup of the same name.
\begin{envdesc}{productionlist}{\op{language}}
This environment is used to enclose a group of productions. The
two macros are only defined within this environment. If a
- document descibes more than one language, the optional parameter
+ document describes more than one language, the optional parameter
\var{language} should be used to distinguish productions between
languages. The value of the parameter should be a short name
that can be used as part of a filename; colons or other
a complete sequence of menu selections, including selecting
submenus and choosing a specific operation, or any subsequence of
such a sequence. The names of individual selections should be
- separated by occurances of \macro{sub}.
+ separated by occurrences of \macro{sub}.
For example, to mark the selection ``\menuselection{Start \sub
Programs}'', use this markup:
fairly rough.
The timeframe for the conversion is not clear since there doesn't
- seem to be much time available to work on this, but the appearant
+ seem to be much time available to work on this, but the apparent
benefits are growing more substantial at a moderately rapid pace.
of Monty Python fans...) and let's say we want to create a Python
interface to the C library function \cfunction{system()}.\footnote{An
interface for this function already exists in the standard module
-\module{os} --- it was chosen as a simple and straightfoward example.}
+\module{os} --- it was chosen as a simple and straightforward example.}
This function takes a null-terminated character string as argument and
returns an integer. We want this function to be callable from Python
as follows:
\cfunction{Py_INCREF()}.
The object reference returned from a C function that is called from
-Python must be an owned reference --- ownership is tranferred from the
-function to its caller.
+Python must be an owned reference --- ownership is transferred from
+the function to its caller.
\subsection{Thin Ice
linked by the C compiler, global or static objects with constructors
cannot be used. This is not a problem if the main program is linked
by the \Cpp{} compiler. Functions that will be called by the
-Python interpreter (in particular, module initalization functions)
+Python interpreter (in particular, module initialization functions)
have to be declared using \code{extern "C"}.
It is unnecessary to enclose the Python header files in
\code{extern "C" \{...\}} --- they use this form already if the symbol
%\end{abstract}
-% The ugly "%begin{latexonly}" pseudo-environment supresses the table
+% The ugly "%begin{latexonly}" pseudo-environment suppresses the table
% of contents for HTML generation.
%
%begin{latexonly}
The visitor pattern is ... The \refmodule{compiler} package uses a
variant on the visitor pattern that takes advantage of Python's
-introspection features to elminiate the need for much of the visitor's
+introspection features to eliminate the need for much of the visitor's
infrastructure.
The classes being visited do not need to be programmed to accept
Of course, as email has been deployed worldwide, it has become
internationalized, such that language specific character sets can now
be used in email messages. The base standard still requires email
-messages to be transfered using only 7-bit \ASCII{} characters, so a
+messages to be transferred using only 7-bit \ASCII{} characters, so a
slew of RFCs have been written describing how to encode email
containing non-\ASCII{} characters into \rfc{2822}-compliant format.
These RFCs include \rfc{2045}, \rfc{2046}, \rfc{2047}, and \rfc{2231}.
Starting with Python 2.3 the \module{bsddb} module requires the
Berkeley DB library version 3.2 or later (it is known to work with 3.2
-thru 4.3 at the time of this writing).
+through 4.3 at the time of this writing).
\begin{seealso}
\seeurl{http://pybsddb.sourceforge.net/}{Website with documentation
methods of the player object are described below. The device is the
name of the SCSI device file, e.g. \code{'/dev/scsi/sc0d4l0'}, or
\code{None}. If omitted or \code{None}, the hardware inventory is
-consulted to locate a CD-ROM drive. The \var{mode}, if not omited,
+consulted to locate a CD-ROM drive. The \var{mode}, if not omitted,
should be the string \code{'r'}.
\end{funcdesc}
\begin{seealso}
\seetext{Kahan, W: Branch cuts for complex elementary functions;
- or, Much ado about nothings's sign bit. In Iserles, A.,
+ or, Much ado about nothing's sign bit. In Iserles, A.,
and Powell, M. (eds.), \citetitle{The state of the art in
numerical analysis}. Clarendon Press (1987) pp165-211.}
\end{seealso}
\lineiv{unicode_internal}
{}
{Unicode string}
- {Return the internal represenation of the operand}
+ {Return the internal representation of the operand}
\lineiv{uu_codec}
{uu}
\end{funcdesc}
\begin{classdesc}{Compile}{}
-Instances of this class have \method{__call__()} methods indentical in
+Instances of this class have \method{__call__()} methods identical in
signature to the built-in function \function{compile()}, but with the
difference that if the instance compiles program text containing a
\module{__future__} statement, the instance 'remembers' and compiles
switched off by default.
The easiest way to provide your own policy is to override this class
-and call its methods in your overriden implementations before adding
+and call its methods in your overridden implementations before adding
your own additional checks:
\begin{verbatim}
\constant{KEY_F2}, \constant{KEY_F3}, \constant{KEY_F4}) available,
and the arrow keys mapped to \constant{KEY_UP}, \constant{KEY_DOWN},
\constant{KEY_LEFT} and \constant{KEY_RIGHT} in the obvious way. If
-your machine has a PC keybboard, it is safe to expect arrow keys and
+your machine has a PC keyboard, it is safe to expect arrow keys and
twelve function keys (older PC keyboards may have only ten function
keys); also, the following keypad mappings are standard:
Each tuple is of the form \code{(\var{tag}, \var{i1}, \var{i2},
\var{j1}, \var{j2})}. The first tuple has \code{\var{i1} ==
\var{j1} == 0}, and remaining tuples have \var{i1} equal to the
- \var{i2} from the preceeding tuple, and, likewise, \var{j1} equal to
+ \var{i2} from the preceding tuple, and, likewise, \var{j1} equal to
the previous \var{j2}.
The \var{tag} values are strings, with these meanings:
\begin{memberdesc}{indent}
The example's indentation in the containing string, i.e., the
- number of space characters that preceed the example's first
+ number of space characters that precede the example's first
prompt.
\end{memberdesc}
when reading the initial script or standard input (also
interactively).
- Instances of this class have atttributes \member{filename},
+ Instances of this class have attributes \member{filename},
\member{lineno}, \member{offset} and \member{text} for easier access
to the details. \function{str()} of the exception instance returns
only the message.
\begin{methoddesc}[dircmp]{report_partial_closure}{}
Print a comparison between \var{a} and \var{b} and common immediate
-subdirctories.
+subdirectories.
\end{methoddesc}
\begin{methoddesc}[dircmp]{report_full_closure}{}
Print a comparison between \var{a} and \var{b} and common
-subdirctories (recursively).
+subdirectories (recursively).
\end{methoddesc}
being compared.
Note that via \method{__getattr__()} hooks, all attributes are
-computed lazilly, so there is no speed penalty if only those
+computed lazily, so there is no speed penalty if only those
attributes which are lightweight to compute are used.
\begin{memberdesc}[dircmp]{left_list}
argument is it -- the future statements in effect around the call to
compile are ignored.
- Future statemants are specified by bits which can be bitwise or-ed
+ Future statements are specified by bits which can be bitwise or-ed
together to specify multiple statements. The bitfield required to
specify a given feature can be found as the \member{compiler_flag}
attribute on the \class{_Feature} instance in the
\begin{itemize}
\item \code{'f'} --- Open the database in fast mode. Writes to the database
- will not be syncronized.
+ will not be synchronized.
\item \code{'s'} --- Synchronized mode. This will cause changes to the database
will be immediately written to the file.
\item \code{'u'} --- Do not lock database.
Profile a single call of a callable.
Additional positional and keyword arguments may be passed
along; the result of the call is returned, and exceptions are
-allowed to propogate cleanly, while ensuring that profiling is
+allowed to propagate cleanly, while ensuring that profiling is
disabled on the way out.
\end{methoddesc}
\code{uid search} corresponds to \code{search}. The \code{thread}
command first searches the mailbox for messages that match the given
searching criteria using the charset argument for the interpretation
- of strings in the searching criteria. It thren returns the matching
+ of strings in the searching criteria. It then returns the matching
messages threaded according to the specified threading algorithm.
This is an \samp{IMAP4rev1} extension command. \versionadded{2.4}
simply dropping or duplicating pixels, so the result will be less than
perfect, especially for computer-generated images.
-Alternatively, you can specify a filter to use to smoothen the image
+Alternatively, you can specify a filter to use to smooth the image
after scaling. The filter forms supported are \code{'impulse'},
\code{'box'}, \code{'triangle'}, \code{'quadratic'} and
\code{'gaussian'}. If a filter is specified \var{blur} is an optional
\begin{seealso}
- \seemodule{email}{Comprehensive email handling package; supercedes
+ \seemodule{email}{Comprehensive email handling package; supersedes
the \module{mimetools} module.}
\seemodule{rfc822}{Provides the base class for
\class{mimetools.Message}.}
own pattern for section-divider and end-marker lines.
\begin{seealso}
- \seemodule{email}{Comprehensive email handling package; supercedes
+ \seemodule{email}{Comprehensive email handling package; supersedes
the \module{multifile} module.}
\end{seealso}
Note that unlike the built-in \function{cmp()}, these functions can
return any value, which may or may not be interpretable as a Boolean
value. See the \citetitle[../ref/ref.html]{Python Reference Manual}
-for more informations about rich comparisons.
+for more information about rich comparisons.
\versionadded{2.2}
\end{funcdesc}
raises \exception{OSSAudioError} if not. Returns a tuple (\var{format},
\var{nchannels}, \var{samplerate}) indicating the parameter values that
were actually set by the device driver (i.e., the same as the return
-valus of \method{setfmt()}, \method{channels()}, and \method{speed()}).
+values of \method{setfmt()}, \method{channels()}, and \method{speed()}).
For example,
\begin{verbatim}
\begin{funcdesc}{architecture}{executable=sys.executable, bits='', linkage=''}
Queries the given executable (defaults to the Python interpreter
- binary) for various architecture informations.
+ binary) for various architecture information.
Returns a tuple \code{(bits, linkage)} which contain information about
the bit architecture and the linkage format used for the
affecting the presentation) as the keys; if an object needs to be
presented which is already represented in \var{context}, the third
return value should be true. Recursive calls to the \method{format()}
-method should add additionaly entries for containers to this
+method should add additional entries for containers to this
dictionary. The fourth argument, \var{maxlevels}, gives the requested
limit to recursion; this will be \code{0} if there is no requested
limit. This argument should be passed unmodified to recursive calls.
\end{methoddesc}
\begin{methoddesc}[xmlparser]{EndDoctypeDeclHandler}{}
-Called when Expat is done parsing the document type delaration.
+Called when Expat is done parsing the document type declaration.
This requires Expat version 1.2 or newer.
\end{methoddesc}
of the entity; this will be \code{None} for external entities. The
\var{notationName} parameter will be \code{None} for parsed entities,
and the name of the notation for unparsed entities.
-\var{is_parameter_entity} will be true if the entity is a paremeter
+\var{is_parameter_entity} will be true if the entity is a parameter
entity or false for general entities (most applications only need to
be concerned with general entities).
This is only available starting with version 1.95.0 of the Expat
The integer index of the last matched capturing group, or \code{None}
if no group was matched at all. For example, the expressions
\regexp{(a)b}, \regexp{((a)(b))}, and \regexp{((ab))} will have
-\code{lastindex == 1} if applyied to the string \code{'ab'},
+\code{lastindex == 1} if applied to the string \code{'ab'},
while the expression \regexp{(a)(b)} will have \code{lastindex == 2},
-if applyied to the same string.
+if applied to the same string.
\end{memberdesc}
\begin{memberdesc}[MatchObject]{lastgroup}
Returns a tuple \code{(\var{soft}, \var{hard})} with the current
soft and hard limits of \var{resource}. Raises \exception{ValueError} if
an invalid resource is specified, or \exception{error} if the
- underyling system call fails unexpectedly.
+ underlying system call fails unexpectedly.
\end{funcdesc}
\begin{funcdesc}{setrlimit}{resource, limits}
Raises \exception{ValueError} if an invalid resource is specified,
if the new soft limit exceeds the hard limit, or if a process tries
to raise its hard limit (unless the process has an effective UID of
- super-user). Can also raise \exception{error} if the underyling
+ super-user). Can also raise \exception{error} if the underlying
system call fails.
\end{funcdesc}
\begin{seealso}
- \seemodule{email}{Comprehensive email handling package; supercedes
+ \seemodule{email}{Comprehensive email handling package; supersedes
the \module{rfc822} module.}
\seemodule{mailbox}{Classes to read various mailbox formats produced
by end-user mail programs.}
\note{File objects on Windows are not acceptable, but sockets
are.\index{WinSock} On Windows, the underlying \cfunction{select()}
function is provided by the WinSock library, and does not handle file
-desciptors that don't originate from WinSock.}
+descriptors that don't originate from WinSock.}
\end{funcdesc}
\subsection{Polling Objects
for the underlying database. As a side-effect, an extension may be added to
the filename and more than one file may be created. By default, the
underlying database file is opened for reading and writing. The optional
-{}\var{flag} pararameter has the same interpretation as the \var{flag}
+{}\var{flag} parameter has the same interpretation as the \var{flag}
parameter of \function{anydbm.open}.
By default, version 0 pickles are used to serialize values.
\code{'xyzzy'}, \code{"frobozz"}. See chapter 2 of the
\citetitle[../ref/strings.html]{Python Reference Manual} for more about
string literals. Unicode strings are much like strings, but are
-specified in the syntax using a preceeding \character{u} character:
+specified in the syntax using a preceding \character{u} character:
\code{u'abc'}, \code{u"def"}. Lists are constructed with square brackets,
separating items with commas: \code{[a, b, c]}. Tuples are
constructed by the comma operator (not within square brackets), with
\code{\var{s}+=\var{t}}. When applicable, this optimization makes
quadratic run-time much less likely. This optimization is both version
and implementation dependent. For performance sensitive code, it is
-preferrable to use the \method{str.join()} method which assures consistent
+preferable to use the \method{str.join()} method which assures consistent
linear concatenation performance across versions and implementations.
\versionchanged[Formerly, string concatenation never occurred in-place]{2.4}
\lineiii{i}{Signed integer decimal.}{}
\lineiii{o}{Unsigned octal.}{(1)}
\lineiii{u}{Unsigned decimal.}{}
- \lineiii{x}{Unsigned hexidecimal (lowercase).}{(2)}
- \lineiii{X}{Unsigned hexidecimal (uppercase).}{(2)}
+ \lineiii{x}{Unsigned hexadecimal (lowercase).}{(2)}
+ \lineiii{X}{Unsigned hexadecimal (uppercase).}{(2)}
\lineiii{e}{Floating point exponential format (lowercase).}{}
\lineiii{E}{Floating point exponential format (uppercase).}{}
\lineiii{f}{Floating point decimal format.}{}
A set is greater than another set if and only if the first set is a proper
superset of the second set (is a superset, but is not equal).
-Instanceas of \class{set} are compared to instances of \class{frozenset} based
+Instances of \class{set} are compared to instances of \class{frozenset} based
on their members. For example, \samp{set('abc') == frozenset('abc')} returns
\code{True}.
\begin{itemize}
\item[std and dst]
Three or more alphanumerics giving the timezone abbreviations.
- These will be propogated into time.tzname
+ These will be propagated into time.tzname
\item[offset]
The offset has the form: \plusminus{} hh[:mm[:ss]].
This indicates the value added the local time to arrive at UTC.
If preceded by a '-', the timezone is east of the Prime
Meridian; otherwise, it is west. If no offset follows
- dst, summmer time is assumed to be one hour ahead of standard time.
+ dst, summer time is assumed to be one hour ahead of standard time.
\item[start[/time],end[/time]]
Indicates when to change to and back from DST. The format of the
\begin{methoddesc}[TestCase]{debug}{}
Run the test without collecting the result. This allows exceptions
- raised by the test to be propogated to the caller, and can be used
+ raised by the test to be propagated to the caller, and can be used
to support running tests under a debugger.
\end{methoddesc}
defining all but \method{__delitem__} will preclude only \method{pop}
and \method{popitem} from the full interface.
-In addition to the four base methods, progessively more efficiency
+In addition to the four base methods, progressively more efficiency
comes with defining \method{__contains__()}, \method{__iter__()}, and
\method{iteritems()}.
\begin{excclassdesc}{Error}{}
Subclass of \exception{Exception}, this can be raised by
\function{uu.decode()} under various situations, such as described
- above, but also including a badly formated header, or truncated
+ above, but also including a badly formatted header, or truncated
input file.
\end{excclassdesc}
\function{resetwarnings()}.
The printing of warning messages is done by calling
-\function{showwarning()}, which may be overidden; the default
+\function{showwarning()}, which may be overridden; the default
implementation of this function formats the message by calling
\function{formatwarning()}, which is also available for use by custom
implementations.
everything an XML-RPC client developer needs to know.}
\seetitle[http://xmlrpc-c.sourceforge.net/hacks.php]
{XML-RPC-Hacks page}{Extensions for various open-source
- libraries to support instrospection and multicall.}
+ libraries to support introspection and multicall.}
\end{seealso}
\end{classdesc*}
\begin{classdesc}{ZipInfo}{\optional{filename\optional{, date_time}}}
- Class used the represent infomation about a member of an archive.
+ Class used to represent information about a member of an archive.
Instances of this class are returned by the \method{getinfo()} and
\method{infolist()} methods of \class{ZipFile} objects. Most users
of the \module{zipfile} module will not need to create these, but
relevant email and MIME related RFCs.
\end{abstract}
-% The ugly "%begin{latexonly}" pseudo-environment supresses the table
+% The ugly "%begin{latexonly}" pseudo-environment suppresses the table
% of contents for HTML generation.
%
%begin{latexonly}
relevant email and MIME related RFCs.
This document describes version 3.0 of the \module{email} package, which is
-distributed with Python 2.4 and is availble as a standalone distutils-based
+distributed with Python 2.4 and is available as a standalone distutils-based
package for use with Python 2.3. \module{email} 3.0 is not compatible with
Python versions earlier than 2.3. For more information about the
\module{email} package, including download links and mailing lists, see
Python programmers using the \refmodule{Tkinter} module, and its
extension, the \refmodule{Tix} module.
-The \refmodule{Tkinter} module is a thin object--oriented layer on top of
+The \refmodule{Tkinter} module is a thin object-oriented layer on top of
Tcl/Tk. To use \refmodule{Tkinter}, you don't need to write Tcl code,
but you will need to consult the Tk documentation, and occasionally
the Tcl documentation. \refmodule{Tkinter} is a set of wrappers that
\begin{classdesc}{Tk}{screenName=None, baseName=None, className='Tk', useTk=1}
The \class{Tk} class is instantiated without arguments.
This creates a toplevel widget of Tk which usually is the main window
-of an appliation. Each instance has its own associated Tcl interpreter.
+of an application. Each instance has its own associated Tcl interpreter.
% FIXME: The following keyword arguments are currently recognized:
\versionchanged[The \var{useTk} parameter was added]{2.4}
\end{classdesc}
fred["fg"] = "red"
fred["bg"] = "blue"
\end{verbatim}
-\item[Use the config() method to update multiple attrs subesequent to
+\item[Use the config() method to update multiple attrs subsequent to
object creation]:
\begin{verbatim}
fred.config(fg = "red", bg = "blue")
self.button.bind("<Enter>", self.turnRed)
\end{verbatim}
-Notice how the widget field of the event is being accesed in the
+Notice how the widget field of the event is being accessed in the
\method{turnRed()} callback. This field contains the widget that
caught the X event. The following table lists the other event fields
you can access, and how they are denoted in Tk, which can be useful
widget can be used to display any data that have a hierarchical
structure, for example, file system directory trees. The list entries
are indented and connected by branch lines according to their places
-in the hierachy.
+in the hierarchy.
\end{classdesc}
% Python Demo of:
\begin{classdesc}{Tree}{}
The \ulink{Tree}
{http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixTree.htm}
-widget can be used to display hierachical data in a tree form. The
+widget can be used to display hierarchical data in a tree form. The
user can adjust the view of the tree by opening or closing parts of
the tree.
\end{classdesc}
horizontal lines; each line is composed of a series of items (texts,
bitmaps, images or spaces) arranged from left to right. For example, a
compound image can be used to display a bitmap and a text string
-simutaneously in a Tk \class{Button} widget.
+simultaneously in a Tk \class{Button} widget.
% Python Demo of:
% \ulink{Compound Image In Buttons}{http://tix.sourceforge.net/dist/current/demos/samples/CmpImg.tcl}
\end{methoddesc}
\begin{methoddesc}{tix_option_get}{name}
-Gets the options manitained by the Tix scheme mechanism.
+Gets the options maintained by the Tix scheme mechanism.
\end{methoddesc}
\begin{methoddesc}{tix_resetoptions}{newScheme, newFontSet\optional{,
\section{Idle \label{idle}}
%\declaremodule{standard}{idle}
-%\modulesynopsis{A Python Integrated Developement Environment}
+%\modulesynopsis{A Python Integrated Development Environment}
\moduleauthor{Guido van Rossum}{guido@Python.org}
Idle is the Python IDE built with the \refmodule{Tkinter} GUI toolkit.
\index{Idle}
\index{Python Editor}
-\index{Integrated Developement Environment}
+\index{Integrated Development Environment}
IDLE has the following features:
\end{methoddesc}
\begin{methoddesc}[Element]{setAttributeNode}{newAttr}
-Add a new attibute node to the element, replacing an existing
+Add a new attribute node to the element, replacing an existing
attribute if necessary if the \member{name} attribute matches. If a
replacement occurs, the old attribute node will be returned. If
\var{newAttr} is already in use, \exception{InuseAttributeErr} will be
\end{methoddesc}
\begin{methoddesc}[Element]{setAttributeNodeNS}{newAttr}
-Add a new attibute node to the element, replacing an existing
+Add a new attribute node to the element, replacing an existing
attribute if necessary if the \member{namespaceURI} and
\member{localName} attributes match. If a replacement occurs, the old
attribute node will be returned. If \var{newAttr} is already in use,
Return an attribute with a particular index. The order you get the
attributes in is arbitrary but will be consistent for the life of a
DOM. Each item is an attribute node. Get its value with the
-\member{value} attribbute.
+\member{value} attribute.
\end{methoddesc}
There are also experimental methods that give this class more mapping
\method{unlink()} is a \module{xml.dom.minidom}-specific extension to
the DOM API. After calling \method{unlink()} on a node, the node and
-its descendents are essentially useless.
+its descendants are essentially useless.
\begin{seealso}
\seetitle[http://www.w3.org/TR/REC-DOM-Level-1/]{Document Object
are available. This will cause FrameWork window updates and the user
interface to remain working during long computations, but will slow the
interpreter down and may cause surprising results in non-reentrant code
-(such as FrameWork itself). By default \var{async_dispatch} will immedeately
+(such as FrameWork itself). By default \var{async_dispatch} will immediately
call \var{our_dispatch} but you may override this to handle only certain
events asynchronously. Events you do not handle will be passed to Sioux
and such.
\platform{Mac}
\modulesynopsis{Constant definitions for many Mac OS error codes.}
-\module{macerrors} cotains constant definitions for many Mac OS error
+\module{macerrors} contains constant definitions for many Mac OS error
codes.
\item
When you waved the script icon over the \program{PythonInterpreter},
-the \program{PythonInterpreter} icon did not hilight. Most likely the
-Creator code and document type is unset (or set incorrectly) -- this
-often happens when a file originates on a non-Mac computer. See
+the \program{PythonInterpreter} icon did not highlight. Most likely
+the Creator code and document type is unset (or set incorrectly) --
+this often happens when a file originates on a non-Mac computer. See
section \ref{creator-code} for more details.
\end{itemize}
\begin{methoddesc}[object]{__get__}{self, instance, owner}
Called to get the attribute of the owner class (class attribute access)
-or of an instance of that class (instance attribute acces).
+or of an instance of that class (instance attribute access).
\var{owner} is always the owner class, while \var{instance} is the
instance that the attribute was accessed through, or \code{None} when
the attribute is accessed through the \var{owner}. This method should
dictionary to store the corresponding datum.
Restrictions on the types of the key values are listed earlier in
-section \ref{types}. (To summarize,the key type should be hashable,
+section \ref{types}. (To summarize, the key type should be hashable,
which excludes all mutable objects.) Clashes between duplicate keys
are not detected; the last datum (textually rightmost in the display)
stored for a given key value prevails.
\begin{notice}
In Python 2.2, the \keyword{yield} statement is only allowed
when the \code{generators} feature has been enabled. It will always
-be enabled in Python 2.3. This \code{__future__} import statment can
+be enabled in Python 2.3. This \code{__future__} import statement can
be used to enable the feature:
\begin{verbatim}
% Leave at least one blank line after this, to simplify ad-hoc tools
% that are sometimes used to massage these files.
-\modulesynopsis{This is a one-line descrition, for the chapter header.}
+\modulesynopsis{This is a one-line description, for the chapter header.}
% ==== 2. ====
% Exceptions are described using a ``excdesc'' block. This has only
% one parameter: the exception name. Exceptions defined as classes in
% the source code should be documented using this environment, but
-% constructor parameters must be ommitted.
+% constructor parameters must be omitted.
\begin{excdesc}{error}
Exception raised when an operation fails for a Spam specific reason.
__main__.MyError: 'oops!'
\end{verbatim}
-In this example, the default \method{__init__} of \class{Exception} has
-been overriden. The new behavior simply creates the \var{value} attribute.
-This replaces the default behavior of creating the \var{args} attribute.
+In this example, the default \method{__init__} of \class{Exception}
+has been overridden. The new behavior simply creates the \var{value}
+attribute. This replaces the default behavior of creating the
+\var{args} attribute.
Exception classes can be defined which do anything any other class can
do, but are usually kept simple, often only offering a number of
>>> import smtplib
>>> server = smtplib.SMTP('localhost')
->>> server.sendmail('soothsayer@example.org', 'jceasar@example.org',
+>>> server.sendmail('soothsayer@example.org', 'jcaesar@example.org',
"""To: jcaesar@example.org
From: soothsayer@example.org
\url{http://starship.python.net/crew/mhammond/ce/} for more
information.
-Another new platform is Darwin/MacOS X; inital support for it is in
+Another new platform is Darwin/MacOS X; initial support for it is in
Python 2.0. Dynamic loading works, if you specify ``configure
--with-dyld --with-suffix=.x''. Consult the README in the Python
source distribution for more instructions.
configuration files, which only really work on Unix and leave Windows
and MacOS unsupported. Python users faced wildly differing
installation instructions which varied between different extension
-packages, which made adminstering a Python installation something of a
-chore.
+packages, which made administering a Python installation something of
+a chore.
The SIG for distribution utilities, shepherded by Greg Ward, has
created the Distutils, a system to make package installation much
(The magic methods are named after the corresponding Fortran operators
\code{.LT.}. \code{.LE.}, \&c. Numeric programmers are almost
-certainly quite familar with these names and will find them easy to
+certainly quite familiar with these names and will find them easy to
remember.)
Each of these magic methods is of the form \code{\var{method}(self,
On MacOS, most toolbox modules have been weaklinked to improve
backward compatibility. This means that modules will no longer fail
-to load if a single routine is missing on the curent OS version.
+to load if a single routine is missing on the current OS version.
Instead calling the missing routine will raise an exception.
(Contributed by Jack Jansen.)
In order to store cookies across sessions, two implementations of
cookie jars are provided: one that stores cookies in the Netscape
format so applications can use the Mozilla or Lynx cookie files, and
-one that stores cookies in the same format as the Perl libwww libary.
+one that stores cookies in the same format as the Perl libwww library.
\module{urllib2} has been changed to interact with \module{cookielib}:
\class{HTTPCookieProcessor} manages a cookie jar that is used when
projects / python / commitdiff