--- a/Documentation/Source/eric5.Project.AddDirectoryDialog.html	Thu Jan 14 17:27:31 2010 +0000
+++ b/Documentation/Source/eric5.Project.AddDirectoryDialog.html	Thu Jan 14 18:35:52 2010 +0000
@@ -22,7 +22,7 @@
 <body><a NAME="top" ID="top"></a>
 <h1>eric5.Project.AddDirectoryDialog</h1>
 <p>
-&#77;&#111;&#100;&#117;&#108;&#101; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#97; &#100;&#105;&#97;&#108;&#111;&#103; &#116;&#111; &#97;&#100;&#100; &#102;&#105;&#108;&#101;&#115; &#111;&#102; &#97; &#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;y &#116;&#111; &#116;&#104;&#101; &#112;&#114;&#111;&#106;&#101;&#99;&#116;.
+Module implementing a dialog to add files of a directory to the project.
 </p>
 <h3>Global Attributes</h3>
 <table>
@@ -32,7 +32,7 @@
 <table>
 <tr>
 <td><a href="#AddDirectoryDialog">AddDirectoryDialog</a></td>
-<td>&#67;&#108;&#97;&#115;&#115; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#97; &#100;&#105;&#97;&#108;&#111;&#103; &#116;&#111; &#97;&#100;&#100; &#102;&#105;&#108;&#101;&#115; &#111;&#102; &#97; &#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;y &#116;&#111; &#116;&#104;&#101; &#112;&#114;&#111;&#106;&#101;&#99;&#116;.</td>
+<td>Class implementing a dialog to add files of a directory to the project.</td>
 </tr>
 </table>
 <h3>Functions</h3>
@@ -43,7 +43,7 @@
 <a NAME="AddDirectoryDialog" ID="AddDirectoryDialog"></a>
 <h2>AddDirectoryDialog</h2>
 <p>
-    &#67;&#108;&#97;&#115;&#115; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#97; &#100;&#105;&#97;&#108;&#111;&#103; &#116;&#111; &#97;&#100;&#100; &#102;&#105;&#108;&#101;&#115; &#111;&#102; &#97; &#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;y &#116;&#111; &#116;&#104;&#101; &#112;&#114;&#111;&#106;&#101;&#99;&#116;.
+    Class implementing a dialog to add files of a directory to the project.
 </p>
 <h3>Derived from</h3>
 QDialog, Ui_AddDirectoryDialog
@@ -55,107 +55,107 @@
 <table>
 <tr>
 <td><a href="#AddDirectoryDialog.__init__">AddDirectoryDialog</a></td>
-<td>&#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;</td>
+<td>Constructor</td>
 </tr><tr>
 <td><a href="#AddDirectoryDialog.__dirDialog">__dirDialog</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#116;&#111; &#100;&#105;&#115;&#112;&#108;&#97;y &#97; &#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;y &#115;&#101;&#108;&#101;&#99;&#116;&#105;&#111;&#110; &#100;&#105;&#97;&#108;&#111;&#103;.</td>
+<td>Private slot to display a directory selection dialog.</td>
 </tr><tr>
 <td><a href="#AddDirectoryDialog.getData">getData</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#115;&#108;&#111;&#116; &#116;&#111; &#114;&#101;&#116;&#114;&#105;&#101;v&#101; &#116;&#104;&#101; &#100;&#105;&#97;&#108;&#111;&#103;&#115; &#100;&#97;&#116;&#97;.</td>
+<td>Public slot to retrieve the dialogs data.</td>
 </tr><tr>
 <td><a href="#AddDirectoryDialog.on_filterComboBox_highlighted">on_filterComboBox_highlighted</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; &#115;&#101;&#108;&#101;&#99;&#116;&#105;&#111;&#110; &#111;&#102; &#97; &#102;&#105;&#108;&#101; &#116;y&#112;&#101;.</td>
+<td>Private slot to handle the selection of a file type.</td>
 </tr><tr>
 <td><a href="#AddDirectoryDialog.on_sourceDirButton_clicked">on_sourceDirButton_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; &#115;&#111;&#117;&#114;&#99;&#101; &#100;&#105;&#114; &#98;&#117;&#116;&#116;&#111;&#110; &#112;&#114;&#101;&#115;&#115;.</td>
+<td>Private slot to handle the source dir button press.</td>
 </tr><tr>
 <td><a href="#AddDirectoryDialog.on_sourceDirEdit_textChanged">on_sourceDirEdit_textChanged</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; &#115;&#111;&#117;&#114;&#99;&#101; &#100;&#105;&#114; &#116;&#101;x&#116; &#99;&#104;&#97;&#110;&#103;&#101;&#100;.</td>
+<td>Private slot to handle the source dir text changed.</td>
 </tr><tr>
 <td><a href="#AddDirectoryDialog.on_targetDirButton_clicked">on_targetDirButton_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; &#116;&#97;&#114;&#103;&#101;&#116; &#100;&#105;&#114; &#98;&#117;&#116;&#116;&#111;&#110; &#112;&#114;&#101;&#115;&#115;.</td>
+<td>Private slot to handle the target dir button press.</td>
 </tr>
 </table>
 <a NAME="AddDirectoryDialog.__init__" ID="AddDirectoryDialog.__init__"></a>
 <h4>AddDirectoryDialog (Constructor)</h4>
 <b>AddDirectoryDialog</b>(<i>pro, filter = 'source', parent = None, name = None, startdir = None</i>)
 <p>
-        &#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;
+        Constructor
 </p><dl>
 <dt><i>pro</i></dt>
 <dd>
-&#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#112;&#114;&#111;&#106;&#101;&#99;&#116; &#111;&#98;&#106;&#101;&#99;&#116;
+reference to the project object
 </dd><dt><i>filter</i></dt>
 <dd>
-&#102;&#105;&#108;&#101; &#116;y&#112;&#101; &#102;&#105;&#108;&#116;&#101;&#114; (&#115;&#116;&#114;&#105;&#110;&#103;)
+file type filter (string)
 </dd><dt><i>parent</i></dt>
 <dd>
-&#112;&#97;&#114;&#101;&#110;&#116; w&#105;&#100;&#103;&#101;&#116; &#111;&#102; &#116;&#104;&#105;&#115; &#100;&#105;&#97;&#108;&#111;&#103; (&#81;&#87;&#105;&#100;&#103;&#101;&#116;)
+parent widget of this dialog (QWidget)
 </dd><dt><i>name</i></dt>
 <dd>
-&#110;&#97;&#109;&#101; &#111;&#102; &#116;&#104;&#105;&#115; &#100;&#105;&#97;&#108;&#111;&#103; (&#115;&#116;&#114;&#105;&#110;&#103;)
+name of this dialog (string)
 </dd><dt><i>startdir</i></dt>
 <dd>
-&#115;&#116;&#97;&#114;&#116; &#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;y &#102;&#111;&#114; &#116;&#104;&#101; &#115;&#101;&#108;&#101;&#99;&#116;&#105;&#111;&#110; &#100;&#105;&#97;&#108;&#111;&#103;
+start directory for the selection dialog
 </dd>
 </dl><a NAME="AddDirectoryDialog.__dirDialog" ID="AddDirectoryDialog.__dirDialog"></a>
 <h4>AddDirectoryDialog.__dirDialog</h4>
 <b>__dirDialog</b>(<i>textEdit</i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#116;&#111; &#100;&#105;&#115;&#112;&#108;&#97;y &#97; &#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;y &#115;&#101;&#108;&#101;&#99;&#116;&#105;&#111;&#110; &#100;&#105;&#97;&#108;&#111;&#103;.
+        Private slot to display a directory selection dialog.
 </p><dl>
 <dt><i>textEdit</i></dt>
 <dd>
-&#102;&#105;&#101;&#108;&#100; &#102;&#111;&#114; &#116;&#104;&#101; &#100;&#105;&#115;&#112;&#108;&#97;y &#111;&#102; &#116;&#104;&#101; &#115;&#101;&#108;&#101;&#99;&#116;&#101;&#100; &#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;y &#110;&#97;&#109;&#101;
-                (&#81;&#76;&#105;&#110;&#101;&#69;&#100;&#105;&#116;)
+field for the display of the selected directory name
+                (QLineEdit)
 </dd>
 </dl><a NAME="AddDirectoryDialog.getData" ID="AddDirectoryDialog.getData"></a>
 <h4>AddDirectoryDialog.getData</h4>
 <b>getData</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#115;&#108;&#111;&#116; &#116;&#111; &#114;&#101;&#116;&#114;&#105;&#101;v&#101; &#116;&#104;&#101; &#100;&#105;&#97;&#108;&#111;&#103;&#115; &#100;&#97;&#116;&#97;.
+        Public slot to retrieve the dialogs data.
 </p><dl>
 <dt>Returns:</dt>
 <dd>
-&#116;&#117;&#112;&#108;&#101; &#111;&#102; &#102;&#111;&#117;&#114; v&#97;&#108;&#117;&#101;&#115; (&#115;&#116;&#114;&#105;&#110;&#103;, &#115;&#116;&#114;&#105;&#110;&#103;, &#115;&#116;&#114;&#105;&#110;&#103;, &#98;&#111;&#111;&#108;&#101;&#97;&#110;) &#103;&#105;v&#105;&#110;&#103;
-            &#116;&#104;&#101; &#115;&#101;&#108;&#101;&#99;&#116;&#101;&#100; &#102;&#105;&#108;&#101; &#116;y&#112;&#101;, &#116;&#104;&#101; &#115;&#111;&#117;&#114;&#99;&#101; &#97;&#110;&#100; &#116;&#97;&#114;&#103;&#101;&#116; &#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;y &#97;&#110;&#100;
-            &#97; &#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#97; &#114;&#101;&#99;&#117;&#114;&#115;&#105;v&#101; &#97;&#100;&#100;
+tuple of four values (string, string, string, boolean) giving
+            the selected file type, the source and target directory and
+            a flag indicating a recursive add
 </dd>
 </dl><a NAME="AddDirectoryDialog.on_filterComboBox_highlighted" ID="AddDirectoryDialog.on_filterComboBox_highlighted"></a>
 <h4>AddDirectoryDialog.on_filterComboBox_highlighted</h4>
 <b>on_filterComboBox_highlighted</b>(<i>fileType</i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#116;&#111; &#104;&#97;&#110;&#100;&#108;&#101; &#116;&#104;&#101; &#115;&#101;&#108;&#101;&#99;&#116;&#105;&#111;&#110; &#111;&#102; &#97; &#102;&#105;&#108;&#101; &#116;y&#112;&#101;.
+        Private slot to handle the selection of a file type.
 </p><dl>
 <dt><i>fileType</i></dt>
 <dd>
-&#116;&#104;&#101; &#115;&#101;&#108;&#101;&#99;&#116;&#101;&#100; &#102;&#105;&#108;&#101; &#116;y&#112;&#101; (&#115;&#116;&#114;&#105;&#110;&#103;)
+the selected file type (string)
 </dd>
 </dl><a NAME="AddDirectoryDialog.on_sourceDirButton_clicked" ID="AddDirectoryDialog.on_sourceDirButton_clicked"></a>
 <h4>AddDirectoryDialog.on_sourceDirButton_clicked</h4>
 <b>on_sourceDirButton_clicked</b>(<i></i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#116;&#111; &#104;&#97;&#110;&#100;&#108;&#101; &#116;&#104;&#101; &#115;&#111;&#117;&#114;&#99;&#101; &#100;&#105;&#114; &#98;&#117;&#116;&#116;&#111;&#110; &#112;&#114;&#101;&#115;&#115;.
+        Private slot to handle the source dir button press.
 </p><a NAME="AddDirectoryDialog.on_sourceDirEdit_textChanged" ID="AddDirectoryDialog.on_sourceDirEdit_textChanged"></a>
 <h4>AddDirectoryDialog.on_sourceDirEdit_textChanged</h4>
 <b>on_sourceDirEdit_textChanged</b>(<i>dir</i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#116;&#111; &#104;&#97;&#110;&#100;&#108;&#101; &#116;&#104;&#101; &#115;&#111;&#117;&#114;&#99;&#101; &#100;&#105;&#114; &#116;&#101;x&#116; &#99;&#104;&#97;&#110;&#103;&#101;&#100;.
+        Private slot to handle the source dir text changed.
 </p><p>
-        &#73;&#102; &#116;&#104;&#101; &#101;&#110;&#116;&#101;&#114;&#101;&#100; &#115;&#111;&#117;&#114;&#99;&#101; &#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;y &#105;&#115; &#97; &#115;&#117;&#98;&#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;y &#111;&#102; &#116;&#104;&#101; &#99;&#117;&#114;&#114;&#101;&#110;&#116;
-        &#112;&#114;&#111;&#106;&#101;&#99;&#116;&#115; &#109;&#97;&#105;&#110; &#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;y, &#116;&#104;&#101; &#116;&#97;&#114;&#103;&#101;&#116; &#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;y &#112;&#97;&#116;&#104; &#105;&#115; &#115;y&#110;&#99;&#104;&#114;&#111;&#110;&#105;z&#101;&#100;.
-        &#73;&#116; &#105;&#115; &#97;&#115;&#115;&#117;&#109;&#101;&#100;, &#116;&#104;&#97;&#116; &#116;&#104;&#101; &#117;&#115;&#101;&#114; w&#97;&#110;&#116;&#115; &#116;&#111; &#97;&#100;&#100; &#97; &#98;&#117;&#110;&#99;&#104; &#111;&#102; &#102;&#105;&#108;&#101;&#115; &#116;&#111;
-        &#116;&#104;&#101; &#112;&#114;&#111;&#106;&#101;&#99;&#116; &#105;&#110; &#112;&#108;&#97;&#99;&#101;.
+        If the entered source directory is a subdirectory of the current
+        projects main directory, the target directory path is synchronized.
+        It is assumed, that the user wants to add a bunch of files to
+        the project in place.
 </p><dl>
 <dt><i>dir</i></dt>
 <dd>
-&#116;&#104;&#101; &#116;&#101;x&#116; &#111;&#102; &#116;&#104;&#101; &#115;&#111;&#117;&#114;&#99;&#101; &#100;&#105;&#114;&#101;&#99;&#116;&#111;&#114;y &#108;&#105;&#110;&#101; &#101;&#100;&#105;&#116; (&#115;&#116;&#114;&#105;&#110;&#103;)
+the text of the source directory line edit (string)
 </dd>
 </dl><a NAME="AddDirectoryDialog.on_targetDirButton_clicked" ID="AddDirectoryDialog.on_targetDirButton_clicked"></a>
 <h4>AddDirectoryDialog.on_targetDirButton_clicked</h4>
 <b>on_targetDirButton_clicked</b>(<i></i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#116;&#111; &#104;&#97;&#110;&#100;&#108;&#101; &#116;&#104;&#101; &#116;&#97;&#114;&#103;&#101;&#116; &#100;&#105;&#114; &#98;&#117;&#116;&#116;&#111;&#110; &#112;&#114;&#101;&#115;&#115;.
+        Private slot to handle the target dir button press.
 </p>
 <div align="right"><a href="#top">Up</a></div>
 <hr />