Documentation/Source/eric5.DocumentationTools.APIGenerator.html

changeset 58
37f0444c3479
parent 21
b88a0e6268bd
child 253
3ccdf551bde7
diff -r 81326a94fdca -r 37f0444c3479 Documentation/Source/eric5.DocumentationTools.APIGenerator.html
--- a/Documentation/Source/eric5.DocumentationTools.APIGenerator.html	Thu Jan 14 17:27:31 2010 +0000
+++ b/Documentation/Source/eric5.DocumentationTools.APIGenerator.html	Thu Jan 14 18:35:52 2010 +0000
@@ -22,7 +22,7 @@
 <body><a NAME="top" ID="top"></a>
 <h1>eric5.DocumentationTools.APIGenerator</h1>
 <p>
-&#77;&#111;&#100;&#117;&#108;&#101; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#98;&#117;&#105;&#108;&#116;&#105;&#110; &#65;&#80;&#73; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#111;&#114;.
+Module implementing the builtin API generator.
 </p>
 <h3>Global Attributes</h3>
 <table>
@@ -32,7 +32,7 @@
 <table>
 <tr>
 <td><a href="#APIGenerator">APIGenerator</a></td>
-<td>&#67;&#108;&#97;&#115;&#115; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#98;&#117;&#105;&#108;&#116;&#105;&#110; &#100;&#111;&#99;&#117;&#109;&#101;&#110;&#116;&#97;&#116;&#105;&#111;&#110; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#111;&#114;.</td>
+<td>Class implementing the builtin documentation generator.</td>
 </tr>
 </table>
 <h3>Functions</h3>
@@ -43,7 +43,7 @@
 <a NAME="APIGenerator" ID="APIGenerator"></a>
 <h2>APIGenerator</h2>
 <p>
-    &#67;&#108;&#97;&#115;&#115; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#98;&#117;&#105;&#108;&#116;&#105;&#110; &#100;&#111;&#99;&#117;&#109;&#101;&#110;&#116;&#97;&#116;&#105;&#111;&#110; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#111;&#114;.
+    Class implementing the builtin documentation generator.
 </p>
 <h3>Derived from</h3>
 object
@@ -55,112 +55,112 @@
 <table>
 <tr>
 <td><a href="#APIGenerator.__init__">APIGenerator</a></td>
-<td>&#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;</td>
+<td>Constructor</td>
 </tr><tr>
 <td><a href="#APIGenerator.__addClassVariablesAPI">__addClassVariablesAPI</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#99;&#108;&#97;&#115;&#115; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#99;&#108;&#97;&#115;&#115; v&#97;&#114;&#105;&#97;&#98;&#108;&#101;&#115;.</td>
+<td>Private method to generate class api section for class variables.</td>
 </tr><tr>
 <td><a href="#APIGenerator.__addClassesAPI">__addClassesAPI</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#99;&#108;&#97;&#115;&#115;&#101;&#115;.</td>
+<td>Private method to generate the api section for classes.</td>
 </tr><tr>
 <td><a href="#APIGenerator.__addFunctionsAPI">__addFunctionsAPI</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110;&#115;.</td>
+<td>Private method to generate the api section for functions.</td>
 </tr><tr>
 <td><a href="#APIGenerator.__addGlobalsAPI">__addGlobalsAPI</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#103;&#108;&#111;&#98;&#97;&#108; v&#97;&#114;&#105;&#97;&#98;&#108;&#101;&#115;.</td>
+<td>Private method to generate the api section for global variables.</td>
 </tr><tr>
 <td><a href="#APIGenerator.__addMethodsAPI">__addMethodsAPI</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#99;&#108;&#97;&#115;&#115; &#109;&#101;&#116;&#104;&#111;&#100;&#115;.</td>
+<td>Private method to generate the api section for class methods.</td>
 </tr><tr>
 <td><a href="#APIGenerator.__isPrivate">__isPrivate</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#99;&#104;&#101;&#99;&#107;, &#105;&#102; &#97;&#110; &#111;&#98;&#106;&#101;&#99;&#116; &#105;&#115; &#99;&#111;&#110;&#115;&#105;&#100;&#101;&#114;&#101;&#100; &#112;&#114;&#105;v&#97;&#116;&#101;.</td>
+<td>Private method to check, if an object is considered private.</td>
 </tr><tr>
 <td><a href="#APIGenerator.genAPI">genAPI</a></td>
-<td>&#77;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#115;&#111;&#117;&#114;&#99;&#101; &#99;&#111;&#100;&#101; &#100;&#111;&#99;&#117;&#109;&#101;&#110;&#116;&#97;&#116;&#105;&#111;&#110;.</td>
+<td>Method to generate the source code documentation.</td>
 </tr>
 </table>
 <a NAME="APIGenerator.__init__" ID="APIGenerator.__init__"></a>
 <h4>APIGenerator (Constructor)</h4>
 <b>APIGenerator</b>(<i>module</i>)
 <p>
-        &#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;
+        Constructor
 </p><dl>
 <dt><i>module</i></dt>
 <dd>
-&#84;&#104;&#101; &#105;&#110;&#102;&#111;&#114;&#109;&#97;&#116;&#105;&#111;&#110; &#111;&#102; &#116;&#104;&#101; &#112;&#97;&#114;&#115;&#101;&#100; &#80;y&#116;&#104;&#111;&#110; &#102;&#105;&#108;&#101;.
+The information of the parsed Python file.
 </dd>
 </dl><a NAME="APIGenerator.__addClassVariablesAPI" ID="APIGenerator.__addClassVariablesAPI"></a>
 <h4>APIGenerator.__addClassVariablesAPI</h4>
 <b>__addClassVariablesAPI</b>(<i>className</i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#99;&#108;&#97;&#115;&#115; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#99;&#108;&#97;&#115;&#115; v&#97;&#114;&#105;&#97;&#98;&#108;&#101;&#115;.
+        Private method to generate class api section for class variables.
 </p><dl>
 <dt><i>classname</i></dt>
 <dd>
-&#78;&#97;&#109;&#101; &#111;&#102; &#116;&#104;&#101; &#99;&#108;&#97;&#115;&#115; &#99;&#111;&#110;&#116;&#97;&#105;&#110;&#105;&#110;&#103; &#116;&#104;&#101; &#99;&#108;&#97;&#115;&#115; v&#97;&#114;&#105;&#97;&#98;&#108;&#101;&#115;. (&#115;&#116;&#114;&#105;&#110;&#103;)
+Name of the class containing the class variables. (string)
 </dd>
 </dl><a NAME="APIGenerator.__addClassesAPI" ID="APIGenerator.__addClassesAPI"></a>
 <h4>APIGenerator.__addClassesAPI</h4>
 <b>__addClassesAPI</b>(<i></i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#99;&#108;&#97;&#115;&#115;&#101;&#115;.
+        Private method to generate the api section for classes.
 </p><a NAME="APIGenerator.__addFunctionsAPI" ID="APIGenerator.__addFunctionsAPI"></a>
 <h4>APIGenerator.__addFunctionsAPI</h4>
 <b>__addFunctionsAPI</b>(<i></i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110;&#115;.
+        Private method to generate the api section for functions.
 </p><a NAME="APIGenerator.__addGlobalsAPI" ID="APIGenerator.__addGlobalsAPI"></a>
 <h4>APIGenerator.__addGlobalsAPI</h4>
 <b>__addGlobalsAPI</b>(<i></i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#103;&#108;&#111;&#98;&#97;&#108; v&#97;&#114;&#105;&#97;&#98;&#108;&#101;&#115;. 
+        Private method to generate the api section for global variables. 
 </p><a NAME="APIGenerator.__addMethodsAPI" ID="APIGenerator.__addMethodsAPI"></a>
 <h4>APIGenerator.__addMethodsAPI</h4>
 <b>__addMethodsAPI</b>(<i>className</i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#97;&#112;&#105; &#115;&#101;&#99;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#99;&#108;&#97;&#115;&#115; &#109;&#101;&#116;&#104;&#111;&#100;&#115;.
+        Private method to generate the api section for class methods.
 </p><dl>
 <dt><i>classname</i></dt>
 <dd>
-&#78;&#97;&#109;&#101; &#111;&#102; &#116;&#104;&#101; &#99;&#108;&#97;&#115;&#115; &#99;&#111;&#110;&#116;&#97;&#105;&#110;&#105;&#110;&#103; &#116;&#104;&#101; &#109;&#101;&#116;&#104;&#111;&#100;. (&#115;&#116;&#114;&#105;&#110;&#103;)
+Name of the class containing the method. (string)
 </dd>
 </dl><a NAME="APIGenerator.__isPrivate" ID="APIGenerator.__isPrivate"></a>
 <h4>APIGenerator.__isPrivate</h4>
 <b>__isPrivate</b>(<i>obj</i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#99;&#104;&#101;&#99;&#107;, &#105;&#102; &#97;&#110; &#111;&#98;&#106;&#101;&#99;&#116; &#105;&#115; &#99;&#111;&#110;&#115;&#105;&#100;&#101;&#114;&#101;&#100; &#112;&#114;&#105;v&#97;&#116;&#101;.
+        Private method to check, if an object is considered private.
 </p><dl>
 <dt><i>obj</i></dt>
 <dd>
-&#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#111;&#98;&#106;&#101;&#99;&#116; &#116;&#111; &#98;&#101; &#99;&#104;&#101;&#99;&#107;&#101;&#100;
+reference to the object to be checked
 </dd>
 </dl><dl>
 <dt>Returns:</dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103;, &#116;&#104;&#97;&#116; &#111;&#98;&#106;&#101;&#99;&#116; &#105;&#115; &#99;&#111;&#110;&#115;&#105;&#100;&#101;&#114;&#101;&#100; &#112;&#114;&#105;v&#97;&#116;&#101; (&#98;&#111;&#111;&#108;&#101;&#97;&#110;)
+flag indicating, that object is considered private (boolean)
 </dd>
 </dl><a NAME="APIGenerator.genAPI" ID="APIGenerator.genAPI"></a>
 <h4>APIGenerator.genAPI</h4>
 <b>genAPI</b>(<i>newStyle, basePackage, includePrivate</i>)
 <p>
-        &#77;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#101; &#116;&#104;&#101; &#115;&#111;&#117;&#114;&#99;&#101; &#99;&#111;&#100;&#101; &#100;&#111;&#99;&#117;&#109;&#101;&#110;&#116;&#97;&#116;&#105;&#111;&#110;.
+        Method to generate the source code documentation.
 </p><dl>
 <dt><i>newStyle</i></dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#97;&#112;&#105; &#103;&#101;&#110;&#101;&#114;&#97;&#116;&#105;&#111;&#110; &#102;&#111;&#114; &#81;&#83;&#99;&#105;&#110;&#116;&#105;&#108;&#108;&#97; &#49;.&#55; &#97;&#110;&#100;
-            &#110;&#101;w&#101;&#114; (&#98;&#111;&#111;&#108;&#101;&#97;&#110;)
+flag indicating the api generation for QScintilla 1.7 and
+            newer (boolean)
 </dd><dt><i>basePackage</i></dt>
 <dd>
-&#110;&#97;&#109;&#101; &#111;&#102; &#116;&#104;&#101; &#98;&#97;&#115;&#101; &#112;&#97;&#99;&#107;&#97;&#103;&#101; (&#115;&#116;&#114;&#105;&#110;&#103;)
+name of the base package (string)
 </dd><dt><i>includePrivate</i></dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#116;&#111; &#105;&#110;&#99;&#108;&#117;&#100;&#101;
-            &#112;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100;&#115;/&#102;&#117;&#110;&#99;&#116;&#105;&#111;&#110;&#115; (&#98;&#111;&#111;&#108;&#101;&#97;&#110;)
+flag indicating to include
+            private methods/functions (boolean)
 </dd>
 </dl><dl>
 <dt>Returns:</dt>
 <dd>
-&#84;&#104;&#101; &#65;&#80;&#73; &#105;&#110;&#102;&#111;&#114;&#109;&#97;&#116;&#105;&#111;&#110;. (&#115;&#116;&#114;&#105;&#110;&#103;)
+The API information. (string)
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>

eric ide

mercurial