1
<?xml version="1.0" encoding="ascii"?>
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
"DTD/xhtml1-transitional.dtd">
4
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
7
<link rel="stylesheet" href="epydoc.css" type="text/css" />
8
<script type="text/javascript" src="epydoc.js"></script>
11
<body bgcolor="white" text="black" link="blue" vlink="#204080"
13
<!-- ==================== NAVIGATION BAR ==================== -->
14
<table class="navbar" border="0" width="100%" cellpadding="0"
15
bgcolor="#a0c0ff" cellspacing="0">
18
<th> <a
19
href="babel-module.html">Home</a> </th>
22
<th> <a
23
href="module-tree.html">Trees</a> </th>
26
<th> <a
27
href="identifier-index.html">Indices</a> </th>
30
<th bgcolor="#70b0f0" class="navbar-select"
31
> Help </th>
33
<!-- Project homepage -->
34
<th class="navbar" align="right" width="100%">
35
<table border="0" cellpadding="0" cellspacing="0">
36
<tr><th class="navbar" align="center"
37
><a class="navbar" target="_top" href="../index.html">Documentation Index</a></th>
41
<table width="100%" cellpadding="0" cellspacing="0">
43
<td width="100%"> </td>
45
<table cellpadding="0" cellspacing="0">
46
<!-- hide/show private -->
52
<h1 class="epydoc"> API Documentation </h1>
54
<p> This document contains the API (Application Programming Interface)
55
documentation for Documentation Index. Documentation for the Python
56
objects defined by the project is divided into separate pages for each
57
package, module, and class. The API documentation also includes two
58
pages containing information about the project as a whole: a trees
59
page, and an index page. </p>
61
<h2> Object Documentation </h2>
63
<p>Each <strong>Package Documentation</strong> page contains: </p>
65
<li> A description of the package. </li>
66
<li> A list of the modules and sub-packages contained by the
68
<li> A summary of the classes defined by the package. </li>
69
<li> A summary of the functions defined by the package. </li>
70
<li> A summary of the variables defined by the package. </li>
71
<li> A detailed description of each function defined by the
73
<li> A detailed description of each variable defined by the
77
<p>Each <strong>Module Documentation</strong> page contains:</p>
79
<li> A description of the module. </li>
80
<li> A summary of the classes defined by the module. </li>
81
<li> A summary of the functions defined by the module. </li>
82
<li> A summary of the variables defined by the module. </li>
83
<li> A detailed description of each function defined by the
85
<li> A detailed description of each variable defined by the
89
<p>Each <strong>Class Documentation</strong> page contains: </p>
91
<li> A class inheritance diagram. </li>
92
<li> A list of known subclasses. </li>
93
<li> A description of the class. </li>
94
<li> A summary of the methods defined by the class. </li>
95
<li> A summary of the instance variables defined by the class. </li>
96
<li> A summary of the class (static) variables defined by the
98
<li> A detailed description of each method defined by the
100
<li> A detailed description of each instance variable defined by the
102
<li> A detailed description of each class (static) variable defined
106
<h2> Project Documentation </h2>
108
<p> The <strong>Trees</strong> page contains the module and class hierarchies: </p>
110
<li> The <em>module hierarchy</em> lists every package and module, with
111
modules grouped into packages. At the top level, and within each
112
package, modules and sub-packages are listed alphabetically. </li>
113
<li> The <em>class hierarchy</em> lists every class, grouped by base
114
class. If a class has more than one base class, then it will be
115
listed under each base class. At the top level, and under each base
116
class, classes are listed alphabetically. </li>
119
<p> The <strong>Index</strong> page contains indices of terms and
122
<li> The <em>term index</em> lists every term indexed by any object's
123
documentation. For each term, the index provides links to each
124
place where the term is indexed. </li>
125
<li> The <em>identifier index</em> lists the (short) name of every package,
126
module, class, method, function, variable, and parameter. For each
127
identifier, the index provides a short description, and a link to
128
its documentation. </li>
131
<h2> The Table of Contents </h2>
133
<p> The table of contents occupies the two frames on the left side of
134
the window. The upper-left frame displays the <em>project
135
contents</em>, and the lower-left frame displays the <em>module
138
<table class="help summary" border="1" cellspacing="0" cellpadding="3">
139
<tr style="height: 30%">
140
<td align="center" style="font-size: small">
141
Project<br />Contents<hr />...</td>
142
<td align="center" style="font-size: small" rowspan="2" width="70%">
143
API<br />Documentation<br />Frame<br /><br /><br />
147
<td align="center" style="font-size: small">
148
Module<br />Contents<hr /> <br />...<br />
153
<p> The <strong>project contents frame</strong> contains a list of all packages
154
and modules that are defined by the project. Clicking on an entry
155
will display its contents in the module contents frame. Clicking on a
156
special entry, labeled "Everything," will display the contents of
157
the entire project. </p>
159
<p> The <strong>module contents frame</strong> contains a list of every
160
submodule, class, type, exception, function, and variable defined by a
161
module or package. Clicking on an entry will display its
162
documentation in the API documentation frame. Clicking on the name of
163
the module, at the top of the frame, will display the documentation
164
for the module itself. </p>
166
<p> The "<strong>frames</strong>" and "<strong>no frames</strong>" buttons below the top
167
navigation bar can be used to control whether the table of contents is
168
displayed or not. </p>
170
<h2> The Navigation Bar </h2>
172
<p> A navigation bar is located at the top and bottom of every page.
173
It indicates what type of page you are currently viewing, and allows
174
you to go to related pages. The following table describes the labels
175
on the navigation bar. Note that not some labels (such as
176
[Parent]) are not displayed on all pages. </p>
178
<table class="summary" border="1" cellspacing="0" cellpadding="3" width="100%">
181
<th>Highlighted when...</th>
184
<tr><td valign="top"><strong>[Parent]</strong></td>
185
<td valign="top"><em>(never highlighted)</em></td>
186
<td valign="top"> the parent of the current package </td></tr>
187
<tr><td valign="top"><strong>[Package]</strong></td>
188
<td valign="top">viewing a package</td>
189
<td valign="top">the package containing the current object
191
<tr><td valign="top"><strong>[Module]</strong></td>
192
<td valign="top">viewing a module</td>
193
<td valign="top">the module containing the current object
195
<tr><td valign="top"><strong>[Class]</strong></td>
196
<td valign="top">viewing a class </td>
197
<td valign="top">the class containing the current object</td></tr>
198
<tr><td valign="top"><strong>[Trees]</strong></td>
199
<td valign="top">viewing the trees page</td>
200
<td valign="top"> the trees page </td></tr>
201
<tr><td valign="top"><strong>[Index]</strong></td>
202
<td valign="top">viewing the index page</td>
203
<td valign="top"> the index page </td></tr>
204
<tr><td valign="top"><strong>[Help]</strong></td>
205
<td valign="top">viewing the help page</td>
206
<td valign="top"> the help page </td></tr>
209
<p> The "<strong>show private</strong>" and "<strong>hide private</strong>" buttons below
210
the top navigation bar can be used to control whether documentation
211
for private objects is displayed. Private objects are usually defined
212
as objects whose (short) names begin with a single underscore, but do
213
not end with an underscore. For example, "<code>_x</code>",
214
"<code>__pprint</code>", and "<code>epydoc.epytext._tokenize</code>"
215
are private objects; but "<code>re.sub</code>",
216
"<code>__init__</code>", and "<code>type_</code>" are not. However,
217
if a module defines the "<code>__all__</code>" variable, then its
218
contents are used to decide which objects are private. </p>
220
<p> A timestamp below the bottom navigation bar indicates when each
221
page was last updated. </p>
222
<!-- ==================== NAVIGATION BAR ==================== -->
223
<table class="navbar" border="0" width="100%" cellpadding="0"
224
bgcolor="#a0c0ff" cellspacing="0">
227
<th> <a
228
href="babel-module.html">Home</a> </th>
231
<th> <a
232
href="module-tree.html">Trees</a> </th>
235
<th> <a
236
href="identifier-index.html">Indices</a> </th>
239
<th bgcolor="#70b0f0" class="navbar-select"
240
> Help </th>
242
<!-- Project homepage -->
243
<th class="navbar" align="right" width="100%">
244
<table border="0" cellpadding="0" cellspacing="0">
245
<tr><th class="navbar" align="center"
246
><a class="navbar" target="_top" href="../index.html">Documentation Index</a></th>
250
<table border="0" cellpadding="0" cellspacing="0" width="100%%">
252
<td align="left" class="footer">
253
Generated by Epydoc 3.0.1 on Thu Mar 17 15:12:44 2011
255
<td align="right" class="footer">
256
<a target="mainFrame" href="http://epydoc.sourceforge.net"
257
>http://epydoc.sourceforge.net</a>
262
<script type="text/javascript">
264
// Private objects are initially displayed (because if
265
// javascript is turned off then we want them to be
266
// visible); but by default, we want to hide them. So hide
267
// them unless we have a cookie that says to show them.