~ubuntu-branches/debian/lenny/epydoc/lenny

« back to all changes in this revision

Viewing changes to doc/api/epydoc.apidoc.DocIndex-class.html

  • Committer: Bazaar Package Importer
  • Author(s): Kenneth J. Pronovici
  • Date: 2008-02-03 13:22:12 UTC
  • mfrom: (1.2.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20080203132212-u2uohl6rswmlz2ra
Tags: 3.0.1-1
* New upstream release.
* Removed #! from top of epydoc/gui.py
* Got rid of version mangling in debian/watch.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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">
 
5
<head>
 
6
  <title>epydoc.apidoc.DocIndex</title>
 
7
  <link rel="stylesheet" href="epydoc.css" type="text/css" />
 
8
  <script type="text/javascript" src="epydoc.js"></script>
 
9
</head>
 
10
 
 
11
<body bgcolor="white" text="black" link="blue" vlink="#204080"
 
12
      alink="#204080">
 
13
<!-- ==================== NAVIGATION BAR ==================== -->
 
14
<table class="navbar" border="0" width="100%" cellpadding="0"
 
15
       bgcolor="#a0c0ff" cellspacing="0">
 
16
  <tr valign="middle">
 
17
  <!-- Home link -->
 
18
      <th>&nbsp;&nbsp;&nbsp;<a
 
19
        href="epydoc-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
 
20
 
 
21
  <!-- Tree link -->
 
22
      <th>&nbsp;&nbsp;&nbsp;<a
 
23
        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
 
24
 
 
25
  <!-- Index link -->
 
26
      <th>&nbsp;&nbsp;&nbsp;<a
 
27
        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
 
28
 
 
29
  <!-- Help link -->
 
30
      <th>&nbsp;&nbsp;&nbsp;<a
 
31
        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
 
32
 
 
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="http://epydoc.sourceforge.net">epydoc 3.0.1</a></th>
 
38
          </tr></table></th>
 
39
  </tr>
 
40
</table>
 
41
<table width="100%" cellpadding="0" cellspacing="0">
 
42
  <tr valign="top">
 
43
    <td width="100%">
 
44
      <span class="breadcrumbs">
 
45
        <a href="epydoc-module.html">Package&nbsp;epydoc</a> ::
 
46
        <a href="epydoc.apidoc-module.html">Module&nbsp;apidoc</a> ::
 
47
        Class&nbsp;DocIndex
 
48
      </span>
 
49
    </td>
 
50
    <td>
 
51
      <table cellpadding="0" cellspacing="0">
 
52
        <!-- hide/show private -->
 
53
        <tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
 
54
    onclick="toggle_private();">hide&nbsp;private</a>]</span></td></tr>
 
55
        <tr><td align="right"><span class="options"
 
56
            >[<a href="frames.html" target="_top">frames</a
 
57
            >]&nbsp;|&nbsp;<a href="epydoc.apidoc.DocIndex-class.html"
 
58
            target="_top">no&nbsp;frames</a>]</span></td></tr>
 
59
      </table>
 
60
    </td>
 
61
  </tr>
 
62
</table>
 
63
<!-- ==================== CLASS DESCRIPTION ==================== -->
 
64
<h1 class="epydoc">Class DocIndex</h1><p class="nomargin-top"><span class="codelink"><a href="epydoc.apidoc-pysrc.html#DocIndex">source&nbsp;code</a></span></p>
 
65
<p>[xx] out of date.</p>
 
66
  <p>An index that .. hmm...  it *can't* be used to access some things, cuz
 
67
  they're not at the root level.  Do I want to add them or what? And if so,
 
68
  then I have a sort of a new top level.  hmm..  so basically the question 
 
69
  is what to do with a name that's not in the root var's name space.  2 
 
70
  types:</p>
 
71
  <ul>
 
72
    <li>
 
73
      entirely outside (eg os.path)
 
74
    </li>
 
75
    <li>
 
76
      inside but not known (eg a submodule that we didn't look at?)
 
77
    </li>
 
78
    <li>
 
79
      container of current thing not examined?
 
80
    </li>
 
81
  </ul>
 
82
  <p>An index of all the <code>APIDoc</code> objects that can be reached 
 
83
  from a root set of <code>ValueDoc</code>s.</p>
 
84
  <p>The members of this index can be accessed by dotted name.  In 
 
85
  particular, <code>DocIndex</code> defines two mappings, accessed via the 
 
86
  <a href="epydoc.apidoc.DocIndex-class.html#get_vardoc" 
 
87
  class="link">get_vardoc()</a> and <a 
 
88
  href="epydoc.apidoc.DocIndex-class.html#get_valdoc" 
 
89
  class="link">get_valdoc()</a> methods, which can be used to access 
 
90
  <code>VariableDoc</code>s or <code>ValueDoc</code>s respectively by name.
 
91
  (Two separate mappings are necessary because a single name can be used to
 
92
  refer to both a variable and to the value contained by that 
 
93
  variable.)</p>
 
94
  <p>Additionally, the index defines two sets of <code>ValueDoc</code>s: 
 
95
  &quot;reachable <code>ValueDoc</code>s&quot; and &quot;contained 
 
96
  <code>ValueDoc</code>s&quot;.  The <a 
 
97
  name="index-reachable_ValueDocs"></a><i class="indexterm">reachable 
 
98
  <code>ValueDoc</code>s</i> are defined as the set of all 
 
99
  <code>ValueDoc</code>s that can be reached from the root set by following
 
100
  <i>any</i> sequence of pointers to <code>ValueDoc</code>s or 
 
101
  <code>VariableDoc</code>s. The <a name="index-contained_ValueDocs"></a><i
 
102
  class="indexterm">contained <code>ValueDoc</code>s</i> are defined as the
 
103
  set of all <code>ValueDoc</code>s that can be reached from the root set 
 
104
  by following only the <code>ValueDoc</code> pointers defined by 
 
105
  non-imported <code>VariableDoc</code>s.  For example, if the root set 
 
106
  contains a module <code>m</code>, then the contained 
 
107
  <code>ValueDoc</code>s includes the <code>ValueDoc</code>s for any 
 
108
  functions, variables, or classes defined in that module, as well as 
 
109
  methods and variables defined in classes defined in the module.  The 
 
110
  reachable <code>ValueDoc</code>s includes all of those 
 
111
  <code>ValueDoc</code>s, as well as <code>ValueDoc</code>s for any values 
 
112
  imported into the module, and base classes for classes defined in the 
 
113
  module.</p>
 
114
 
 
115
<!-- ==================== INSTANCE METHODS ==================== -->
 
116
<a name="section-InstanceMethods"></a>
 
117
<table class="summary" border="1" cellpadding="3"
 
118
       cellspacing="0" width="100%" bgcolor="white">
 
119
<tr bgcolor="#70b0f0" class="table-header">
 
120
  <td colspan="2" class="table-header">
 
121
    <table border="0" cellpadding="0" cellspacing="0" width="100%">
 
122
      <tr valign="top">
 
123
        <td align="left"><span class="table-header">Instance Methods</span></td>
 
124
        <td align="right" valign="top"
 
125
         ><span class="options">[<a href="#section-InstanceMethods"
 
126
         class="privatelink" onclick="toggle_private();"
 
127
         >hide private</a>]</span></td>
 
128
      </tr>
 
129
    </table>
 
130
  </td>
 
131
</tr>
 
132
<tr>
 
133
    <td width="15%" align="right" valign="top" class="summary">
 
134
      <span class="summary-type">&nbsp;</span>
 
135
    </td><td class="summary">
 
136
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
 
137
        <tr>
 
138
          <td><span class="summary-sig"><a href="epydoc.apidoc.DocIndex-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>,
 
139
        <span class="summary-sig-arg">root</span>)</span><br />
 
140
      Create a new documentation index, based on the given root set of 
 
141
      <code>ValueDoc</code>s.</td>
 
142
          <td align="right" valign="top">
 
143
            <span class="codelink"><a href="epydoc.apidoc-pysrc.html#DocIndex.__init__">source&nbsp;code</a></span>
 
144
            <br /><span class="codelink"><a href="javascript:void(0);" onclick="toggleCallGraph('call_graph_for___init___2-summary-div');return false;">call&nbsp;graph</a></span>&nbsp;
 
145
          </td>
 
146
        </tr>
 
147
      </table>
 
148
      <div style="display:none" id="call_graph_for___init___2-summary-div"><center>
 
149
<table border="0" cellpadding="0" cellspacing="0">
 
150
  <tr><td><center>  <map id="call_graph_for___init___2" name="call_graph_for___init___2">
 
151
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#__init__" title="__init__()" alt="" coords="297,34,393,66" />
 
152
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#_get_module_classes" title="_get_module_classes()" alt="" coords="448,6,643,38" />
 
153
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#__cmp__" title="DottedName.__cmp__()" alt="" coords="444,62,647,94" />
 
154
<area shape="rect" href="epydoc.docbuilder&#45;module.html#build_doc_index" title="docbuilder.build_doc_index()" alt="" coords="5,34,248,66" />
 
155
</map>
 
156
  <img src="call_graph_for___init___2.gif" alt='' usemap="#call_graph_for___init___2" ismap="ismap" class="graph-without-title" />
 
157
</center></td></tr>
 
158
  <tr><th>Call Graph</th></tr>
 
159
</table><br />
 
160
</center></div>
 
161
 
 
162
    </td>
 
163
  </tr>
 
164
<tr>
 
165
    <td width="15%" align="right" valign="top" class="summary">
 
166
      <span class="summary-type">&nbsp;</span>
 
167
    </td><td class="summary">
 
168
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
 
169
        <tr>
 
170
          <td><span class="summary-sig"><a name="get_vardoc"></a><span class="summary-sig-name">get_vardoc</span>(<span class="summary-sig-arg">self</span>,
 
171
        <span class="summary-sig-arg">name</span>)</span><br />
 
172
      Return the <code>VariableDoc</code> with the given name, or 
 
173
      <code>None</code> if this index does not contain a 
 
174
      <code>VariableDoc</code> with the given name.</td>
 
175
          <td align="right" valign="top">
 
176
            <span class="codelink"><a href="epydoc.apidoc-pysrc.html#DocIndex.get_vardoc">source&nbsp;code</a></span>
 
177
            <br /><span class="codelink"><a href="javascript:void(0);" onclick="toggleCallGraph('call_graph_for_get_vardoc-summary-div');return false;">call&nbsp;graph</a></span>&nbsp;
 
178
          </td>
 
179
        </tr>
 
180
      </table>
 
181
      <div style="display:none" id="call_graph_for_get_vardoc-summary-div"><center>
 
182
<table border="0" cellpadding="0" cellspacing="0">
 
183
  <tr><td><center>  <map id="call_graph_for_get_vardoc" name="call_graph_for_get_vardoc">
 
184
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#_get" title="_get()" alt="" coords="740,62,807,94" />
 
185
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#find" title="find()" alt="" coords="233,6,297,38" />
 
186
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#get_vardoc" title="get_vardoc()" alt="" coords="573,62,691,94" />
 
187
<area shape="rect" href="epydoc.docwriter.html.HTMLWriter&#45;class.html#_doc_or_ancestor_is_private" title="docwriter.html.HTMLWriter._doc_or_ancestor_is_private()" alt="" coords="31,62,500,94" />
 
188
<area shape="rect" href="epydoc.docwriter.html._HTMLDocstringLinker&#45;class.html#translate_identifier_xref" title="docwriter.html._HTMLDocstringLinker.translate_identifier_xref()" alt="" coords="7,118,524,150" />
 
189
</map>
 
190
  <img src="call_graph_for_get_vardoc.gif" alt='' usemap="#call_graph_for_get_vardoc" ismap="ismap" class="graph-without-title" />
 
191
</center></td></tr>
 
192
  <tr><th>Call Graph</th></tr>
 
193
</table><br />
 
194
</center></div>
 
195
 
 
196
    </td>
 
197
  </tr>
 
198
<tr>
 
199
    <td width="15%" align="right" valign="top" class="summary">
 
200
      <span class="summary-type">&nbsp;</span>
 
201
    </td><td class="summary">
 
202
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
 
203
        <tr>
 
204
          <td><span class="summary-sig"><a name="get_valdoc"></a><span class="summary-sig-name">get_valdoc</span>(<span class="summary-sig-arg">self</span>,
 
205
        <span class="summary-sig-arg">name</span>)</span><br />
 
206
      Return the <code>ValueDoc</code> with the given name, or 
 
207
      <code>None</code> if this index does not contain a 
 
208
      <code>ValueDoc</code> with the given name.</td>
 
209
          <td align="right" valign="top">
 
210
            <span class="codelink"><a href="epydoc.apidoc-pysrc.html#DocIndex.get_valdoc">source&nbsp;code</a></span>
 
211
            <br /><span class="codelink"><a href="javascript:void(0);" onclick="toggleCallGraph('call_graph_for_get_valdoc-summary-div');return false;">call&nbsp;graph</a></span>&nbsp;
 
212
          </td>
 
213
        </tr>
 
214
      </table>
 
215
      <div style="display:none" id="call_graph_for_get_valdoc-summary-div"><center>
 
216
<table border="0" cellpadding="0" cellspacing="0">
 
217
  <tr><td><center>  <map id="call_graph_for_get_valdoc" name="call_graph_for_get_valdoc">
 
218
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#_get" title="_get()" alt="" coords="690,118,756,150" />
 
219
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#container" title="container()" alt="" coords="188,6,292,38" />
 
220
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#get_valdoc" title="get_valdoc()" alt="" coords="524,118,639,150" />
 
221
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#find" title="find()" alt="" coords="208,62,272,94" />
 
222
<area shape="rect" href="epydoc.docstringparser&#45;module.html#user_docfields" title="docstringparser.user_docfields()" alt="" coords="110,118,371,150" />
 
223
<area shape="rect" href="epydoc.docwriter.html.HTMLWriter&#45;class.html#_doc_or_ancestor_is_private" title="docwriter.html.HTMLWriter._doc_or_ancestor_is_private()" alt="" coords="6,174,475,206" />
 
224
<area shape="rect" href="epydoc.docwriter.html.HTMLWriter&#45;class.html#_url" title="docwriter.html.HTMLWriter._url()" alt="" coords="98,230,383,262" />
 
225
</map>
 
226
  <img src="call_graph_for_get_valdoc.gif" alt='' usemap="#call_graph_for_get_valdoc" ismap="ismap" class="graph-without-title" />
 
227
</center></td></tr>
 
228
  <tr><th>Call Graph</th></tr>
 
229
</table><br />
 
230
</center></div>
 
231
 
 
232
    </td>
 
233
  </tr>
 
234
<tr class="private">
 
235
    <td width="15%" align="right" valign="top" class="summary">
 
236
      <span class="summary-type">&nbsp;</span>
 
237
    </td><td class="summary">
 
238
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
 
239
        <tr>
 
240
          <td><span class="summary-sig"><a name="_get"></a><span class="summary-sig-name">_get</span>(<span class="summary-sig-arg">self</span>,
 
241
        <span class="summary-sig-arg">name</span>)</span><br />
 
242
      A helper function that's used to implement <a 
 
243
      href="epydoc.apidoc.DocIndex-class.html#get_vardoc" 
 
244
      class="link">get_vardoc()</a> and <a 
 
245
      href="epydoc.apidoc.DocIndex-class.html#get_valdoc" 
 
246
      class="link">get_valdoc()</a>.</td>
 
247
          <td align="right" valign="top">
 
248
            <span class="codelink"><a href="epydoc.apidoc-pysrc.html#DocIndex._get">source&nbsp;code</a></span>
 
249
            <br /><span class="codelink"><a href="javascript:void(0);" onclick="toggleCallGraph('call_graph_for__get-summary-div');return false;">call&nbsp;graph</a></span>&nbsp;
 
250
          </td>
 
251
        </tr>
 
252
      </table>
 
253
      <div style="display:none" id="call_graph_for__get-summary-div"><center>
 
254
<table border="0" cellpadding="0" cellspacing="0">
 
255
  <tr><td><center>  <map id="call_graph_for__get" name="call_graph_for__get">
 
256
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#_get" title="_get()" alt="" coords="172,90,239,122" />
 
257
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#_get_from" title="_get_from()" alt="" coords="347,6,459,38" />
 
258
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#__getitem__" title="DottedName.__getitem__()" alt="" coords="290,62,516,94" />
 
259
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#__hash__" title="DottedName.__hash__()" alt="" coords="300,118,506,150" />
 
260
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#dominates" title="DottedName.dominates()" alt="" coords="298,174,508,206" />
 
261
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#get_valdoc" title="get_valdoc()" alt="" coords="7,62,122,94" />
 
262
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#get_vardoc" title="get_vardoc()" alt="" coords="6,118,123,150" />
 
263
</map>
 
264
  <img src="call_graph_for__get.gif" alt='' usemap="#call_graph_for__get" ismap="ismap" class="graph-without-title" />
 
265
</center></td></tr>
 
266
  <tr><th>Call Graph</th></tr>
 
267
</table><br />
 
268
</center></div>
 
269
 
 
270
    </td>
 
271
  </tr>
 
272
<tr class="private">
 
273
    <td width="15%" align="right" valign="top" class="summary">
 
274
      <span class="summary-type">&nbsp;</span>
 
275
    </td><td class="summary">
 
276
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
 
277
        <tr>
 
278
          <td><span class="summary-sig"><a name="_get_from"></a><span class="summary-sig-name">_get_from</span>(<span class="summary-sig-arg">self</span>,
 
279
        <span class="summary-sig-arg">val_doc</span>,
 
280
        <span class="summary-sig-arg">identifier</span>)</span></td>
 
281
          <td align="right" valign="top">
 
282
            <span class="codelink"><a href="epydoc.apidoc-pysrc.html#DocIndex._get_from">source&nbsp;code</a></span>
 
283
            <br /><span class="codelink"><a href="javascript:void(0);" onclick="toggleCallGraph('call_graph_for__get_from-summary-div');return false;">call&nbsp;graph</a></span>&nbsp;
 
284
          </td>
 
285
        </tr>
 
286
      </table>
 
287
      <div style="display:none" id="call_graph_for__get_from-summary-div"><center>
 
288
<table border="0" cellpadding="0" cellspacing="0">
 
289
  <tr><td><center>  <map id="call_graph_for__get_from" name="call_graph_for__get_from">
 
290
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#_get" title="_get()" alt="" coords="7,6,73,38" />
 
291
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#_get_from" title="_get_from()" alt="" coords="124,6,236,38" />
 
292
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#__getitem__" title="DottedName.__getitem__()" alt="" coords="287,6,513,38" />
 
293
</map>
 
294
  <img src="call_graph_for__get_from.gif" alt='' usemap="#call_graph_for__get_from" ismap="ismap" class="graph-without-title" />
 
295
</center></td></tr>
 
296
  <tr><th>Call Graph</th></tr>
 
297
</table><br />
 
298
</center></div>
 
299
 
 
300
    </td>
 
301
  </tr>
 
302
<tr>
 
303
    <td width="15%" align="right" valign="top" class="summary">
 
304
      <span class="summary-type">&nbsp;</span>
 
305
    </td><td class="summary">
 
306
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
 
307
        <tr>
 
308
          <td><span class="summary-sig"><a href="epydoc.apidoc.DocIndex-class.html#find" class="summary-sig-name">find</a>(<span class="summary-sig-arg">self</span>,
 
309
        <span class="summary-sig-arg">name</span>,
 
310
        <span class="summary-sig-arg">context</span>)</span><br />
 
311
      Look for an <code>APIDoc</code> named <code>name</code>, relative to 
 
312
      <code>context</code>.</td>
 
313
          <td align="right" valign="top">
 
314
            <span class="codelink"><a href="epydoc.apidoc-pysrc.html#DocIndex.find">source&nbsp;code</a></span>
 
315
            <br /><span class="codelink"><a href="javascript:void(0);" onclick="toggleCallGraph('call_graph_for_find-summary-div');return false;">call&nbsp;graph</a></span>&nbsp;
 
316
          </td>
 
317
        </tr>
 
318
      </table>
 
319
      <div style="display:none" id="call_graph_for_find-summary-div"><center>
 
320
<table border="0" cellpadding="0" cellspacing="0">
 
321
  <tr><td><center>  <map id="call_graph_for_find" name="call_graph_for_find">
 
322
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#find" title="find()" alt="" coords="579,174,643,206" />
 
323
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#get_valdoc" title="get_valdoc()" alt="" coords="748,6,863,38" />
 
324
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#get_vardoc" title="get_vardoc()" alt="" coords="747,62,864,94" />
 
325
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#__add__" title="DottedName.__add__()" alt="" coords="705,118,905,150" />
 
326
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#__getitem__" title="DottedName.__getitem__()" alt="" coords="692,174,919,206" />
 
327
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#__init__" title="DottedName.__init__()" alt="" coords="707,230,904,262" />
 
328
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#__radd__" title="DottedName.__radd__()" alt="" coords="703,286,908,318" />
 
329
<area shape="rect" href="epydoc.apidoc.RoutineDoc&#45;class.html#all_args" title="RoutineDoc.all_args()" alt="" coords="712,342,899,374" />
 
330
<area shape="rect" href="epydoc.docwriter.dotgraph.DotGraphUmlClassNode&#45;class.html#_add_attribute_edge" title="docwriter.dotgraph.DotGraphUmlClassNode._add_attribute_edge()" alt="" coords="5,6,531,38" />
 
331
<area shape="rect" href="epydoc.docwriter.dotgraph&#45;module.html#import_graph" title="docwriter.dotgraph.import_graph()" alt="" coords="128,62,408,94" />
 
332
<area shape="rect" href="epydoc.docwriter.html._HTMLDocstringLinker&#45;class.html#translate_identifier_xref" title="docwriter.html._HTMLDocstringLinker.translate_identifier_xref()" alt="" coords="9,118,527,150" />
 
333
<area shape="rect" href="epydoc.docwriter.html._HTMLDocstringLinker&#45;class.html#url_for" title="docwriter.html._HTMLDocstringLinker.url_for()" alt="" coords="73,174,463,206" />
 
334
<area shape="rect" href="epydoc.markup.epytext.ParsedEpytextDocstring&#45;class.html#_build_graph" title="markup.epytext.ParsedEpytextDocstring._build_graph()" alt="" coords="48,230,488,262" />
 
335
<area shape="rect" href="epydoc.markup.restructuredtext&#45;module.html#_construct_classtree" title="markup.restructuredtext._construct_classtree()" alt="" coords="84,286,452,318" />
 
336
<area shape="rect" href="epydoc.markup.restructuredtext&#45;module.html#_construct_packagetree" title="markup.restructuredtext._construct_packagetree()" alt="" coords="72,342,464,374" />
 
337
</map>
 
338
  <img src="call_graph_for_find.gif" alt='' usemap="#call_graph_for_find" ismap="ismap" class="graph-without-title" />
 
339
</center></td></tr>
 
340
  <tr><th>Call Graph</th></tr>
 
341
</table><br />
 
342
</center></div>
 
343
 
 
344
    </td>
 
345
  </tr>
 
346
<tr class="private">
 
347
    <td width="15%" align="right" valign="top" class="summary">
 
348
      <span class="summary-type"><code>dict</code> from <code>str</code> to <a 
 
349
      href="epydoc.apidoc.ClassDoc-class.html" class="link">ClassDoc</a> or
 
350
      <code>list</code></span>
 
351
    </td><td class="summary">
 
352
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
 
353
        <tr>
 
354
          <td><span class="summary-sig"><a href="epydoc.apidoc.DocIndex-class.html#_get_module_classes" class="summary-sig-name" onclick="show_private();">_get_module_classes</a>(<span class="summary-sig-arg">self</span>,
 
355
        <span class="summary-sig-arg">docs</span>)</span><br />
 
356
      Gather all the classes defined in a list of modules.</td>
 
357
          <td align="right" valign="top">
 
358
            <span class="codelink"><a href="epydoc.apidoc-pysrc.html#DocIndex._get_module_classes">source&nbsp;code</a></span>
 
359
            <br /><span class="codelink"><a href="javascript:void(0);" onclick="toggleCallGraph('call_graph_for__get_module_cla-summary-div');return false;">call&nbsp;graph</a></span>&nbsp;
 
360
          </td>
 
361
        </tr>
 
362
      </table>
 
363
      <div style="display:none" id="call_graph_for__get_module_cla-summary-div"><center>
 
364
<table border="0" cellpadding="0" cellspacing="0">
 
365
  <tr><td><center>  <map id="call_graph_for__get_module_cla" name="call_graph_for__get_module_cla">
 
366
<area shape="rect" href="epydoc.apidoc.APIDoc&#45;class.html#__cmp__" title="APIDoc.__cmp__()" alt="" coords="424,6,595,38" />
 
367
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#__init__" title="__init__()" alt="" coords="7,62,103,94" />
 
368
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#_get_module_classes" title="_get_module_classes()" alt="" coords="152,62,347,94" />
 
369
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#__cmp__" title="DottedName.__cmp__()" alt="" coords="408,62,611,94" />
 
370
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#__getitem__" title="DottedName.__getitem__()" alt="" coords="396,118,623,150" />
 
371
</map>
 
372
  <img src="call_graph_for__get_module_cla.gif" alt='' usemap="#call_graph_for__get_module_cla" ismap="ismap" class="graph-without-title" />
 
373
</center></td></tr>
 
374
  <tr><th>Call Graph</th></tr>
 
375
</table><br />
 
376
</center></div>
 
377
 
 
378
    </td>
 
379
  </tr>
 
380
<tr>
 
381
    <td width="15%" align="right" valign="top" class="summary">
 
382
      <span class="summary-type">&nbsp;</span>
 
383
    </td><td class="summary">
 
384
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
 
385
        <tr>
 
386
          <td><span class="summary-sig"><a href="epydoc.apidoc.DocIndex-class.html#reachable_valdocs" class="summary-sig-name">reachable_valdocs</a>(<span class="summary-sig-arg">self</span>,
 
387
        <span class="summary-sig-arg">**filters</span>)</span><br />
 
388
      Return a list of all <code>ValueDoc</code>s that can be reached, 
 
389
      directly or indirectly from this <code>DocIndex</code>'s root set.</td>
 
390
          <td align="right" valign="top">
 
391
            <span class="codelink"><a href="epydoc.apidoc-pysrc.html#DocIndex.reachable_valdocs">source&nbsp;code</a></span>
 
392
            <br /><span class="codelink"><a href="javascript:void(0);" onclick="toggleCallGraph('call_graph_for_reachable_valdo_2-summary-div');return false;">call&nbsp;graph</a></span>&nbsp;
 
393
          </td>
 
394
        </tr>
 
395
      </table>
 
396
      <div style="display:none" id="call_graph_for_reachable_valdo_2-summary-div"><center>
 
397
<table border="0" cellpadding="0" cellspacing="0">
 
398
  <tr><td><center>  <map id="call_graph_for_reachable_valdo_2" name="call_graph_for_reachable_valdo_2">
 
399
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#reachable_valdocs" title="reachable_valdocs()" alt="" coords="371,34,544,66" />
 
400
<area shape="rect" href="epydoc.apidoc&#45;module.html#reachable_valdocs" title="reachable_valdocs()" alt="" coords="592,34,766,66" />
 
401
<area shape="rect" href="epydoc.docbuilder&#45;module.html#build_doc_index" title="docbuilder.build_doc_index()" alt="" coords="43,6,286,38" />
 
402
<area shape="rect" href="epydoc.docwriter.html.HTMLWriter&#45;class.html#__init__" title="docwriter.html.HTMLWriter.__init__()" alt="" coords="6,62,323,94" />
 
403
</map>
 
404
  <img src="call_graph_for_reachable_valdo_2.gif" alt='' usemap="#call_graph_for_reachable_valdo_2" ismap="ismap" class="graph-without-title" />
 
405
</center></td></tr>
 
406
  <tr><th>Call Graph</th></tr>
 
407
</table><br />
 
408
</center></div>
 
409
 
 
410
    </td>
 
411
  </tr>
 
412
<tr>
 
413
    <td width="15%" align="right" valign="top" class="summary">
 
414
      <span class="summary-type">&nbsp;</span>
 
415
    </td><td class="summary">
 
416
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
 
417
        <tr>
 
418
          <td><span class="summary-sig"><a name="container"></a><span class="summary-sig-name">container</span>(<span class="summary-sig-arg">self</span>,
 
419
        <span class="summary-sig-arg">api_doc</span>)</span><br />
 
420
      Return the <code>ValueDoc</code> that contains the given 
 
421
      <code>APIDoc</code>, or <code>None</code> if its container is not in 
 
422
      the index.</td>
 
423
          <td align="right" valign="top">
 
424
            <span class="codelink"><a href="epydoc.apidoc-pysrc.html#DocIndex.container">source&nbsp;code</a></span>
 
425
            <br /><span class="codelink"><a href="javascript:void(0);" onclick="toggleCallGraph('call_graph_for_container-summary-div');return false;">call&nbsp;graph</a></span>&nbsp;
 
426
          </td>
 
427
        </tr>
 
428
      </table>
 
429
      <div style="display:none" id="call_graph_for_container-summary-div"><center>
 
430
<table border="0" cellpadding="0" cellspacing="0">
 
431
  <tr><td><center>  <map id="call_graph_for_container" name="call_graph_for_container">
 
432
<area shape="rect" href="epydoc.apidoc.APIDoc&#45;class.html#__hash__" title="APIDoc.__hash__()" alt="" coords="690,90,860,122" />
 
433
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#container" title="container()" alt="" coords="520,146,624,178" />
 
434
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#get_valdoc" title="get_valdoc()" alt="" coords="718,146,832,178" />
 
435
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#container" title="DottedName.container()" alt="" coords="674,202,876,234" />
 
436
<area shape="rect" href="epydoc.docwriter.html.HTMLWriter&#45;class.html#_url" title="docwriter.html.HTMLWriter._url()" alt="" coords="96,6,382,38" />
 
437
<area shape="rect" href="epydoc.docwriter.html.HTMLWriter&#45;class.html#_val_is_public" title="docwriter.html.HTMLWriter._val_is_public()" alt="" coords="58,62,420,94" />
 
438
<area shape="rect" href="epydoc.docwriter.html.HTMLWriter&#45;class.html#breadcrumbs" title="docwriter.html.HTMLWriter.breadcrumbs()" alt="" coords="64,118,414,150" />
 
439
<area shape="rect" href="epydoc.docwriter.html.HTMLWriter&#45;class.html#build_identifier_index" title="docwriter.html.HTMLWriter.build_identifier_index()" alt="" coords="28,174,450,206" />
 
440
<area shape="rect" href="epydoc.docwriter.html.HTMLWriter&#45;class.html#write_project_toc" title="docwriter.html.HTMLWriter.write_project_toc()" alt="" coords="46,230,432,262" />
 
441
<area shape="rect" href="epydoc.docwriter.html_colorize.PythonSourceColorizer&#45;class.html#doc_kind" title="docwriter.html_colorize.PythonSourceColorizer.doc_kind()" alt="" coords="6,286,472,318" />
 
442
</map>
 
443
  <img src="call_graph_for_container.gif" alt='' usemap="#call_graph_for_container" ismap="ismap" class="graph-without-title" />
 
444
</center></td></tr>
 
445
  <tr><th>Call Graph</th></tr>
 
446
</table><br />
 
447
</center></div>
 
448
 
 
449
    </td>
 
450
  </tr>
 
451
<tr>
 
452
    <td width="15%" align="right" valign="top" class="summary">
 
453
      <span class="summary-type">&nbsp;</span>
 
454
    </td><td class="summary">
 
455
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
 
456
        <tr>
 
457
          <td><span class="summary-sig"><a href="epydoc.apidoc.DocIndex-class.html#read_profiling_info" class="summary-sig-name">read_profiling_info</a>(<span class="summary-sig-arg">self</span>,
 
458
        <span class="summary-sig-arg">profile_stats</span>)</span><br />
 
459
      Initialize the <a href="epydoc.apidoc.DocIndex-class.html#callers" 
 
460
      class="link">callers</a> and <a 
 
461
      href="epydoc.apidoc.DocIndex-class.html#callees" 
 
462
      class="link">callees</a> variables, given a <code>Stat</code> object 
 
463
      from the <code>pstats</code> module.</td>
 
464
          <td align="right" valign="top">
 
465
            <span class="codelink"><a href="epydoc.apidoc-pysrc.html#DocIndex.read_profiling_info">source&nbsp;code</a></span>
 
466
            
 
467
          </td>
 
468
        </tr>
 
469
      </table>
 
470
      
 
471
    </td>
 
472
  </tr>
 
473
<tr class="private">
 
474
    <td width="15%" align="right" valign="top" class="summary">
 
475
      <span class="summary-type">&nbsp;</span>
 
476
    </td><td class="summary">
 
477
      <table width="100%" cellpadding="0" cellspacing="0" border="0">
 
478
        <tr>
 
479
          <td><span class="summary-sig"><a href="epydoc.apidoc.DocIndex-class.html#_update_funcid_to_doc" class="summary-sig-name" onclick="show_private();">_update_funcid_to_doc</a>(<span class="summary-sig-arg">self</span>,
 
480
        <span class="summary-sig-arg">profile_stats</span>)</span><br />
 
481
      Update the dictionary mapping from <code>pstat.Stat</code> funciton 
 
482
      ids to <code>RoutineDoc</code>s.</td>
 
483
          <td align="right" valign="top">
 
484
            <span class="codelink"><a href="epydoc.apidoc-pysrc.html#DocIndex._update_funcid_to_doc">source&nbsp;code</a></span>
 
485
            
 
486
          </td>
 
487
        </tr>
 
488
      </table>
 
489
      
 
490
    </td>
 
491
  </tr>
 
492
</table>
 
493
<!-- ==================== INSTANCE VARIABLES ==================== -->
 
494
<a name="section-InstanceVariables"></a>
 
495
<table class="summary" border="1" cellpadding="3"
 
496
       cellspacing="0" width="100%" bgcolor="white">
 
497
<tr bgcolor="#70b0f0" class="table-header">
 
498
  <td colspan="2" class="table-header">
 
499
    <table border="0" cellpadding="0" cellspacing="0" width="100%">
 
500
      <tr valign="top">
 
501
        <td align="left"><span class="table-header">Instance Variables</span></td>
 
502
        <td align="right" valign="top"
 
503
         ><span class="options">[<a href="#section-InstanceVariables"
 
504
         class="privatelink" onclick="toggle_private();"
 
505
         >hide private</a>]</span></td>
 
506
      </tr>
 
507
    </table>
 
508
  </td>
 
509
</tr>
 
510
<tr>
 
511
    <td width="15%" align="right" valign="top" class="summary">
 
512
      <span class="summary-type"><code>list</code></span>
 
513
    </td><td class="summary">
 
514
        <a name="root"></a><span class="summary-name">root</span><br />
 
515
      The list of <code>ValueDoc</code>s to document.
 
516
    </td>
 
517
  </tr>
 
518
<tr>
 
519
    <td width="15%" align="right" valign="top" class="summary">
 
520
      <span class="summary-type"><code>dict</code> from <code>str</code> to <a 
 
521
      href="epydoc.apidoc.ClassDoc-class.html" class="link">ClassDoc</a> or
 
522
      <code>list</code></span>
 
523
    </td><td class="summary">
 
524
        <a href="epydoc.apidoc.DocIndex-class.html#mlclasses" class="summary-name">mlclasses</a><br />
 
525
      A mapping from class names to <a 
 
526
      href="epydoc.apidoc.ClassDoc-class.html" class="link">ClassDoc</a>.
 
527
    </td>
 
528
  </tr>
 
529
<tr>
 
530
    <td width="15%" align="right" valign="top" class="summary">
 
531
      <span class="summary-type"><code>list</code> of <a href="epydoc.apidoc.RoutineDoc-class.html" 
 
532
      class="link">RoutineDoc</a></span>
 
533
    </td><td class="summary">
 
534
        <a href="epydoc.apidoc.DocIndex-class.html#callers" class="summary-name">callers</a><br />
 
535
      A dictionary mapping from <code>RoutineDoc</code>s in this index to 
 
536
      lists of <code>RoutineDoc</code>s for the routine's callers.
 
537
    </td>
 
538
  </tr>
 
539
<tr>
 
540
    <td width="15%" align="right" valign="top" class="summary">
 
541
      <span class="summary-type"><code>list</code> of <a href="epydoc.apidoc.RoutineDoc-class.html" 
 
542
      class="link">RoutineDoc</a></span>
 
543
    </td><td class="summary">
 
544
        <a href="epydoc.apidoc.DocIndex-class.html#callees" class="summary-name">callees</a><br />
 
545
      A dictionary mapping from <code>RoutineDoc</code>s in this index to 
 
546
      lists of <code>RoutineDoc</code>s for the routine's callees.
 
547
    </td>
 
548
  </tr>
 
549
<tr class="private">
 
550
    <td width="15%" align="right" valign="top" class="summary">
 
551
      <span class="summary-type">&nbsp;</span>
 
552
    </td><td class="summary">
 
553
        <a href="epydoc.apidoc.DocIndex-class.html#_funcid_to_doc" class="summary-name" onclick="show_private();">_funcid_to_doc</a><br />
 
554
      A mapping from <code>profile</code> function ids to corresponding 
 
555
      <code>APIDoc</code> objects.
 
556
    </td>
 
557
  </tr>
 
558
<tr class="private">
 
559
    <td width="15%" align="right" valign="top" class="summary">
 
560
      <span class="summary-type">&nbsp;</span>
 
561
    </td><td class="summary">
 
562
        <a name="_container_cache"></a><span class="summary-name">_container_cache</span><br />
 
563
      A cache for the <a href="epydoc.apidoc.DocIndex-class.html#container"
 
564
      class="link">container()</a> method, to increase speed.
 
565
    </td>
 
566
  </tr>
 
567
<tr class="private">
 
568
    <td width="15%" align="right" valign="top" class="summary">
 
569
      <span class="summary-type">&nbsp;</span>
 
570
    </td><td class="summary">
 
571
        <a name="_get_cache"></a><span class="summary-name">_get_cache</span><br />
 
572
      A cache for the <a 
 
573
      href="epydoc.apidoc.DocIndex-class.html#get_vardoc" 
 
574
      class="link">get_vardoc()</a> and <a 
 
575
      href="epydoc.apidoc.DocIndex-class.html#get_valdoc" 
 
576
      class="link">get_valdoc()</a> methods, to increase speed.
 
577
    </td>
 
578
  </tr>
 
579
</table>
 
580
<!-- ==================== METHOD DETAILS ==================== -->
 
581
<a name="section-MethodDetails"></a>
 
582
<table class="details" border="1" cellpadding="3"
 
583
       cellspacing="0" width="100%" bgcolor="white">
 
584
<tr bgcolor="#70b0f0" class="table-header">
 
585
  <td colspan="2" class="table-header">
 
586
    <table border="0" cellpadding="0" cellspacing="0" width="100%">
 
587
      <tr valign="top">
 
588
        <td align="left"><span class="table-header">Method Details</span></td>
 
589
        <td align="right" valign="top"
 
590
         ><span class="options">[<a href="#section-MethodDetails"
 
591
         class="privatelink" onclick="toggle_private();"
 
592
         >hide private</a>]</span></td>
 
593
      </tr>
 
594
    </table>
 
595
  </td>
 
596
</tr>
 
597
</table>
 
598
<a name="__init__"></a>
 
599
<div>
 
600
<table class="details" border="1" cellpadding="3"
 
601
       cellspacing="0" width="100%" bgcolor="white">
 
602
<tr><td>
 
603
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
 
604
  <tr valign="top"><td>
 
605
  <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>,
 
606
        <span class="sig-arg">root</span>)</span>
 
607
    <br /><em class="fname">(Constructor)</em>
 
608
  </h3>
 
609
  </td><td align="right" valign="top"
 
610
    ><span class="codelink"><a href="epydoc.apidoc-pysrc.html#DocIndex.__init__">source&nbsp;code</a></span>&nbsp;
 
611
    <br /><span class="codelink"><a href="javascript:void(0);" onclick="toggleCallGraph('call_graph_for___init___2-div');return false;">call&nbsp;graph</a></span>&nbsp;</td>
 
612
  </tr></table>
 
613
  <div style="display:none" id="call_graph_for___init___2-div"><center>
 
614
<table border="0" cellpadding="0" cellspacing="0">
 
615
  <tr><td><center>  <map id="call_graph_for___init___2" name="call_graph_for___init___2">
 
616
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#__init__" title="__init__()" alt="" coords="297,34,393,66" />
 
617
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#_get_module_classes" title="_get_module_classes()" alt="" coords="448,6,643,38" />
 
618
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#__cmp__" title="DottedName.__cmp__()" alt="" coords="444,62,647,94" />
 
619
<area shape="rect" href="epydoc.docbuilder&#45;module.html#build_doc_index" title="docbuilder.build_doc_index()" alt="" coords="5,34,248,66" />
 
620
</map>
 
621
  <img src="call_graph_for___init___2.gif" alt='' usemap="#call_graph_for___init___2" ismap="ismap" class="graph-without-title" />
 
622
</center></td></tr>
 
623
  <tr><th>Call Graph</th></tr>
 
624
</table><br />
 
625
</center></div>
 
626
 
 
627
  <p>Create a new documentation index, based on the given root set of 
 
628
  <code>ValueDoc</code>s.  If any <code>APIDoc</code>s reachable from the 
 
629
  root set does not have a canonical name, then it will be assigned one.  
 
630
  etc.</p>
 
631
  <dl class="fields">
 
632
    <dt>Parameters:</dt>
 
633
    <dd><ul class="nomargin-top">
 
634
        <li><strong class="pname"><code>root</code></strong> - A list of <code>ValueDoc</code>s.</li>
 
635
    </ul></dd>
 
636
  </dl>
 
637
</td></tr></table>
 
638
</div>
 
639
<a name="find"></a>
 
640
<div>
 
641
<table class="details" border="1" cellpadding="3"
 
642
       cellspacing="0" width="100%" bgcolor="white">
 
643
<tr><td>
 
644
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
 
645
  <tr valign="top"><td>
 
646
  <h3 class="epydoc"><span class="sig"><span class="sig-name">find</span>(<span class="sig-arg">self</span>,
 
647
        <span class="sig-arg">name</span>,
 
648
        <span class="sig-arg">context</span>)</span>
 
649
  </h3>
 
650
  </td><td align="right" valign="top"
 
651
    ><span class="codelink"><a href="epydoc.apidoc-pysrc.html#DocIndex.find">source&nbsp;code</a></span>&nbsp;
 
652
    <br /><span class="codelink"><a href="javascript:void(0);" onclick="toggleCallGraph('call_graph_for_find-div');return false;">call&nbsp;graph</a></span>&nbsp;</td>
 
653
  </tr></table>
 
654
  <div style="display:none" id="call_graph_for_find-div"><center>
 
655
<table border="0" cellpadding="0" cellspacing="0">
 
656
  <tr><td><center>  <map id="call_graph_for_find" name="call_graph_for_find">
 
657
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#find" title="find()" alt="" coords="579,174,643,206" />
 
658
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#get_valdoc" title="get_valdoc()" alt="" coords="748,6,863,38" />
 
659
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#get_vardoc" title="get_vardoc()" alt="" coords="747,62,864,94" />
 
660
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#__add__" title="DottedName.__add__()" alt="" coords="705,118,905,150" />
 
661
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#__getitem__" title="DottedName.__getitem__()" alt="" coords="692,174,919,206" />
 
662
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#__init__" title="DottedName.__init__()" alt="" coords="707,230,904,262" />
 
663
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#__radd__" title="DottedName.__radd__()" alt="" coords="703,286,908,318" />
 
664
<area shape="rect" href="epydoc.apidoc.RoutineDoc&#45;class.html#all_args" title="RoutineDoc.all_args()" alt="" coords="712,342,899,374" />
 
665
<area shape="rect" href="epydoc.docwriter.dotgraph.DotGraphUmlClassNode&#45;class.html#_add_attribute_edge" title="docwriter.dotgraph.DotGraphUmlClassNode._add_attribute_edge()" alt="" coords="5,6,531,38" />
 
666
<area shape="rect" href="epydoc.docwriter.dotgraph&#45;module.html#import_graph" title="docwriter.dotgraph.import_graph()" alt="" coords="128,62,408,94" />
 
667
<area shape="rect" href="epydoc.docwriter.html._HTMLDocstringLinker&#45;class.html#translate_identifier_xref" title="docwriter.html._HTMLDocstringLinker.translate_identifier_xref()" alt="" coords="9,118,527,150" />
 
668
<area shape="rect" href="epydoc.docwriter.html._HTMLDocstringLinker&#45;class.html#url_for" title="docwriter.html._HTMLDocstringLinker.url_for()" alt="" coords="73,174,463,206" />
 
669
<area shape="rect" href="epydoc.markup.epytext.ParsedEpytextDocstring&#45;class.html#_build_graph" title="markup.epytext.ParsedEpytextDocstring._build_graph()" alt="" coords="48,230,488,262" />
 
670
<area shape="rect" href="epydoc.markup.restructuredtext&#45;module.html#_construct_classtree" title="markup.restructuredtext._construct_classtree()" alt="" coords="84,286,452,318" />
 
671
<area shape="rect" href="epydoc.markup.restructuredtext&#45;module.html#_construct_packagetree" title="markup.restructuredtext._construct_packagetree()" alt="" coords="72,342,464,374" />
 
672
</map>
 
673
  <img src="call_graph_for_find.gif" alt='' usemap="#call_graph_for_find" ismap="ismap" class="graph-without-title" />
 
674
</center></td></tr>
 
675
  <tr><th>Call Graph</th></tr>
 
676
</table><br />
 
677
</center></div>
 
678
 
 
679
  <p>Look for an <code>APIDoc</code> named <code>name</code>, relative to 
 
680
  <code>context</code>. Return the <code>APIDoc</code> if one is found; 
 
681
  otherwise, return <code>None</code>.  <code>find</code> looks in the 
 
682
  following places, in order:</p>
 
683
  <ul>
 
684
    <li>
 
685
      Function parameters (if one matches, return <code>None</code>)
 
686
    </li>
 
687
    <li>
 
688
      All enclosing namespaces, from closest to furthest.
 
689
    </li>
 
690
    <li>
 
691
      If <code>name</code> starts with <code>'self'</code>, then strip it 
 
692
      off and look for the remaining part of the name using 
 
693
      <code>find</code>
 
694
    </li>
 
695
    <li>
 
696
      Builtins
 
697
    </li>
 
698
    <li>
 
699
      Parameter attributes
 
700
    </li>
 
701
    <li>
 
702
      Classes at module level (if the name is not ambiguous)
 
703
    </li>
 
704
  </ul>
 
705
  <dl class="fields">
 
706
    <dt>Parameters:</dt>
 
707
    <dd><ul class="nomargin-top">
 
708
        <li><strong class="pname"><code>name</code></strong> (<code>str</code> or <a href="epydoc.apidoc.DottedName-class.html"
 
709
          class="link">DottedName</a>)</li>
 
710
        <li><strong class="pname"><code>context</code></strong> (<a href="epydoc.apidoc.APIDoc-class.html" class="link">APIDoc</a>)</li>
 
711
    </ul></dd>
 
712
  </dl>
 
713
</td></tr></table>
 
714
</div>
 
715
<a name="_get_module_classes"></a>
 
716
<div class="private">
 
717
<table class="details" border="1" cellpadding="3"
 
718
       cellspacing="0" width="100%" bgcolor="white">
 
719
<tr><td>
 
720
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
 
721
  <tr valign="top"><td>
 
722
  <h3 class="epydoc"><span class="sig"><span class="sig-name">_get_module_classes</span>(<span class="sig-arg">self</span>,
 
723
        <span class="sig-arg">docs</span>)</span>
 
724
  </h3>
 
725
  </td><td align="right" valign="top"
 
726
    ><span class="codelink"><a href="epydoc.apidoc-pysrc.html#DocIndex._get_module_classes">source&nbsp;code</a></span>&nbsp;
 
727
    <br /><span class="codelink"><a href="javascript:void(0);" onclick="toggleCallGraph('call_graph_for__get_module_cla-div');return false;">call&nbsp;graph</a></span>&nbsp;</td>
 
728
  </tr></table>
 
729
  <div style="display:none" id="call_graph_for__get_module_cla-div"><center>
 
730
<table border="0" cellpadding="0" cellspacing="0">
 
731
  <tr><td><center>  <map id="call_graph_for__get_module_cla" name="call_graph_for__get_module_cla">
 
732
<area shape="rect" href="epydoc.apidoc.APIDoc&#45;class.html#__cmp__" title="APIDoc.__cmp__()" alt="" coords="424,6,595,38" />
 
733
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#__init__" title="__init__()" alt="" coords="7,62,103,94" />
 
734
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#_get_module_classes" title="_get_module_classes()" alt="" coords="152,62,347,94" />
 
735
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#__cmp__" title="DottedName.__cmp__()" alt="" coords="408,62,611,94" />
 
736
<area shape="rect" href="epydoc.apidoc.DottedName&#45;class.html#__getitem__" title="DottedName.__getitem__()" alt="" coords="396,118,623,150" />
 
737
</map>
 
738
  <img src="call_graph_for__get_module_cla.gif" alt='' usemap="#call_graph_for__get_module_cla" ismap="ismap" class="graph-without-title" />
 
739
</center></td></tr>
 
740
  <tr><th>Call Graph</th></tr>
 
741
</table><br />
 
742
</center></div>
 
743
 
 
744
  <p>Gather all the classes defined in a list of modules.</p>
 
745
  <p>Very often people refers to classes only by class name, even if they 
 
746
  are not imported in the namespace. Linking to such classes will fail if 
 
747
  we look for them only in nested namespaces. Allow them to retrieve only 
 
748
  by name.</p>
 
749
  <dl class="fields">
 
750
    <dt>Parameters:</dt>
 
751
    <dd><ul class="nomargin-top">
 
752
        <li><strong class="pname"><code>docs</code></strong> (<code>list</code> of <code>APIDoc</code>) - containers of the objects to collect</li>
 
753
    </ul></dd>
 
754
    <dt>Returns: <code>dict</code> from <code>str</code> to <a 
 
755
      href="epydoc.apidoc.ClassDoc-class.html" class="link">ClassDoc</a> or
 
756
      <code>list</code></dt>
 
757
        <dd>mapping from objects name to the object(s) with that name</dd>
 
758
  </dl>
 
759
</td></tr></table>
 
760
</div>
 
761
<a name="reachable_valdocs"></a>
 
762
<div>
 
763
<table class="details" border="1" cellpadding="3"
 
764
       cellspacing="0" width="100%" bgcolor="white">
 
765
<tr><td>
 
766
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
 
767
  <tr valign="top"><td>
 
768
  <h3 class="epydoc"><span class="sig"><span class="sig-name">reachable_valdocs</span>(<span class="sig-arg">self</span>,
 
769
        <span class="sig-arg">**filters</span>)</span>
 
770
  </h3>
 
771
  </td><td align="right" valign="top"
 
772
    ><span class="codelink"><a href="epydoc.apidoc-pysrc.html#DocIndex.reachable_valdocs">source&nbsp;code</a></span>&nbsp;
 
773
    <br /><span class="codelink"><a href="javascript:void(0);" onclick="toggleCallGraph('call_graph_for_reachable_valdo_2-div');return false;">call&nbsp;graph</a></span>&nbsp;</td>
 
774
  </tr></table>
 
775
  <div style="display:none" id="call_graph_for_reachable_valdo_2-div"><center>
 
776
<table border="0" cellpadding="0" cellspacing="0">
 
777
  <tr><td><center>  <map id="call_graph_for_reachable_valdo_2" name="call_graph_for_reachable_valdo_2">
 
778
<area shape="rect" href="epydoc.apidoc.DocIndex&#45;class.html#reachable_valdocs" title="reachable_valdocs()" alt="" coords="371,34,544,66" />
 
779
<area shape="rect" href="epydoc.apidoc&#45;module.html#reachable_valdocs" title="reachable_valdocs()" alt="" coords="592,34,766,66" />
 
780
<area shape="rect" href="epydoc.docbuilder&#45;module.html#build_doc_index" title="docbuilder.build_doc_index()" alt="" coords="43,6,286,38" />
 
781
<area shape="rect" href="epydoc.docwriter.html.HTMLWriter&#45;class.html#__init__" title="docwriter.html.HTMLWriter.__init__()" alt="" coords="6,62,323,94" />
 
782
</map>
 
783
  <img src="call_graph_for_reachable_valdo_2.gif" alt='' usemap="#call_graph_for_reachable_valdo_2" ismap="ismap" class="graph-without-title" />
 
784
</center></td></tr>
 
785
  <tr><th>Call Graph</th></tr>
 
786
</table><br />
 
787
</center></div>
 
788
 
 
789
  <p>Return a list of all <code>ValueDoc</code>s that can be reached, 
 
790
  directly or indirectly from this <code>DocIndex</code>'s root set.</p>
 
791
  <dl class="fields">
 
792
    <dt>Parameters:</dt>
 
793
    <dd><ul class="nomargin-top">
 
794
        <li><strong class="pname"><code>filters</code></strong> - A set of filters that can be used to prevent 
 
795
          <code>reachable_valdocs</code> from following specific link types
 
796
          when looking for <code>ValueDoc</code>s that can be reached from 
 
797
          the root set.  See <code>APIDoc.apidoc_links</code> for a more 
 
798
          complete description.</li>
 
799
    </ul></dd>
 
800
  </dl>
 
801
</td></tr></table>
 
802
</div>
 
803
<a name="read_profiling_info"></a>
 
804
<div>
 
805
<table class="details" border="1" cellpadding="3"
 
806
       cellspacing="0" width="100%" bgcolor="white">
 
807
<tr><td>
 
808
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
 
809
  <tr valign="top"><td>
 
810
  <h3 class="epydoc"><span class="sig"><span class="sig-name">read_profiling_info</span>(<span class="sig-arg">self</span>,
 
811
        <span class="sig-arg">profile_stats</span>)</span>
 
812
  </h3>
 
813
  </td><td align="right" valign="top"
 
814
    ><span class="codelink"><a href="epydoc.apidoc-pysrc.html#DocIndex.read_profiling_info">source&nbsp;code</a></span>&nbsp;
 
815
    </td>
 
816
  </tr></table>
 
817
  
 
818
  <p>Initialize the <a href="epydoc.apidoc.DocIndex-class.html#callers" 
 
819
  class="link">callers</a> and <a 
 
820
  href="epydoc.apidoc.DocIndex-class.html#callees" class="link">callees</a>
 
821
  variables, given a <code>Stat</code> object from the <code>pstats</code> 
 
822
  module.</p>
 
823
  <dl class="fields">
 
824
  </dl>
 
825
<div class="fields">      <p><strong>Warning:</strong>
 
826
        This method uses undocumented data structures inside of 
 
827
        <code>profile_stats</code>.
 
828
      </p>
 
829
</div></td></tr></table>
 
830
</div>
 
831
<a name="_update_funcid_to_doc"></a>
 
832
<div class="private">
 
833
<table class="details" border="1" cellpadding="3"
 
834
       cellspacing="0" width="100%" bgcolor="white">
 
835
<tr><td>
 
836
  <table width="100%" cellpadding="0" cellspacing="0" border="0">
 
837
  <tr valign="top"><td>
 
838
  <h3 class="epydoc"><span class="sig"><span class="sig-name">_update_funcid_to_doc</span>(<span class="sig-arg">self</span>,
 
839
        <span class="sig-arg">profile_stats</span>)</span>
 
840
  </h3>
 
841
  </td><td align="right" valign="top"
 
842
    ><span class="codelink"><a href="epydoc.apidoc-pysrc.html#DocIndex._update_funcid_to_doc">source&nbsp;code</a></span>&nbsp;
 
843
    </td>
 
844
  </tr></table>
 
845
  
 
846
  <p>Update the dictionary mapping from <code>pstat.Stat</code> funciton 
 
847
  ids to <code>RoutineDoc</code>s.  <code>pstat.Stat</code> function ids 
 
848
  are tuples of <code>(filename, lineno, funcname)</code>.</p>
 
849
  <dl class="fields">
 
850
  </dl>
 
851
</td></tr></table>
 
852
</div>
 
853
<br />
 
854
<!-- ==================== INSTANCE VARIABLE DETAILS ==================== -->
 
855
<a name="section-InstanceVariableDetails"></a>
 
856
<table class="details" border="1" cellpadding="3"
 
857
       cellspacing="0" width="100%" bgcolor="white">
 
858
<tr bgcolor="#70b0f0" class="table-header">
 
859
  <td colspan="2" class="table-header">
 
860
    <table border="0" cellpadding="0" cellspacing="0" width="100%">
 
861
      <tr valign="top">
 
862
        <td align="left"><span class="table-header">Instance Variable Details</span></td>
 
863
        <td align="right" valign="top"
 
864
         ><span class="options">[<a href="#section-InstanceVariableDetails"
 
865
         class="privatelink" onclick="toggle_private();"
 
866
         >hide private</a>]</span></td>
 
867
      </tr>
 
868
    </table>
 
869
  </td>
 
870
</tr>
 
871
</table>
 
872
<a name="mlclasses"></a>
 
873
<div>
 
874
<table class="details" border="1" cellpadding="3"
 
875
       cellspacing="0" width="100%" bgcolor="white">
 
876
<tr><td>
 
877
  <h3 class="epydoc">mlclasses</h3>
 
878
  <p>A mapping from class names to <a 
 
879
  href="epydoc.apidoc.ClassDoc-class.html" class="link">ClassDoc</a>. 
 
880
  Contains classes defined at module level for modules in <a 
 
881
  href="epydoc.apidoc.DocIndex-class.html#root" class="link">root</a> and 
 
882
  which can be used as fallback by <a 
 
883
  href="epydoc.apidoc.DocIndex-class.html#find" class="link">find()</a> if 
 
884
  looking in containing namespaces fails.</p>
 
885
  <dl class="fields">
 
886
    <dt>Type:</dt>
 
887
      <dd><code>dict</code> from <code>str</code> to <a 
 
888
      href="epydoc.apidoc.ClassDoc-class.html" class="link">ClassDoc</a> or
 
889
      <code>list</code></dd>
 
890
  </dl>
 
891
</td></tr></table>
 
892
</div>
 
893
<a name="callers"></a>
 
894
<div>
 
895
<table class="details" border="1" cellpadding="3"
 
896
       cellspacing="0" width="100%" bgcolor="white">
 
897
<tr><td>
 
898
  <h3 class="epydoc">callers</h3>
 
899
  <p>A dictionary mapping from <code>RoutineDoc</code>s in this index to 
 
900
  lists of <code>RoutineDoc</code>s for the routine's callers. This 
 
901
  dictionary is initialized by calling <a 
 
902
  href="epydoc.apidoc.DocIndex-class.html#read_profiling_info" 
 
903
  class="link">read_profiling_info()</a>.</p>
 
904
  <dl class="fields">
 
905
    <dt>Type:</dt>
 
906
      <dd><code>list</code> of <a href="epydoc.apidoc.RoutineDoc-class.html" 
 
907
      class="link">RoutineDoc</a></dd>
 
908
  </dl>
 
909
</td></tr></table>
 
910
</div>
 
911
<a name="callees"></a>
 
912
<div>
 
913
<table class="details" border="1" cellpadding="3"
 
914
       cellspacing="0" width="100%" bgcolor="white">
 
915
<tr><td>
 
916
  <h3 class="epydoc">callees</h3>
 
917
  <p>A dictionary mapping from <code>RoutineDoc</code>s in this index to 
 
918
  lists of <code>RoutineDoc</code>s for the routine's callees. This 
 
919
  dictionary is initialized by calling <a 
 
920
  href="epydoc.apidoc.DocIndex-class.html#read_profiling_info" 
 
921
  class="link">read_profiling_info()</a>.</p>
 
922
  <dl class="fields">
 
923
    <dt>Type:</dt>
 
924
      <dd><code>list</code> of <a href="epydoc.apidoc.RoutineDoc-class.html" 
 
925
      class="link">RoutineDoc</a></dd>
 
926
  </dl>
 
927
</td></tr></table>
 
928
</div>
 
929
<a name="_funcid_to_doc"></a>
 
930
<div class="private">
 
931
<table class="details" border="1" cellpadding="3"
 
932
       cellspacing="0" width="100%" bgcolor="white">
 
933
<tr><td>
 
934
  <h3 class="epydoc">_funcid_to_doc</h3>
 
935
  <p>A mapping from <code>profile</code> function ids to corresponding 
 
936
  <code>APIDoc</code> objects.  A function id is a tuple of the form 
 
937
  <code>(filename, lineno, funcname)</code>.  This is used to update the <a
 
938
  href="epydoc.apidoc.DocIndex-class.html#callers" class="link">callers</a>
 
939
  and <a href="epydoc.apidoc.DocIndex-class.html#callees" 
 
940
  class="link">callees</a> variables.</p>
 
941
  <dl class="fields">
 
942
  </dl>
 
943
</td></tr></table>
 
944
</div>
 
945
<br />
 
946
<!-- ==================== NAVIGATION BAR ==================== -->
 
947
<table class="navbar" border="0" width="100%" cellpadding="0"
 
948
       bgcolor="#a0c0ff" cellspacing="0">
 
949
  <tr valign="middle">
 
950
  <!-- Home link -->
 
951
      <th>&nbsp;&nbsp;&nbsp;<a
 
952
        href="epydoc-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
 
953
 
 
954
  <!-- Tree link -->
 
955
      <th>&nbsp;&nbsp;&nbsp;<a
 
956
        href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
 
957
 
 
958
  <!-- Index link -->
 
959
      <th>&nbsp;&nbsp;&nbsp;<a
 
960
        href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
 
961
 
 
962
  <!-- Help link -->
 
963
      <th>&nbsp;&nbsp;&nbsp;<a
 
964
        href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
 
965
 
 
966
  <!-- Project homepage -->
 
967
      <th class="navbar" align="right" width="100%">
 
968
        <table border="0" cellpadding="0" cellspacing="0">
 
969
          <tr><th class="navbar" align="center"
 
970
            ><a class="navbar" target="_top" href="http://epydoc.sourceforge.net">epydoc 3.0.1</a></th>
 
971
          </tr></table></th>
 
972
  </tr>
 
973
</table>
 
974
<table border="0" cellpadding="0" cellspacing="0" width="100%%">
 
975
  <tr>
 
976
    <td align="left" class="footer">
 
977
    <a href="epydoc-log.html">Generated by Epydoc
 
978
    3.0.1 on Wed Jan 30 14:07:06 2008</a>
 
979
    </td>
 
980
    <td align="right" class="footer">
 
981
      <a target="mainFrame" href="http://epydoc.sourceforge.net"
 
982
        >http://epydoc.sourceforge.net</a>
 
983
    </td>
 
984
  </tr>
 
985
</table>
 
986
 
 
987
<script type="text/javascript">
 
988
  <!--
 
989
  // Private objects are initially displayed (because if
 
990
  // javascript is turned off then we want them to be
 
991
  // visible); but by default, we want to hide them.  So hide
 
992
  // them unless we have a cookie that says to show them.
 
993
  checkCookie();
 
994
  // -->
 
995
</script>
 
996
</body>
 
997
</html>