--- a/Documentation/Source/eric5.PluginManager.PluginInstallDialog.html	Thu Jan 14 17:27:31 2010 +0000
+++ b/Documentation/Source/eric5.PluginManager.PluginInstallDialog.html	Thu Jan 14 18:35:52 2010 +0000
@@ -22,7 +22,7 @@
 <body><a NAME="top" ID="top"></a>
 <h1>eric5.PluginManager.PluginInstallDialog</h1>
 <p>
-&#77;&#111;&#100;&#117;&#108;&#101; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#80;&#108;&#117;&#103;&#105;&#110; &#105;&#110;&#115;&#116;&#97;&#108;&#108;&#97;&#116;&#105;&#111;&#110; &#100;&#105;&#97;&#108;&#111;&#103;.
+Module implementing the Plugin installation dialog.
 </p>
 <h3>Global Attributes</h3>
 <table>
@@ -32,13 +32,13 @@
 <table>
 <tr>
 <td><a href="#PluginInstallDialog">PluginInstallDialog</a></td>
-<td>&#67;&#108;&#97;&#115;&#115; &#102;&#111;&#114; &#116;&#104;&#101; &#100;&#105;&#97;&#108;&#111;&#103; v&#97;&#114;&#105;&#97;&#110;&#116;.</td>
+<td>Class for the dialog variant.</td>
 </tr><tr>
 <td><a href="#PluginInstallWidget">PluginInstallWidget</a></td>
-<td>&#67;&#108;&#97;&#115;&#115; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#80;&#108;&#117;&#103;&#105;&#110; &#105;&#110;&#115;&#116;&#97;&#108;&#108;&#97;&#116;&#105;&#111;&#110; &#100;&#105;&#97;&#108;&#111;&#103;.</td>
+<td>Class implementing the Plugin installation dialog.</td>
 </tr><tr>
 <td><a href="#PluginInstallWindow">PluginInstallWindow</a></td>
-<td>&#77;&#97;&#105;&#110; w&#105;&#110;&#100;&#111;w &#99;&#108;&#97;&#115;&#115; &#102;&#111;&#114; &#116;&#104;&#101; &#115;&#116;&#97;&#110;&#100;&#97;&#108;&#111;&#110;&#101; &#100;&#105;&#97;&#108;&#111;&#103;.</td>
+<td>Main window class for the standalone dialog.</td>
 </tr>
 </table>
 <h3>Functions</h3>
@@ -49,7 +49,7 @@
 <a NAME="PluginInstallDialog" ID="PluginInstallDialog"></a>
 <h2>PluginInstallDialog</h2>
 <p>
-    &#67;&#108;&#97;&#115;&#115; &#102;&#111;&#114; &#116;&#104;&#101; &#100;&#105;&#97;&#108;&#111;&#103; v&#97;&#114;&#105;&#97;&#110;&#116;.
+    Class for the dialog variant.
 </p>
 <h3>Derived from</h3>
 QDialog
@@ -61,38 +61,38 @@
 <table>
 <tr>
 <td><a href="#PluginInstallDialog.__init__">PluginInstallDialog</a></td>
-<td>&#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;</td>
+<td>Constructor</td>
 </tr><tr>
 <td><a href="#PluginInstallDialog.restartNeeded">restartNeeded</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#99;&#104;&#101;&#99;&#107;, &#105;&#102; &#97; &#114;&#101;&#115;&#116;&#97;&#114;&#116; &#111;&#102; &#116;&#104;&#101; &#73;&#68;&#69; &#105;&#115; &#114;&#101;&#113;&#117;&#105;&#114;&#101;&#100;.</td>
+<td>Public method to check, if a restart of the IDE is required.</td>
 </tr>
 </table>
 <a NAME="PluginInstallDialog.__init__" ID="PluginInstallDialog.__init__"></a>
 <h4>PluginInstallDialog (Constructor)</h4>
 <b>PluginInstallDialog</b>(<i>pluginManager, pluginFileNames, parent = None</i>)
 <p>
-        &#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;
+        Constructor
 </p><dl>
 <dt><i>pluginManager</i></dt>
 <dd>
-&#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#112;&#108;&#117;&#103;&#105;&#110; &#109;&#97;&#110;&#97;&#103;&#101;&#114; &#111;&#98;&#106;&#101;&#99;&#116;
+reference to the plugin manager object
 </dd><dt><i>pluginFileNames</i></dt>
 <dd>
-&#108;&#105;&#115;&#116; &#111;&#102; &#112;&#108;&#117;&#103;&#105;&#110; &#102;&#105;&#108;&#101;&#115; &#115;&#117;&#103;&#103;&#101;&#115;&#116;&#101;&#100; &#102;&#111;&#114;
-            &#105;&#110;&#115;&#116;&#97;&#108;&#108;&#97;&#116;&#105;&#111;&#110; (&#108;&#105;&#115;&#116; &#111;&#102; &#115;&#116;&#114;&#105;&#110;&#103;&#115;)
+list of plugin files suggested for
+            installation (list of strings)
 </dd><dt><i>parent</i></dt>
 <dd>
-&#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#112;&#97;&#114;&#101;&#110;&#116; w&#105;&#100;&#103;&#101;&#116; (&#81;&#87;&#105;&#100;&#103;&#101;&#116;)
+reference to the parent widget (QWidget)
 </dd>
 </dl><a NAME="PluginInstallDialog.restartNeeded" ID="PluginInstallDialog.restartNeeded"></a>
 <h4>PluginInstallDialog.restartNeeded</h4>
 <b>restartNeeded</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#99;&#104;&#101;&#99;&#107;, &#105;&#102; &#97; &#114;&#101;&#115;&#116;&#97;&#114;&#116; &#111;&#102; &#116;&#104;&#101; &#73;&#68;&#69; &#105;&#115; &#114;&#101;&#113;&#117;&#105;&#114;&#101;&#100;.
+        Public method to check, if a restart of the IDE is required.
 </p><dl>
 <dt>Returns:</dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#97; &#114;&#101;&#115;&#116;&#97;&#114;&#116; &#105;&#115; &#114;&#101;&#113;&#117;&#105;&#114;&#101;&#100; (&#98;&#111;&#111;&#108;&#101;&#97;&#110;)
+flag indicating a restart is required (boolean)
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>
@@ -100,7 +100,7 @@
 <a NAME="PluginInstallWidget" ID="PluginInstallWidget"></a>
 <h2>PluginInstallWidget</h2>
 <p>
-    &#67;&#108;&#97;&#115;&#115; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#80;&#108;&#117;&#103;&#105;&#110; &#105;&#110;&#115;&#116;&#97;&#108;&#108;&#97;&#116;&#105;&#111;&#110; &#100;&#105;&#97;&#108;&#111;&#103;.
+    Class implementing the Plugin installation dialog.
 </p>
 <h3>Derived from</h3>
 QWidget, Ui_PluginInstallDialog
@@ -112,172 +112,172 @@
 <table>
 <tr>
 <td><a href="#PluginInstallWidget.__init__">PluginInstallWidget</a></td>
-<td>&#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;</td>
+<td>Constructor</td>
 </tr><tr>
 <td><a href="#PluginInstallWidget.__createArchivesList">__createArchivesList</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#99;&#114;&#101;&#97;&#116;&#101; &#97; &#108;&#105;&#115;&#116; &#111;&#102; &#112;&#108;&#117;&#103;&#105;&#110; &#97;&#114;&#99;&#104;&#105;v&#101; &#110;&#97;&#109;&#101;&#115;.</td>
+<td>Private method to create a list of plugin archive names.</td>
 </tr><tr>
 <td><a href="#PluginInstallWidget.__installPlugin">__installPlugin</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#116;&#111; &#105;&#110;&#115;&#116;&#97;&#108;&#108; &#116;&#104;&#101; &#115;&#101;&#108;&#101;&#99;&#116;&#101;&#100; &#112;&#108;&#117;&#103;&#105;&#110;.</td>
+<td>Private slot to install the selected plugin.</td>
 </tr><tr>
 <td><a href="#PluginInstallWidget.__installPlugins">__installPlugins</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#105;&#110;&#115;&#116;&#97;&#108;&#108; &#116;&#104;&#101; &#115;&#101;&#108;&#101;&#99;&#116;&#101;&#100; &#112;&#108;&#117;&#103;&#105;&#110; &#97;&#114;&#99;&#104;&#105;v&#101;&#115;.</td>
+<td>Private method to install the selected plugin archives.</td>
 </tr><tr>
 <td><a href="#PluginInstallWidget.__makedirs">__makedirs</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#99;&#114;&#101;&#97;&#116;&#101; &#97; &#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;y &#97;&#110;&#100; &#97;&#108;&#108; &#105;&#110;&#116;&#101;&#114;&#109;&#101;&#100;&#105;&#97;&#116;&#101; &#111;&#110;&#101;&#115;.</td>
+<td>Private method to create a directory and all intermediate ones.</td>
 </tr><tr>
 <td><a href="#PluginInstallWidget.__rollback">__rollback</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#111;&#108;&#108;&#98;&#97;&#99;&#107; &#97; &#102;&#97;&#105;&#108;&#101;&#100; &#105;&#110;&#115;&#116;&#97;&#108;&#108;&#97;&#116;&#105;&#111;&#110;.</td>
+<td>Private method to rollback a failed installation.</td>
 </tr><tr>
 <td><a href="#PluginInstallWidget.__selectPage">__selectPage</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#115;&#104;&#111;w &#116;&#104;&#101; &#114;&#105;&#103;&#104;&#116; w&#105;z&#97;&#114;&#100; &#112;&#97;&#103;&#101;.</td>
+<td>Private method to show the right wizard page.</td>
 </tr><tr>
 <td><a href="#PluginInstallWidget.__uninstallPackage">__uninstallPackage</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#117;&#110;&#105;&#110;&#115;&#116;&#97;&#108;&#108; &#97;&#110; &#97;&#108;&#114;&#101;&#97;&#100;y &#105;&#110;&#115;&#116;&#97;&#108;&#108;&#101;&#100; &#112;&#108;&#117;&#103;&#105;&#110; &#116;&#111; &#112;&#114;&#101;&#112;&#97;&#114;&#101; &#116;&#104;&#101; &#117;&#112;&#100;&#97;&#116;&#101;.</td>
+<td>Private method to uninstall an already installed plugin to prepare the update.</td>
 </tr><tr>
 <td><a href="#PluginInstallWidget.on_addArchivesButton_clicked">on_addArchivesButton_clicked</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#116;&#111; &#115;&#101;&#108;&#101;&#99;&#116; &#112;&#108;&#117;&#103;&#105;&#110; &#90;&#73;&#80;-&#97;&#114;&#99;&#104;&#105;v&#101;&#115; v&#105;&#97; &#97; &#102;&#105;&#108;&#101; &#115;&#101;&#108;&#101;&#99;&#116;&#105;&#111;&#110; &#100;&#105;&#97;&#108;&#111;&#103;.</td>
+<td>Private slot to select plugin ZIP-archives via a file selection dialog.</td>
 </tr><tr>
 <td><a href="#PluginInstallWidget.on_archivesList_itemSelectionChanged">on_archivesList_itemSelectionChanged</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#99;&#97;&#108;&#108;&#101;&#100;, w&#104;&#101;&#110; &#116;&#104;&#101; &#115;&#101;&#108;&#101;&#99;&#116;&#105;&#111;&#110; &#111;&#102; &#116;&#104;&#101; &#97;&#114;&#99;&#104;&#105;v&#101;&#115; &#108;&#105;&#115;&#116; &#99;&#104;&#97;&#110;&#103;&#101;&#115;.</td>
+<td>Private slot called, when the selection of the archives list changes.</td>
 </tr><tr>
 <td><a href="#PluginInstallWidget.on_buttonBox_clicked">on_buttonBox_clicked</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#116;&#111; &#104;&#97;&#110;&#100;&#108;&#101; &#116;&#104;&#101; &#99;&#108;&#105;&#99;&#107; &#111;&#102; &#97; &#98;&#117;&#116;&#116;&#111;&#110; &#111;&#102; &#116;&#104;&#101; &#98;&#117;&#116;&#116;&#111;&#110; &#98;&#111;x.</td>
+<td>Private slot to handle the click of a button of the button box.</td>
 </tr><tr>
 <td><a href="#PluginInstallWidget.on_removeArchivesButton_clicked">on_removeArchivesButton_clicked</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#116;&#111; &#114;&#101;&#109;&#111;v&#101; &#97;&#114;&#99;&#104;&#105;v&#101;&#115; &#102;&#114;&#111;&#109; &#116;&#104;&#101; &#108;&#105;&#115;&#116;.</td>
+<td>Private slot to remove archives from the list.</td>
 </tr><tr>
 <td><a href="#PluginInstallWidget.restartNeeded">restartNeeded</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#99;&#104;&#101;&#99;&#107;, &#105;&#102; &#97; &#114;&#101;&#115;&#116;&#97;&#114;&#116; &#111;&#102; &#116;&#104;&#101; &#73;&#68;&#69; &#105;&#115; &#114;&#101;&#113;&#117;&#105;&#114;&#101;&#100;.</td>
+<td>Public method to check, if a restart of the IDE is required.</td>
 </tr>
 </table>
 <a NAME="PluginInstallWidget.__init__" ID="PluginInstallWidget.__init__"></a>
 <h4>PluginInstallWidget (Constructor)</h4>
 <b>PluginInstallWidget</b>(<i>pluginManager, pluginFileNames, parent = None</i>)
 <p>
-        &#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;
+        Constructor
 </p><dl>
 <dt><i>pluginManager</i></dt>
 <dd>
-&#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#112;&#108;&#117;&#103;&#105;&#110; &#109;&#97;&#110;&#97;&#103;&#101;&#114; &#111;&#98;&#106;&#101;&#99;&#116;
+reference to the plugin manager object
 </dd><dt><i>pluginFileNames</i></dt>
 <dd>
-&#108;&#105;&#115;&#116; &#111;&#102; &#112;&#108;&#117;&#103;&#105;&#110; &#102;&#105;&#108;&#101;&#115; &#115;&#117;&#103;&#103;&#101;&#115;&#116;&#101;&#100; &#102;&#111;&#114;
-            &#105;&#110;&#115;&#116;&#97;&#108;&#108;&#97;&#116;&#105;&#111;&#110; (&#108;&#105;&#115;&#116; &#111;&#102; &#115;&#116;&#114;&#105;&#110;&#103;&#115;)
+list of plugin files suggested for
+            installation (list of strings)
 </dd><dt><i>parent</i></dt>
 <dd>
-&#112;&#97;&#114;&#101;&#110;&#116; &#111;&#102; &#116;&#104;&#105;&#115; &#100;&#105;&#97;&#108;&#111;&#103; (&#81;&#87;&#105;&#100;&#103;&#101;&#116;)
+parent of this dialog (QWidget)
 </dd>
 </dl><a NAME="PluginInstallWidget.__createArchivesList" ID="PluginInstallWidget.__createArchivesList"></a>
 <h4>PluginInstallWidget.__createArchivesList</h4>
 <b>__createArchivesList</b>(<i></i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#99;&#114;&#101;&#97;&#116;&#101; &#97; &#108;&#105;&#115;&#116; &#111;&#102; &#112;&#108;&#117;&#103;&#105;&#110; &#97;&#114;&#99;&#104;&#105;v&#101; &#110;&#97;&#109;&#101;&#115;.
+        Private method to create a list of plugin archive names.
 </p><dl>
 <dt>Returns:</dt>
 <dd>
-&#108;&#105;&#115;&#116; &#111;&#102; &#112;&#108;&#117;&#103;&#105;&#110; &#97;&#114;&#99;&#104;&#105;v&#101; &#110;&#97;&#109;&#101;&#115; (&#108;&#105;&#115;&#116; &#111;&#102; &#115;&#116;&#114;&#105;&#110;&#103;&#115;)
+list of plugin archive names (list of strings)
 </dd>
 </dl><a NAME="PluginInstallWidget.__installPlugin" ID="PluginInstallWidget.__installPlugin"></a>
 <h4>PluginInstallWidget.__installPlugin</h4>
 <b>__installPlugin</b>(<i>archiveFilename</i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#116;&#111; &#105;&#110;&#115;&#116;&#97;&#108;&#108; &#116;&#104;&#101; &#115;&#101;&#108;&#101;&#99;&#116;&#101;&#100; &#112;&#108;&#117;&#103;&#105;&#110;.
+        Private slot to install the selected plugin.
 </p><dl>
 <dt><i>archiveFilename</i></dt>
 <dd>
-&#110;&#97;&#109;&#101; &#111;&#102; &#116;&#104;&#101; &#112;&#108;&#117;&#103;&#105;&#110; &#97;&#114;&#99;&#104;&#105;v&#101;
-            &#102;&#105;&#108;&#101; (&#115;&#116;&#114;&#105;&#110;&#103;)
+name of the plugin archive
+            file (string)
 </dd>
 </dl><dl>
 <dt>Returns:</dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#115;&#117;&#99;&#99;&#101;&#115;&#115; (&#98;&#111;&#111;&#108;&#101;&#97;&#110;), &#101;&#114;&#114;&#111;&#114; &#109;&#101;&#115;&#115;&#97;&#103;&#101;
-            &#117;&#112;&#111;&#110; &#102;&#97;&#105;&#108;&#117;&#114;&#101; (&#115;&#116;&#114;&#105;&#110;&#103;) &#97;&#110;&#100; &#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#97; &#114;&#101;&#115;&#116;&#97;&#114;&#116;
-            &#111;&#102; &#116;&#104;&#101; &#73;&#68;&#69; &#105;&#115; &#114;&#101;&#113;&#117;&#105;&#114;&#101;&#100; (&#98;&#111;&#111;&#108;&#101;&#97;&#110;)
+flag indicating success (boolean), error message
+            upon failure (string) and flag indicating a restart
+            of the IDE is required (boolean)
 </dd>
 </dl><a NAME="PluginInstallWidget.__installPlugins" ID="PluginInstallWidget.__installPlugins"></a>
 <h4>PluginInstallWidget.__installPlugins</h4>
 <b>__installPlugins</b>(<i></i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#105;&#110;&#115;&#116;&#97;&#108;&#108; &#116;&#104;&#101; &#115;&#101;&#108;&#101;&#99;&#116;&#101;&#100; &#112;&#108;&#117;&#103;&#105;&#110; &#97;&#114;&#99;&#104;&#105;v&#101;&#115;.
+        Private method to install the selected plugin archives.
 </p><dl>
 <dt>Returns:</dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#115;&#117;&#99;&#99;&#101;&#115;&#115; (&#98;&#111;&#111;&#108;&#101;&#97;&#110;)
+flag indicating success (boolean)
 </dd>
 </dl><a NAME="PluginInstallWidget.__makedirs" ID="PluginInstallWidget.__makedirs"></a>
 <h4>PluginInstallWidget.__makedirs</h4>
 <b>__makedirs</b>(<i>name, mode = 0o777</i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#99;&#114;&#101;&#97;&#116;&#101; &#97; &#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;y &#97;&#110;&#100; &#97;&#108;&#108; &#105;&#110;&#116;&#101;&#114;&#109;&#101;&#100;&#105;&#97;&#116;&#101; &#111;&#110;&#101;&#115;.
+        Private method to create a directory and all intermediate ones.
 </p><p>
-        &#84;&#104;&#105;&#115; &#105;&#115; &#97;&#110; &#101;x&#116;&#101;&#110;&#100;&#101;&#100; v&#101;&#114;&#115;&#105;&#111;&#110; &#111;&#102; &#116;&#104;&#101; &#80;y&#116;&#104;&#111;&#110; &#111;&#110;&#101; &#105;&#110; &#111;&#114;&#100;&#101;&#114; &#116;&#111;
-        &#114;&#101;&#99;&#111;&#114;&#100; &#116;&#104;&#101; &#99;&#114;&#101;&#97;&#116;&#101;&#100; &#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;&#105;&#101;&#115;.
+        This is an extended version of the Python one in order to
+        record the created directories.
 </p><dl>
 <dt><i>name</i></dt>
 <dd>
-&#110;&#97;&#109;&#101; &#111;&#102; &#116;&#104;&#101; &#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;y &#116;&#111; &#99;&#114;&#101;&#97;&#116;&#101; (&#115;&#116;&#114;&#105;&#110;&#103;)
+name of the directory to create (string)
 </dd><dt><i>mode</i></dt>
 <dd>
-&#112;&#101;&#114;&#109;&#105;&#115;&#115;&#105;&#111;&#110; &#116;&#111; &#115;&#101;&#116; &#102;&#111;&#114; &#116;&#104;&#101; &#110;&#101;w &#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;y (&#105;&#110;&#116;&#101;&#103;&#101;&#114;)
+permission to set for the new directory (integer)
 </dd>
 </dl><a NAME="PluginInstallWidget.__rollback" ID="PluginInstallWidget.__rollback"></a>
 <h4>PluginInstallWidget.__rollback</h4>
 <b>__rollback</b>(<i></i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#111;&#108;&#108;&#98;&#97;&#99;&#107; &#97; &#102;&#97;&#105;&#108;&#101;&#100; &#105;&#110;&#115;&#116;&#97;&#108;&#108;&#97;&#116;&#105;&#111;&#110;.
+        Private method to rollback a failed installation.
 </p><a NAME="PluginInstallWidget.__selectPage" ID="PluginInstallWidget.__selectPage"></a>
 <h4>PluginInstallWidget.__selectPage</h4>
 <b>__selectPage</b>(<i></i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#115;&#104;&#111;w &#116;&#104;&#101; &#114;&#105;&#103;&#104;&#116; w&#105;z&#97;&#114;&#100; &#112;&#97;&#103;&#101;.
+        Private method to show the right wizard page.
 </p><a NAME="PluginInstallWidget.__uninstallPackage" ID="PluginInstallWidget.__uninstallPackage"></a>
 <h4>PluginInstallWidget.__uninstallPackage</h4>
 <b>__uninstallPackage</b>(<i>destination, pluginFileName, packageName</i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#117;&#110;&#105;&#110;&#115;&#116;&#97;&#108;&#108; &#97;&#110; &#97;&#108;&#114;&#101;&#97;&#100;y &#105;&#110;&#115;&#116;&#97;&#108;&#108;&#101;&#100; &#112;&#108;&#117;&#103;&#105;&#110; &#116;&#111; &#112;&#114;&#101;&#112;&#97;&#114;&#101;
-        &#116;&#104;&#101; &#117;&#112;&#100;&#97;&#116;&#101;.
+        Private method to uninstall an already installed plugin to prepare
+        the update.
 </p><dl>
 <dt><i>destination</i></dt>
 <dd>
-&#110;&#97;&#109;&#101; &#111;&#102; &#116;&#104;&#101; &#112;&#108;&#117;&#103;&#105;&#110; &#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;y (&#115;&#116;&#114;&#105;&#110;&#103;)
+name of the plugin directory (string)
 </dd><dt><i>pluginFileName</i></dt>
 <dd>
-&#110;&#97;&#109;&#101; &#111;&#102; &#116;&#104;&#101; &#112;&#108;&#117;&#103;&#105;&#110; &#102;&#105;&#108;&#101; (&#115;&#116;&#114;&#105;&#110;&#103;)
+name of the plugin file (string)
 </dd><dt><i>packageName</i></dt>
 <dd>
-&#110;&#97;&#109;&#101; &#111;&#102; &#116;&#104;&#101; &#112;&#108;&#117;&#103;&#105;&#110; &#112;&#97;&#99;&#107;&#97;&#103;&#101; (&#115;&#116;&#114;&#105;&#110;&#103;)
+name of the plugin package (string)
 </dd>
 </dl><a NAME="PluginInstallWidget.on_addArchivesButton_clicked" ID="PluginInstallWidget.on_addArchivesButton_clicked"></a>
 <h4>PluginInstallWidget.on_addArchivesButton_clicked</h4>
 <b>on_addArchivesButton_clicked</b>(<i></i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#116;&#111; &#115;&#101;&#108;&#101;&#99;&#116; &#112;&#108;&#117;&#103;&#105;&#110; &#90;&#73;&#80;-&#97;&#114;&#99;&#104;&#105;v&#101;&#115; v&#105;&#97; &#97; &#102;&#105;&#108;&#101; &#115;&#101;&#108;&#101;&#99;&#116;&#105;&#111;&#110; &#100;&#105;&#97;&#108;&#111;&#103;.
+        Private slot to select plugin ZIP-archives via a file selection dialog.
 </p><a NAME="PluginInstallWidget.on_archivesList_itemSelectionChanged" ID="PluginInstallWidget.on_archivesList_itemSelectionChanged"></a>
 <h4>PluginInstallWidget.on_archivesList_itemSelectionChanged</h4>
 <b>on_archivesList_itemSelectionChanged</b>(<i></i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#99;&#97;&#108;&#108;&#101;&#100;, w&#104;&#101;&#110; &#116;&#104;&#101; &#115;&#101;&#108;&#101;&#99;&#116;&#105;&#111;&#110; &#111;&#102; &#116;&#104;&#101; &#97;&#114;&#99;&#104;&#105;v&#101;&#115; &#108;&#105;&#115;&#116; &#99;&#104;&#97;&#110;&#103;&#101;&#115;.
+        Private slot called, when the selection of the archives list changes.
 </p><a NAME="PluginInstallWidget.on_buttonBox_clicked" ID="PluginInstallWidget.on_buttonBox_clicked"></a>
 <h4>PluginInstallWidget.on_buttonBox_clicked</h4>
 <b>on_buttonBox_clicked</b>(<i>button</i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#116;&#111; &#104;&#97;&#110;&#100;&#108;&#101; &#116;&#104;&#101; &#99;&#108;&#105;&#99;&#107; &#111;&#102; &#97; &#98;&#117;&#116;&#116;&#111;&#110; &#111;&#102; &#116;&#104;&#101; &#98;&#117;&#116;&#116;&#111;&#110; &#98;&#111;x.
+        Private slot to handle the click of a button of the button box.
 </p><a NAME="PluginInstallWidget.on_removeArchivesButton_clicked" ID="PluginInstallWidget.on_removeArchivesButton_clicked"></a>
 <h4>PluginInstallWidget.on_removeArchivesButton_clicked</h4>
 <b>on_removeArchivesButton_clicked</b>(<i></i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#116;&#111; &#114;&#101;&#109;&#111;v&#101; &#97;&#114;&#99;&#104;&#105;v&#101;&#115; &#102;&#114;&#111;&#109; &#116;&#104;&#101; &#108;&#105;&#115;&#116;.
+        Private slot to remove archives from the list.
 </p><a NAME="PluginInstallWidget.restartNeeded" ID="PluginInstallWidget.restartNeeded"></a>
 <h4>PluginInstallWidget.restartNeeded</h4>
 <b>restartNeeded</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#99;&#104;&#101;&#99;&#107;, &#105;&#102; &#97; &#114;&#101;&#115;&#116;&#97;&#114;&#116; &#111;&#102; &#116;&#104;&#101; &#73;&#68;&#69; &#105;&#115; &#114;&#101;&#113;&#117;&#105;&#114;&#101;&#100;.
+        Public method to check, if a restart of the IDE is required.
 </p><dl>
 <dt>Returns:</dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#97; &#114;&#101;&#115;&#116;&#97;&#114;&#116; &#105;&#115; &#114;&#101;&#113;&#117;&#105;&#114;&#101;&#100; (&#98;&#111;&#111;&#108;&#101;&#97;&#110;)
+flag indicating a restart is required (boolean)
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>
@@ -285,7 +285,7 @@
 <a NAME="PluginInstallWindow" ID="PluginInstallWindow"></a>
 <h2>PluginInstallWindow</h2>
 <p>
-    &#77;&#97;&#105;&#110; w&#105;&#110;&#100;&#111;w &#99;&#108;&#97;&#115;&#115; &#102;&#111;&#114; &#116;&#104;&#101; &#115;&#116;&#97;&#110;&#100;&#97;&#108;&#111;&#110;&#101; &#100;&#105;&#97;&#108;&#111;&#103;.
+    Main window class for the standalone dialog.
 </p>
 <h3>Derived from</h3>
 QMainWindow
@@ -297,22 +297,22 @@
 <table>
 <tr>
 <td><a href="#PluginInstallWindow.__init__">PluginInstallWindow</a></td>
-<td>&#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;</td>
+<td>Constructor</td>
 </tr>
 </table>
 <a NAME="PluginInstallWindow.__init__" ID="PluginInstallWindow.__init__"></a>
 <h4>PluginInstallWindow (Constructor)</h4>
 <b>PluginInstallWindow</b>(<i>pluginFileNames, parent = None</i>)
 <p>
-        &#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;
+        Constructor
 </p><dl>
 <dt><i>pluginFileNames</i></dt>
 <dd>
-&#108;&#105;&#115;&#116; &#111;&#102; &#112;&#108;&#117;&#103;&#105;&#110; &#102;&#105;&#108;&#101;&#115; &#115;&#117;&#103;&#103;&#101;&#115;&#116;&#101;&#100; &#102;&#111;&#114;
-            &#105;&#110;&#115;&#116;&#97;&#108;&#108;&#97;&#116;&#105;&#111;&#110; (&#108;&#105;&#115;&#116; &#111;&#102; &#115;&#116;&#114;&#105;&#110;&#103;&#115;)
+list of plugin files suggested for
+            installation (list of strings)
 </dd><dt><i>parent</i></dt>
 <dd>
-&#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#112;&#97;&#114;&#101;&#110;&#116; w&#105;&#100;&#103;&#101;&#116; (&#81;&#87;&#105;&#100;&#103;&#101;&#116;)
+reference to the parent widget (QWidget)
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>