<?xml version="1.0" encoding="ascii"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <title>epydoc.docwriter.html_help</title> <link rel="stylesheet" href="epydoc.css" type="text/css" /> <script type="text/javascript" src="epydoc.js"></script> </head> <body bgcolor="white" text="black" link="blue" vlink="#204080" alink="#204080"> <!-- ==================== NAVIGATION BAR ==================== --> <table class="navbar" border="0" width="100%" cellpadding="0" bgcolor="#a0c0ff" cellspacing="0"> <tr valign="middle"> <!-- Home link --> <th> <a href="epydoc-module.html">Home</a> </th> <!-- Tree link --> <th> <a href="module-tree.html">Trees</a> </th> <!-- Index link --> <th> <a href="identifier-index.html">Indices</a> </th> <!-- Help link --> <th> <a href="help.html">Help</a> </th> <!-- Project homepage --> <th class="navbar" align="right" width="100%"> <table border="0" cellpadding="0" cellspacing="0"> <tr><th class="navbar" align="center" ><a class="navbar" target="_top" href="http://epydoc.sourceforge.net">epydoc 3.0.1</a></th> </tr></table></th> </tr> </table> <table width="100%" cellpadding="0" cellspacing="0"> <tr valign="top"> <td width="100%"> <span class="breadcrumbs"> <a href="epydoc-module.html">Package epydoc</a> :: <a href="epydoc.docwriter-module.html">Package docwriter</a> :: Module html_help </span> </td> <td> <table cellpadding="0" cellspacing="0"> <!-- hide/show private --> <tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink" onclick="toggle_private();">hide private</a>]</span></td></tr> <tr><td align="right"><span class="options" >[<a href="frames.html" target="_top">frames</a >] | <a href="epydoc.docwriter.html_help-pysrc.html" target="_top">no frames</a>]</span></td></tr> </table> </td> </tr> </table> <h1 class="epydoc">Source Code for <a href="epydoc.docwriter.html_help-module.html">Module epydoc.docwriter.html_help</a></h1> <pre class="py-src"> <a name="L1"></a><tt class="py-lineno"> 1</tt> <tt class="py-line"><tt class="py-comment">#</tt> </tt> <a name="L2"></a><tt class="py-lineno"> 2</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># epydoc.css: default help page</tt> </tt> <a name="L3"></a><tt class="py-lineno"> 3</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Edward Loper</tt> </tt> <a name="L4"></a><tt class="py-lineno"> 4</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#</tt> </tt> <a name="L5"></a><tt class="py-lineno"> 5</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Created [01/30/01 05:18 PM]</tt> </tt> <a name="L6"></a><tt class="py-lineno"> 6</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># $Id: html_help.py 1239 2006-07-05 11:29:50Z edloper $</tt> </tt> <a name="L7"></a><tt class="py-lineno"> 7</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#</tt> </tt> <a name="L8"></a><tt class="py-lineno"> 8</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> <a name="L9"></a><tt class="py-lineno"> 9</tt> <tt class="py-line"><tt class="py-docstring">"""</tt> </tt> <a name="L10"></a><tt class="py-lineno"> 10</tt> <tt class="py-line"><tt class="py-docstring">Default help file for the HTML outputter (L{epydoc.docwriter.html}).</tt> </tt> <a name="L11"></a><tt class="py-lineno"> 11</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> <a name="L12"></a><tt class="py-lineno"> 12</tt> <tt class="py-line"><tt class="py-docstring">@type HTML_HELP: C{string}</tt> </tt> <a name="L13"></a><tt class="py-lineno"> 13</tt> <tt class="py-line"><tt class="py-docstring">@var HTML_HELP: The contents of the HTML body for the default</tt> </tt> <a name="L14"></a><tt class="py-lineno"> 14</tt> <tt class="py-line"><tt class="py-docstring">help page.</tt> </tt> <a name="L15"></a><tt class="py-lineno"> 15</tt> <tt class="py-line"><tt class="py-docstring">"""</tt> </tt> <a name="L16"></a><tt class="py-lineno"> 16</tt> <tt class="py-line"><tt class="py-name">__docformat__</tt> <tt class="py-op">=</tt> <tt class="py-string">'epytext en'</tt> </tt> <a name="L17"></a><tt class="py-lineno"> 17</tt> <tt class="py-line"> </tt> <a name="L18"></a><tt class="py-lineno"> 18</tt> <tt class="py-line"><tt class="py-comment"># Expects: {'this_project': name}</tt> </tt> <a name="L19"></a><tt class="py-lineno"> 19</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-0" class="py-name" targets="Variable epydoc.docwriter.html_help.HTML_HELP=epydoc.docwriter.html_help-module.html#HTML_HELP"><a title="epydoc.docwriter.html_help.HTML_HELP" class="py-name" href="#" onclick="return doclink('link-0', 'HTML_HELP', 'link-0');">HTML_HELP</a></tt> <tt class="py-op">=</tt> <tt class="py-string">'''</tt> </tt> <a name="L20"></a><tt class="py-lineno"> 20</tt> <tt class="py-line"><tt class="py-string"><h1 class="epydoc"> API Documentation </h1></tt> </tt> <a name="L21"></a><tt class="py-lineno"> 21</tt> <tt class="py-line"><tt class="py-string"></tt> </tt> <a name="L22"></a><tt class="py-lineno"> 22</tt> <tt class="py-line"><tt class="py-string"><p> This document contains the API (Application Programming Interface)</tt> </tt> <a name="L23"></a><tt class="py-lineno"> 23</tt> <tt class="py-line"><tt class="py-string">documentation for %(this_project)s. Documentation for the Python</tt> </tt> <a name="L24"></a><tt class="py-lineno"> 24</tt> <tt class="py-line"><tt class="py-string">objects defined by the project is divided into separate pages for each</tt> </tt> <a name="L25"></a><tt class="py-lineno"> 25</tt> <tt class="py-line"><tt class="py-string">package, module, and class. The API documentation also includes two</tt> </tt> <a name="L26"></a><tt class="py-lineno"> 26</tt> <tt class="py-line"><tt class="py-string">pages containing information about the project as a whole: a trees</tt> </tt> <a name="L27"></a><tt class="py-lineno"> 27</tt> <tt class="py-line"><tt class="py-string">page, and an index page. </p></tt> </tt> <a name="L28"></a><tt class="py-lineno"> 28</tt> <tt class="py-line"><tt class="py-string"></tt> </tt> <a name="L29"></a><tt class="py-lineno"> 29</tt> <tt class="py-line"><tt class="py-string"><h2> Object Documentation </h2></tt> </tt> <a name="L30"></a><tt class="py-lineno"> 30</tt> <tt class="py-line"><tt class="py-string"></tt> </tt> <a name="L31"></a><tt class="py-lineno"> 31</tt> <tt class="py-line"><tt class="py-string"> <p>Each <strong>Package Documentation</strong> page contains: </p></tt> </tt> <a name="L32"></a><tt class="py-lineno"> 32</tt> <tt class="py-line"><tt class="py-string"> <ul></tt> </tt> <a name="L33"></a><tt class="py-lineno"> 33</tt> <tt class="py-line"><tt class="py-string"> <li> A description of the package. </li></tt> </tt> <a name="L34"></a><tt class="py-lineno"> 34</tt> <tt class="py-line"><tt class="py-string"> <li> A list of the modules and sub-packages contained by the</tt> </tt> <a name="L35"></a><tt class="py-lineno"> 35</tt> <tt class="py-line"><tt class="py-string"> package. </li></tt> </tt> <a name="L36"></a><tt class="py-lineno"> 36</tt> <tt class="py-line"><tt class="py-string"> <li> A summary of the classes defined by the package. </li></tt> </tt> <a name="L37"></a><tt class="py-lineno"> 37</tt> <tt class="py-line"><tt class="py-string"> <li> A summary of the functions defined by the package. </li></tt> </tt> <a name="L38"></a><tt class="py-lineno"> 38</tt> <tt class="py-line"><tt class="py-string"> <li> A summary of the variables defined by the package. </li></tt> </tt> <a name="L39"></a><tt class="py-lineno"> 39</tt> <tt class="py-line"><tt class="py-string"> <li> A detailed description of each function defined by the</tt> </tt> <a name="L40"></a><tt class="py-lineno"> 40</tt> <tt class="py-line"><tt class="py-string"> package. </li></tt> </tt> <a name="L41"></a><tt class="py-lineno"> 41</tt> <tt class="py-line"><tt class="py-string"> <li> A detailed description of each variable defined by the</tt> </tt> <a name="L42"></a><tt class="py-lineno"> 42</tt> <tt class="py-line"><tt class="py-string"> package. </li></tt> </tt> <a name="L43"></a><tt class="py-lineno"> 43</tt> <tt class="py-line"><tt class="py-string"> </ul></tt> </tt> <a name="L44"></a><tt class="py-lineno"> 44</tt> <tt class="py-line"><tt class="py-string"> </tt> </tt> <a name="L45"></a><tt class="py-lineno"> 45</tt> <tt class="py-line"><tt class="py-string"> <p>Each <strong>Module Documentation</strong> page contains:</p></tt> </tt> <a name="L46"></a><tt class="py-lineno"> 46</tt> <tt class="py-line"><tt class="py-string"> <ul></tt> </tt> <a name="L47"></a><tt class="py-lineno"> 47</tt> <tt class="py-line"><tt class="py-string"> <li> A description of the module. </li></tt> </tt> <a name="L48"></a><tt class="py-lineno"> 48</tt> <tt class="py-line"><tt class="py-string"> <li> A summary of the classes defined by the module. </li></tt> </tt> <a name="L49"></a><tt class="py-lineno"> 49</tt> <tt class="py-line"><tt class="py-string"> <li> A summary of the functions defined by the module. </li></tt> </tt> <a name="L50"></a><tt class="py-lineno"> 50</tt> <tt class="py-line"><tt class="py-string"> <li> A summary of the variables defined by the module. </li></tt> </tt> <a name="L51"></a><tt class="py-lineno"> 51</tt> <tt class="py-line"><tt class="py-string"> <li> A detailed description of each function defined by the</tt> </tt> <a name="L52"></a><tt class="py-lineno"> 52</tt> <tt class="py-line"><tt class="py-string"> module. </li></tt> </tt> <a name="L53"></a><tt class="py-lineno"> 53</tt> <tt class="py-line"><tt class="py-string"> <li> A detailed description of each variable defined by the</tt> </tt> <a name="L54"></a><tt class="py-lineno"> 54</tt> <tt class="py-line"><tt class="py-string"> module. </li></tt> </tt> <a name="L55"></a><tt class="py-lineno"> 55</tt> <tt class="py-line"><tt class="py-string"> </ul></tt> </tt> <a name="L56"></a><tt class="py-lineno"> 56</tt> <tt class="py-line"><tt class="py-string"> </tt> </tt> <a name="L57"></a><tt class="py-lineno"> 57</tt> <tt class="py-line"><tt class="py-string"> <p>Each <strong>Class Documentation</strong> page contains: </p></tt> </tt> <a name="L58"></a><tt class="py-lineno"> 58</tt> <tt class="py-line"><tt class="py-string"> <ul></tt> </tt> <a name="L59"></a><tt class="py-lineno"> 59</tt> <tt class="py-line"><tt class="py-string"> <li> A class inheritance diagram. </li></tt> </tt> <a name="L60"></a><tt class="py-lineno"> 60</tt> <tt class="py-line"><tt class="py-string"> <li> A list of known subclasses. </li></tt> </tt> <a name="L61"></a><tt class="py-lineno"> 61</tt> <tt class="py-line"><tt class="py-string"> <li> A description of the class. </li></tt> </tt> <a name="L62"></a><tt class="py-lineno"> 62</tt> <tt class="py-line"><tt class="py-string"> <li> A summary of the methods defined by the class. </li></tt> </tt> <a name="L63"></a><tt class="py-lineno"> 63</tt> <tt class="py-line"><tt class="py-string"> <li> A summary of the instance variables defined by the class. </li></tt> </tt> <a name="L64"></a><tt class="py-lineno"> 64</tt> <tt class="py-line"><tt class="py-string"> <li> A summary of the class (static) variables defined by the</tt> </tt> <a name="L65"></a><tt class="py-lineno"> 65</tt> <tt class="py-line"><tt class="py-string"> class. </li> </tt> </tt> <a name="L66"></a><tt class="py-lineno"> 66</tt> <tt class="py-line"><tt class="py-string"> <li> A detailed description of each method defined by the</tt> </tt> <a name="L67"></a><tt class="py-lineno"> 67</tt> <tt class="py-line"><tt class="py-string"> class. </li></tt> </tt> <a name="L68"></a><tt class="py-lineno"> 68</tt> <tt class="py-line"><tt class="py-string"> <li> A detailed description of each instance variable defined by the</tt> </tt> <a name="L69"></a><tt class="py-lineno"> 69</tt> <tt class="py-line"><tt class="py-string"> class. </li> </tt> </tt> <a name="L70"></a><tt class="py-lineno"> 70</tt> <tt class="py-line"><tt class="py-string"> <li> A detailed description of each class (static) variable defined</tt> </tt> <a name="L71"></a><tt class="py-lineno"> 71</tt> <tt class="py-line"><tt class="py-string"> by the class. </li> </tt> </tt> <a name="L72"></a><tt class="py-lineno"> 72</tt> <tt class="py-line"><tt class="py-string"> </ul></tt> </tt> <a name="L73"></a><tt class="py-lineno"> 73</tt> <tt class="py-line"><tt class="py-string"></tt> </tt> <a name="L74"></a><tt class="py-lineno"> 74</tt> <tt class="py-line"><tt class="py-string"><h2> Project Documentation </h2></tt> </tt> <a name="L75"></a><tt class="py-lineno"> 75</tt> <tt class="py-line"><tt class="py-string"></tt> </tt> <a name="L76"></a><tt class="py-lineno"> 76</tt> <tt class="py-line"><tt class="py-string"> <p> The <strong>Trees</strong> page contains the module and class hierarchies: </p></tt> </tt> <a name="L77"></a><tt class="py-lineno"> 77</tt> <tt class="py-line"><tt class="py-string"> <ul></tt> </tt> <a name="L78"></a><tt class="py-lineno"> 78</tt> <tt class="py-line"><tt class="py-string"> <li> The <em>module hierarchy</em> lists every package and module, with</tt> </tt> <a name="L79"></a><tt class="py-lineno"> 79</tt> <tt class="py-line"><tt class="py-string"> modules grouped into packages. At the top level, and within each</tt> </tt> <a name="L80"></a><tt class="py-lineno"> 80</tt> <tt class="py-line"><tt class="py-string"> package, modules and sub-packages are listed alphabetically. </li></tt> </tt> <a name="L81"></a><tt class="py-lineno"> 81</tt> <tt class="py-line"><tt class="py-string"> <li> The <em>class hierarchy</em> lists every class, grouped by base</tt> </tt> <a name="L82"></a><tt class="py-lineno"> 82</tt> <tt class="py-line"><tt class="py-string"> class. If a class has more than one base class, then it will be</tt> </tt> <a name="L83"></a><tt class="py-lineno"> 83</tt> <tt class="py-line"><tt class="py-string"> listed under each base class. At the top level, and under each base</tt> </tt> <a name="L84"></a><tt class="py-lineno"> 84</tt> <tt class="py-line"><tt class="py-string"> class, classes are listed alphabetically. </li></tt> </tt> <a name="L85"></a><tt class="py-lineno"> 85</tt> <tt class="py-line"><tt class="py-string"> </ul></tt> </tt> <a name="L86"></a><tt class="py-lineno"> 86</tt> <tt class="py-line"><tt class="py-string"> </tt> </tt> <a name="L87"></a><tt class="py-lineno"> 87</tt> <tt class="py-line"><tt class="py-string"> <p> The <strong>Index</strong> page contains indices of terms and</tt> </tt> <a name="L88"></a><tt class="py-lineno"> 88</tt> <tt class="py-line"><tt class="py-string"> identifiers: </p></tt> </tt> <a name="L89"></a><tt class="py-lineno"> 89</tt> <tt class="py-line"><tt class="py-string"> <ul></tt> </tt> <a name="L90"></a><tt class="py-lineno"> 90</tt> <tt class="py-line"><tt class="py-string"> <li> The <em>term index</em> lists every term indexed by any object\'s</tt> </tt> <a name="L91"></a><tt class="py-lineno"> 91</tt> <tt class="py-line"><tt class="py-string"> documentation. For each term, the index provides links to each</tt> </tt> <a name="L92"></a><tt class="py-lineno"> 92</tt> <tt class="py-line"><tt class="py-string"> place where the term is indexed. </li></tt> </tt> <a name="L93"></a><tt class="py-lineno"> 93</tt> <tt class="py-line"><tt class="py-string"> <li> The <em>identifier index</em> lists the (short) name of every package,</tt> </tt> <a name="L94"></a><tt class="py-lineno"> 94</tt> <tt class="py-line"><tt class="py-string"> module, class, method, function, variable, and parameter. For each</tt> </tt> <a name="L95"></a><tt class="py-lineno"> 95</tt> <tt class="py-line"><tt class="py-string"> identifier, the index provides a short description, and a link to</tt> </tt> <a name="L96"></a><tt class="py-lineno"> 96</tt> <tt class="py-line"><tt class="py-string"> its documentation. </li></tt> </tt> <a name="L97"></a><tt class="py-lineno"> 97</tt> <tt class="py-line"><tt class="py-string"> </ul></tt> </tt> <a name="L98"></a><tt class="py-lineno"> 98</tt> <tt class="py-line"><tt class="py-string"></tt> </tt> <a name="L99"></a><tt class="py-lineno"> 99</tt> <tt class="py-line"><tt class="py-string"><h2> The Table of Contents </h2></tt> </tt> <a name="L100"></a><tt class="py-lineno">100</tt> <tt class="py-line"><tt class="py-string"></tt> </tt> <a name="L101"></a><tt class="py-lineno">101</tt> <tt class="py-line"><tt class="py-string"><p> The table of contents occupies the two frames on the left side of</tt> </tt> <a name="L102"></a><tt class="py-lineno">102</tt> <tt class="py-line"><tt class="py-string">the window. The upper-left frame displays the <em>project</tt> </tt> <a name="L103"></a><tt class="py-lineno">103</tt> <tt class="py-line"><tt class="py-string">contents</em>, and the lower-left frame displays the <em>module</tt> </tt> <a name="L104"></a><tt class="py-lineno">104</tt> <tt class="py-line"><tt class="py-string">contents</em>: </p></tt> </tt> <a name="L105"></a><tt class="py-lineno">105</tt> <tt class="py-line"><tt class="py-string"></tt> </tt> <a name="L106"></a><tt class="py-lineno">106</tt> <tt class="py-line"><tt class="py-string"><table class="help summary" border="1" cellspacing="0" cellpadding="3"></tt> </tt> <a name="L107"></a><tt class="py-lineno">107</tt> <tt class="py-line"><tt class="py-string"> <tr style="height: 30%%"></tt> </tt> <a name="L108"></a><tt class="py-lineno">108</tt> <tt class="py-line"><tt class="py-string"> <td align="center" style="font-size: small"></tt> </tt> <a name="L109"></a><tt class="py-lineno">109</tt> <tt class="py-line"><tt class="py-string"> Project<br />Contents<hr />...</td></tt> </tt> <a name="L110"></a><tt class="py-lineno">110</tt> <tt class="py-line"><tt class="py-string"> <td align="center" style="font-size: small" rowspan="2" width="70%%"></tt> </tt> <a name="L111"></a><tt class="py-lineno">111</tt> <tt class="py-line"><tt class="py-string"> API<br />Documentation<br />Frame<br /><br /><br /></tt> </tt> <a name="L112"></a><tt class="py-lineno">112</tt> <tt class="py-line"><tt class="py-string"> </td></tt> </tt> <a name="L113"></a><tt class="py-lineno">113</tt> <tt class="py-line"><tt class="py-string"> </tr></tt> </tt> <a name="L114"></a><tt class="py-lineno">114</tt> <tt class="py-line"><tt class="py-string"> <tr></tt> </tt> <a name="L115"></a><tt class="py-lineno">115</tt> <tt class="py-line"><tt class="py-string"> <td align="center" style="font-size: small"></tt> </tt> <a name="L116"></a><tt class="py-lineno">116</tt> <tt class="py-line"><tt class="py-string"> Module<br />Contents<hr />&nbsp;<br />...<br />&nbsp;</tt> </tt> <a name="L117"></a><tt class="py-lineno">117</tt> <tt class="py-line"><tt class="py-string"> </td></tt> </tt> <a name="L118"></a><tt class="py-lineno">118</tt> <tt class="py-line"><tt class="py-string"> </tr></tt> </tt> <a name="L119"></a><tt class="py-lineno">119</tt> <tt class="py-line"><tt class="py-string"></table><br /></tt> </tt> <a name="L120"></a><tt class="py-lineno">120</tt> <tt class="py-line"><tt class="py-string"></tt> </tt> <a name="L121"></a><tt class="py-lineno">121</tt> <tt class="py-line"><tt class="py-string"><p> The <strong>project contents frame</strong> contains a list of all packages</tt> </tt> <a name="L122"></a><tt class="py-lineno">122</tt> <tt class="py-line"><tt class="py-string">and modules that are defined by the project. Clicking on an entry</tt> </tt> <a name="L123"></a><tt class="py-lineno">123</tt> <tt class="py-line"><tt class="py-string">will display its contents in the module contents frame. Clicking on a</tt> </tt> <a name="L124"></a><tt class="py-lineno">124</tt> <tt class="py-line"><tt class="py-string">special entry, labeled "Everything," will display the contents of</tt> </tt> <a name="L125"></a><tt class="py-lineno">125</tt> <tt class="py-line"><tt class="py-string">the entire project. </p></tt> </tt> <a name="L126"></a><tt class="py-lineno">126</tt> <tt class="py-line"><tt class="py-string"></tt> </tt> <a name="L127"></a><tt class="py-lineno">127</tt> <tt class="py-line"><tt class="py-string"><p> The <strong>module contents frame</strong> contains a list of every</tt> </tt> <a name="L128"></a><tt class="py-lineno">128</tt> <tt class="py-line"><tt class="py-string">submodule, class, type, exception, function, and variable defined by a</tt> </tt> <a name="L129"></a><tt class="py-lineno">129</tt> <tt class="py-line"><tt class="py-string">module or package. Clicking on an entry will display its</tt> </tt> <a name="L130"></a><tt class="py-lineno">130</tt> <tt class="py-line"><tt class="py-string">documentation in the API documentation frame. Clicking on the name of</tt> </tt> <a name="L131"></a><tt class="py-lineno">131</tt> <tt class="py-line"><tt class="py-string">the module, at the top of the frame, will display the documentation</tt> </tt> <a name="L132"></a><tt class="py-lineno">132</tt> <tt class="py-line"><tt class="py-string">for the module itself. </p></tt> </tt> <a name="L133"></a><tt class="py-lineno">133</tt> <tt class="py-line"><tt class="py-string"></tt> </tt> <a name="L134"></a><tt class="py-lineno">134</tt> <tt class="py-line"><tt class="py-string"><p> The "<strong>frames</strong>" and "<strong>no frames</strong>" buttons below the top</tt> </tt> <a name="L135"></a><tt class="py-lineno">135</tt> <tt class="py-line"><tt class="py-string">navigation bar can be used to control whether the table of contents is</tt> </tt> <a name="L136"></a><tt class="py-lineno">136</tt> <tt class="py-line"><tt class="py-string">displayed or not. </p></tt> </tt> <a name="L137"></a><tt class="py-lineno">137</tt> <tt class="py-line"><tt class="py-string"></tt> </tt> <a name="L138"></a><tt class="py-lineno">138</tt> <tt class="py-line"><tt class="py-string"><h2> The Navigation Bar </h2></tt> </tt> <a name="L139"></a><tt class="py-lineno">139</tt> <tt class="py-line"><tt class="py-string"></tt> </tt> <a name="L140"></a><tt class="py-lineno">140</tt> <tt class="py-line"><tt class="py-string"><p> A navigation bar is located at the top and bottom of every page.</tt> </tt> <a name="L141"></a><tt class="py-lineno">141</tt> <tt class="py-line"><tt class="py-string">It indicates what type of page you are currently viewing, and allows</tt> </tt> <a name="L142"></a><tt class="py-lineno">142</tt> <tt class="py-line"><tt class="py-string">you to go to related pages. The following table describes the labels</tt> </tt> <a name="L143"></a><tt class="py-lineno">143</tt> <tt class="py-line"><tt class="py-string">on the navigation bar. Note that not some labels (such as</tt> </tt> <a name="L144"></a><tt class="py-lineno">144</tt> <tt class="py-line"><tt class="py-string">[Parent]) are not displayed on all pages. </p></tt> </tt> <a name="L145"></a><tt class="py-lineno">145</tt> <tt class="py-line"><tt class="py-string"></tt> </tt> <a name="L146"></a><tt class="py-lineno">146</tt> <tt class="py-line"><tt class="py-string"><table class="summary" border="1" cellspacing="0" cellpadding="3" width="100%%"></tt> </tt> <a name="L147"></a><tt class="py-lineno">147</tt> <tt class="py-line"><tt class="py-string"><tr class="summary"></tt> </tt> <a name="L148"></a><tt class="py-lineno">148</tt> <tt class="py-line"><tt class="py-string"> <th>Label</th></tt> </tt> <a name="L149"></a><tt class="py-lineno">149</tt> <tt class="py-line"><tt class="py-string"> <th>Highlighted when...</th></tt> </tt> <a name="L150"></a><tt class="py-lineno">150</tt> <tt class="py-line"><tt class="py-string"> <th>Links to...</th></tt> </tt> <a name="L151"></a><tt class="py-lineno">151</tt> <tt class="py-line"><tt class="py-string"></tr></tt> </tt> <a name="L152"></a><tt class="py-lineno">152</tt> <tt class="py-line"><tt class="py-string"> <tr><td valign="top"><strong>[Parent]</strong></td></tt> </tt> <a name="L153"></a><tt class="py-lineno">153</tt> <tt class="py-line"><tt class="py-string"> <td valign="top"><em>(never highlighted)</em></td></tt> </tt> <a name="L154"></a><tt class="py-lineno">154</tt> <tt class="py-line"><tt class="py-string"> <td valign="top"> the parent of the current package </td></tr></tt> </tt> <a name="L155"></a><tt class="py-lineno">155</tt> <tt class="py-line"><tt class="py-string"> <tr><td valign="top"><strong>[Package]</strong></td></tt> </tt> <a name="L156"></a><tt class="py-lineno">156</tt> <tt class="py-line"><tt class="py-string"> <td valign="top">viewing a package</td></tt> </tt> <a name="L157"></a><tt class="py-lineno">157</tt> <tt class="py-line"><tt class="py-string"> <td valign="top">the package containing the current object</tt> </tt> <a name="L158"></a><tt class="py-lineno">158</tt> <tt class="py-line"><tt class="py-string"> </td></tr></tt> </tt> <a name="L159"></a><tt class="py-lineno">159</tt> <tt class="py-line"><tt class="py-string"> <tr><td valign="top"><strong>[Module]</strong></td></tt> </tt> <a name="L160"></a><tt class="py-lineno">160</tt> <tt class="py-line"><tt class="py-string"> <td valign="top">viewing a module</td></tt> </tt> <a name="L161"></a><tt class="py-lineno">161</tt> <tt class="py-line"><tt class="py-string"> <td valign="top">the module containing the current object</tt> </tt> <a name="L162"></a><tt class="py-lineno">162</tt> <tt class="py-line"><tt class="py-string"> </td></tr> </tt> </tt> <a name="L163"></a><tt class="py-lineno">163</tt> <tt class="py-line"><tt class="py-string"> <tr><td valign="top"><strong>[Class]</strong></td></tt> </tt> <a name="L164"></a><tt class="py-lineno">164</tt> <tt class="py-line"><tt class="py-string"> <td valign="top">viewing a class </td></tt> </tt> <a name="L165"></a><tt class="py-lineno">165</tt> <tt class="py-line"><tt class="py-string"> <td valign="top">the class containing the current object</td></tr></tt> </tt> <a name="L166"></a><tt class="py-lineno">166</tt> <tt class="py-line"><tt class="py-string"> <tr><td valign="top"><strong>[Trees]</strong></td></tt> </tt> <a name="L167"></a><tt class="py-lineno">167</tt> <tt class="py-line"><tt class="py-string"> <td valign="top">viewing the trees page</td></tt> </tt> <a name="L168"></a><tt class="py-lineno">168</tt> <tt class="py-line"><tt class="py-string"> <td valign="top"> the trees page </td></tr></tt> </tt> <a name="L169"></a><tt class="py-lineno">169</tt> <tt class="py-line"><tt class="py-string"> <tr><td valign="top"><strong>[Index]</strong></td></tt> </tt> <a name="L170"></a><tt class="py-lineno">170</tt> <tt class="py-line"><tt class="py-string"> <td valign="top">viewing the index page</td></tt> </tt> <a name="L171"></a><tt class="py-lineno">171</tt> <tt class="py-line"><tt class="py-string"> <td valign="top"> the index page </td></tr></tt> </tt> <a name="L172"></a><tt class="py-lineno">172</tt> <tt class="py-line"><tt class="py-string"> <tr><td valign="top"><strong>[Help]</strong></td></tt> </tt> <a name="L173"></a><tt class="py-lineno">173</tt> <tt class="py-line"><tt class="py-string"> <td valign="top">viewing the help page</td></tt> </tt> <a name="L174"></a><tt class="py-lineno">174</tt> <tt class="py-line"><tt class="py-string"> <td valign="top"> the help page </td></tr></tt> </tt> <a name="L175"></a><tt class="py-lineno">175</tt> <tt class="py-line"><tt class="py-string"></table></tt> </tt> <a name="L176"></a><tt class="py-lineno">176</tt> <tt class="py-line"><tt class="py-string"></tt> </tt> <a name="L177"></a><tt class="py-lineno">177</tt> <tt class="py-line"><tt class="py-string"><p> The "<strong>show private</strong>" and "<strong>hide private</strong>" buttons below</tt> </tt> <a name="L178"></a><tt class="py-lineno">178</tt> <tt class="py-line"><tt class="py-string">the top navigation bar can be used to control whether documentation</tt> </tt> <a name="L179"></a><tt class="py-lineno">179</tt> <tt class="py-line"><tt class="py-string">for private objects is displayed. Private objects are usually defined</tt> </tt> <a name="L180"></a><tt class="py-lineno">180</tt> <tt class="py-line"><tt class="py-string">as objects whose (short) names begin with a single underscore, but do</tt> </tt> <a name="L181"></a><tt class="py-lineno">181</tt> <tt class="py-line"><tt class="py-string">not end with an underscore. For example, "<code>_x</code>",</tt> </tt> <a name="L182"></a><tt class="py-lineno">182</tt> <tt class="py-line"><tt class="py-string">"<code>__pprint</code>", and "<code>epydoc.epytext._tokenize</code>"</tt> </tt> <a name="L183"></a><tt class="py-lineno">183</tt> <tt class="py-line"><tt class="py-string">are private objects; but "<code>re.sub</code>",</tt> </tt> <a name="L184"></a><tt class="py-lineno">184</tt> <tt class="py-line"><tt class="py-string">"<code>__init__</code>", and "<code>type_</code>" are not. However,</tt> </tt> <a name="L185"></a><tt class="py-lineno">185</tt> <tt class="py-line"><tt class="py-string">if a module defines the "<code>__all__</code>" variable, then its</tt> </tt> <a name="L186"></a><tt class="py-lineno">186</tt> <tt class="py-line"><tt class="py-string">contents are used to decide which objects are private. </p></tt> </tt> <a name="L187"></a><tt class="py-lineno">187</tt> <tt class="py-line"><tt class="py-string"></tt> </tt> <a name="L188"></a><tt class="py-lineno">188</tt> <tt class="py-line"><tt class="py-string"><p> A timestamp below the bottom navigation bar indicates when each</tt> </tt> <a name="L189"></a><tt class="py-lineno">189</tt> <tt class="py-line"><tt class="py-string">page was last updated. </p></tt> </tt> <a name="L190"></a><tt class="py-lineno">190</tt> <tt class="py-line"><tt class="py-string">'''</tt> </tt> <a name="L191"></a><tt class="py-lineno">191</tt> <tt class="py-line"> </tt><script type="text/javascript"> <!-- expandto(location.href); // --> </script> </pre> <br /> <!-- ==================== NAVIGATION BAR ==================== --> <table class="navbar" border="0" width="100%" cellpadding="0" bgcolor="#a0c0ff" cellspacing="0"> <tr valign="middle"> <!-- Home link --> <th> <a href="epydoc-module.html">Home</a> </th> <!-- Tree link --> <th> <a href="module-tree.html">Trees</a> </th> <!-- Index link --> <th> <a href="identifier-index.html">Indices</a> </th> <!-- Help link --> <th> <a href="help.html">Help</a> </th> <!-- Project homepage --> <th class="navbar" align="right" width="100%"> <table border="0" cellpadding="0" cellspacing="0"> <tr><th class="navbar" align="center" ><a class="navbar" target="_top" href="http://epydoc.sourceforge.net">epydoc 3.0.1</a></th> </tr></table></th> </tr> </table> <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> <a href="epydoc-log.html">Generated by Epydoc 3.0.1 on Wed Jan 30 14:09:56 2008</a> </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" >http://epydoc.sourceforge.net</a> </td> </tr> </table> <script type="text/javascript"> <!-- // Private objects are initially displayed (because if // javascript is turned off then we want them to be // visible); but by default, we want to hide them. So hide // them unless we have a cookie that says to show them. checkCookie(); // --> </script> </body> </html>