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 bgcolor="#70b0f0" class="navbar-select"
19
> Home </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> <a
31
href="help.html">Help</a> </th>
33
<th class="navbar" width="100%"></th>
36
<table width="100%" cellpadding="0" cellspacing="0">
39
<span class="breadcrumbs">
44
<table cellpadding="0" cellspacing="0">
45
<!-- hide/show private -->
46
<tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
47
onclick="toggle_private();">hide private</a>]</span></td></tr>
48
<tr><td align="right"><span class="options"
49
>[<a href="frames.html" target="_top">frames</a
50
>] | <a href="example-module.html"
51
target="_top">no frames</a>]</span></td></tr>
56
<!-- ==================== MODULE DESCRIPTION ==================== -->
57
<h1 class="epydoc">Module example</h1><p class="nomargin-top"><span class="codelink"><a href="example-pysrc.html">source code</a></span></p>
58
<p>This is the docstring for the example.py module. Modules names should
59
have short, all-lowercase names. The module name may have underscores if
60
this improves readability.</p>
61
<p>Every module should have a docstring at the very top of the file. The
62
module's docstring may extend over multiple lines. If your docstring does
63
extend over multiple lines, the closing three quotation marks must be on
64
a line by itself, preferably preceeded by a blank line.</p>
66
<!-- ==================== FUNCTIONS ==================== -->
67
<a name="section-Functions"></a>
68
<table class="summary" border="1" cellpadding="3"
69
cellspacing="0" width="100%" bgcolor="white">
70
<tr bgcolor="#70b0f0" class="table-header">
71
<td colspan="2" class="table-header">
72
<table border="0" cellpadding="0" cellspacing="0" width="100%">
74
<td align="left"><span class="table-header">Functions</span></td>
75
<td align="right" valign="top"
76
><span class="options">[<a href="#section-Functions"
77
class="privatelink" onclick="toggle_private();"
78
>hide private</a>]</span></td>
84
<td width="15%" align="right" valign="top" class="summary">
85
<span class="summary-type"> </span>
86
</td><td class="summary">
87
<table width="100%" cellpadding="0" cellspacing="0" border="0">
89
<td><span class="summary-sig"><a href="example-module.html#foo" class="summary-sig-name">foo</a>(<span class="summary-sig-arg">var1</span>,
90
<span class="summary-sig-arg">var2</span>,
91
<span class="summary-sig-arg">long_var_name</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string">hi</code><code class="variable-quote">'</code></span>)</span><br />
92
One-line summary or signature.</td>
93
<td align="right" valign="top">
94
<span class="codelink"><a href="example-pysrc.html#foo">source code</a></span>
103
<td width="15%" align="right" valign="top" class="summary">
104
<span class="summary-type"> </span>
105
</td><td class="summary">
106
<table width="100%" cellpadding="0" cellspacing="0" border="0">
108
<td><span class="summary-sig"><a href="example-module.html#newfunc" class="summary-sig-name">newfunc</a>()</span><br />
110
<td align="right" valign="top">
111
<span class="codelink"><a href="example-pysrc.html#newfunc">source code</a></span>
120
<td width="15%" align="right" valign="top" class="summary">
121
<span class="summary-type"> </span>
122
</td><td class="summary">
123
<table width="100%" cellpadding="0" cellspacing="0" border="0">
125
<td><span class="summary-sig"><a href="example-module.html#otherfunc" class="summary-sig-name">otherfunc</a>()</span><br />
127
<td align="right" valign="top">
128
<span class="codelink"><a href="example-pysrc.html#otherfunc">source code</a></span>
137
<!-- ==================== FUNCTION DETAILS ==================== -->
138
<a name="section-FunctionDetails"></a>
139
<table class="details" border="1" cellpadding="3"
140
cellspacing="0" width="100%" bgcolor="white">
141
<tr bgcolor="#70b0f0" class="table-header">
142
<td colspan="2" class="table-header">
143
<table border="0" cellpadding="0" cellspacing="0" width="100%">
145
<td align="left"><span class="table-header">Function Details</span></td>
146
<td align="right" valign="top"
147
><span class="options">[<a href="#section-FunctionDetails"
148
class="privatelink" onclick="toggle_private();"
149
>hide private</a>]</span></td>
157
<table class="details" border="1" cellpadding="3"
158
cellspacing="0" width="100%" bgcolor="white">
160
<table width="100%" cellpadding="0" cellspacing="0" border="0">
161
<tr valign="top"><td>
162
<h3 class="epydoc"><span class="sig"><span class="sig-name">foo</span>(<span class="sig-arg">var1</span>,
163
<span class="sig-arg">var2</span>,
164
<span class="sig-arg">long_var_name</span>=<span class="sig-default"><code class="variable-quote">'</code><code class="variable-string">hi</code><code class="variable-quote">'</code></span>)</span>
166
</td><td align="right" valign="top"
167
><span class="codelink"><a href="example-pysrc.html#foo">source code</a></span>
171
<p>One-line summary or signature.</p>
172
<p>Several sentences providing an extended description. You can put
173
text in mono-spaced type like so: <tt class="rst-docutils literal"><span class="pre">var</span></tt>.</p>
174
<div class="rst-section" id="rst-parameters">
175
<h1 class="heading">Parameters</h1>
176
<dl class="rst-docutils">
177
<dt>var1 <span class="classifier-delimiter">:</span> <span class="rst-classifier">array_like</span></dt>
178
<dd>Array_like means all those objects -- lists, nested lists, etc. --
179
that can be converted to an array.</dd>
180
<dt>var2 <span class="classifier-delimiter">:</span> <span class="rst-classifier">integer</span></dt>
181
<dd>Write out the full type</dd>
182
<dt>long_variable_name <span class="classifier-delimiter">:</span> <span class="rst-classifier">{'hi', 'ho'}, optional</span></dt>
183
<dd>Choices in brackets, default first when optional.</dd>
186
<div class="rst-section" id="rst-returns">
187
<h1 class="heading">Returns</h1>
188
<dl class="rst-docutils">
189
<dt>named <span class="classifier-delimiter">:</span> <span class="rst-classifier">type</span></dt>
196
<dd>even more explaining</dd>
199
<div class="rst-section" id="rst-other-parameters">
200
<h1 class="heading">Other Parameters</h1>
201
<dl class="rst-docutils">
202
<dt>only_seldom_used_keywords <span class="classifier-delimiter">:</span> <span class="rst-classifier">type</span></dt>
204
<dt>common_parametrs_listed_above <span class="classifier-delimiter">:</span> <span class="rst-classifier">type</span></dt>
208
<div class="rst-section" id="rst-see-also">
209
<h1 class="heading">See Also</h1>
210
<p>otherfunc : relationship (optional)
211
newfunc : relationship (optional)</p>
213
<div class="rst-section" id="rst-notes">
214
<h1 class="heading">Notes</h1>
215
<p>Notes about the implementation algorithm (if needed).</p>
216
<p>This can have multiple paragraphs as can all sections.</p>
218
<div class="rst-section" id="rst-examples">
219
<h1 class="heading">Examples</h1>
220
<p>examples in doctest format</p>
221
<pre class="py-doctest">
222
<span class="py-prompt">>>> </span>a=[1,2,3]
223
<span class="py-prompt">>>> </span>[x + 3 <span class="py-keyword">for</span> x <span class="py-keyword">in</span> a]
224
<span class="py-output">[4, 5, 6]</span></pre>
230
<a name="newfunc"></a>
232
<table class="details" border="1" cellpadding="3"
233
cellspacing="0" width="100%" bgcolor="white">
235
<table width="100%" cellpadding="0" cellspacing="0" border="0">
236
<tr valign="top"><td>
237
<h3 class="epydoc"><span class="sig"><span class="sig-name">newfunc</span>()</span>
239
</td><td align="right" valign="top"
240
><span class="codelink"><a href="example-pysrc.html#newfunc">source code</a></span>
245
<p>I never saw a purple cow.</p>
250
<a name="otherfunc"></a>
252
<table class="details" border="1" cellpadding="3"
253
cellspacing="0" width="100%" bgcolor="white">
255
<table width="100%" cellpadding="0" cellspacing="0" border="0">
256
<tr valign="top"><td>
257
<h3 class="epydoc"><span class="sig"><span class="sig-name">otherfunc</span>()</span>
259
</td><td align="right" valign="top"
260
><span class="codelink"><a href="example-pysrc.html#otherfunc">source code</a></span>
265
<p>I never hope to see one.</p>
271
<!-- ==================== NAVIGATION BAR ==================== -->
272
<table class="navbar" border="0" width="100%" cellpadding="0"
273
bgcolor="#a0c0ff" cellspacing="0">
276
<th bgcolor="#70b0f0" class="navbar-select"
277
> Home </th>
280
<th> <a
281
href="module-tree.html">Trees</a> </th>
284
<th> <a
285
href="identifier-index.html">Indices</a> </th>
288
<th> <a
289
href="help.html">Help</a> </th>
291
<th class="navbar" width="100%"></th>
294
<table border="0" cellpadding="0" cellspacing="0" width="100%%">
296
<td align="left" class="footer">
297
Generated by Epydoc 3.0beta1 on Tue Jan 22 00:26:36 2008
299
<td align="right" class="footer">
300
<a target="mainFrame" href="http://epydoc.sourceforge.net"
301
>http://epydoc.sourceforge.net</a>
306
<script type="text/javascript">
308
// Private objects are initially displayed (because if
309
// javascript is turned off then we want them to be
310
// visible); but by default, we want to hide them. So hide
311
// them unless we have a cookie that says to show them.