Documentation/Source/eric5.Helpviewer.History.HistoryManager.html

changeset 58
37f0444c3479
parent 21
b88a0e6268bd
child 409
0ea528e80202
diff -r 81326a94fdca -r 37f0444c3479 Documentation/Source/eric5.Helpviewer.History.HistoryManager.html
--- a/Documentation/Source/eric5.Helpviewer.History.HistoryManager.html	Thu Jan 14 17:27:31 2010 +0000
+++ b/Documentation/Source/eric5.Helpviewer.History.HistoryManager.html	Thu Jan 14 18:35:52 2010 +0000
@@ -22,7 +22,7 @@
 <body><a NAME="top" ID="top"></a>
 <h1>eric5.Helpviewer.History.HistoryManager</h1>
 <p>
-&#77;&#111;&#100;&#117;&#108;&#101; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#109;&#97;&#110;&#97;&#103;&#101;&#114;.
+Module implementing the history manager.
 </p>
 <h3>Global Attributes</h3>
 <table>
@@ -32,10 +32,10 @@
 <table>
 <tr>
 <td><a href="#HistoryEntry">HistoryEntry</a></td>
-<td>&#67;&#108;&#97;&#115;&#115; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#97; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;y.</td>
+<td>Class implementing a history entry.</td>
 </tr><tr>
 <td><a href="#HistoryManager">HistoryManager</a></td>
-<td>&#67;&#108;&#97;&#115;&#115; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#109;&#97;&#110;&#97;&#103;&#101;&#114;.</td>
+<td>Class implementing the history manager.</td>
 </tr>
 </table>
 <h3>Functions</h3>
@@ -46,7 +46,7 @@
 <a NAME="HistoryEntry" ID="HistoryEntry"></a>
 <h2>HistoryEntry</h2>
 <p>
-    &#67;&#108;&#97;&#115;&#115; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#97; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;y.
+    Class implementing a history entry.
 </p>
 <h3>Derived from</h3>
 object
@@ -58,75 +58,75 @@
 <table>
 <tr>
 <td><a href="#HistoryEntry.__init__">HistoryEntry</a></td>
-<td>&#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;</td>
+<td>Constructor</td>
 </tr><tr>
 <td><a href="#HistoryEntry.__eq__">__eq__</a></td>
-<td>&#83;&#112;&#101;&#99;&#105;&#97;&#108; &#109;&#101;&#116;&#104;&#111;&#100; &#100;&#101;&#116;&#101;&#114;&#109;&#105;&#110;&#105;&#110;&#103; &#101;&#113;&#117;&#97;&#108;&#105;&#116;y.</td>
+<td>Special method determining equality.</td>
 </tr><tr>
 <td><a href="#HistoryEntry.__lt__">__lt__</a></td>
-<td>&#83;&#112;&#101;&#99;&#105;&#97;&#108; &#109;&#101;&#116;&#104;&#111;&#100; &#100;&#101;&#116;&#101;&#114;&#109;&#105;&#110;&#105;&#110;&#103; &#108;&#101;&#115;&#115; &#114;&#101;&#108;&#97;&#116;&#105;&#111;&#110;.</td>
+<td>Special method determining less relation.</td>
 </tr><tr>
 <td><a href="#HistoryEntry.userTitle">userTitle</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#116; &#116;&#104;&#101; &#116;&#105;&#116;&#108;&#101; &#111;&#102; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;y.</td>
+<td>Public method to get the title of the history entry.</td>
 </tr>
 </table>
 <a NAME="HistoryEntry.__init__" ID="HistoryEntry.__init__"></a>
 <h4>HistoryEntry (Constructor)</h4>
 <b>HistoryEntry</b>(<i>url = None, dateTime = None, title = None</i>)
 <p>
-        &#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;
+        Constructor
 </p><dl>
 <dt><i>url</i></dt>
 <dd>
-&#85;&#82;&#76; &#111;&#102; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;y (&#115;&#116;&#114;&#105;&#110;&#103;)
+URL of the history entry (string)
 </dd><dt><i>dateTime</i></dt>
 <dd>
-&#100;&#97;&#116;&#101; &#97;&#110;&#100; &#116;&#105;&#109;&#101; &#116;&#104;&#105;&#115; &#101;&#110;&#116;&#114;y w&#97;&#115; &#99;&#114;&#101;&#97;&#116;&#101;&#100; (&#81;&#68;&#97;&#116;&#101;&#84;&#105;&#109;&#101;)
+date and time this entry was created (QDateTime)
 </dd><dt><i>title</i></dt>
 <dd>
-&#116;&#105;&#116;&#108;&#101; &#115;&#116;&#114;&#105;&#110;&#103; &#102;&#111;&#114; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;y (&#115;&#116;&#114;&#105;&#110;&#103;)
+title string for the history entry (string)
 </dd>
 </dl><a NAME="HistoryEntry.__eq__" ID="HistoryEntry.__eq__"></a>
 <h4>HistoryEntry.__eq__</h4>
 <b>__eq__</b>(<i>other</i>)
 <p>
-        &#83;&#112;&#101;&#99;&#105;&#97;&#108; &#109;&#101;&#116;&#104;&#111;&#100; &#100;&#101;&#116;&#101;&#114;&#109;&#105;&#110;&#105;&#110;&#103; &#101;&#113;&#117;&#97;&#108;&#105;&#116;y.
+        Special method determining equality.
 </p><dl>
 <dt><i>other</i></dt>
 <dd>
-&#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;y &#116;&#111; &#99;&#111;&#109;&#112;&#97;&#114;&#101; &#97;&#103;&#97;&#105;&#110;&#115;&#116; (&#72;&#105;&#115;&#116;&#111;&#114;y&#69;&#110;&#116;&#114;y)
+reference to the history entry to compare against (HistoryEntry)
 </dd>
 </dl><dl>
 <dt>Returns:</dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#101;&#113;&#117;&#97;&#108;&#105;&#116;y (&#98;&#111;&#111;&#108;&#101;&#97;&#110;)
+flag indicating equality (boolean)
 </dd>
 </dl><a NAME="HistoryEntry.__lt__" ID="HistoryEntry.__lt__"></a>
 <h4>HistoryEntry.__lt__</h4>
 <b>__lt__</b>(<i>other</i>)
 <p>
-        &#83;&#112;&#101;&#99;&#105;&#97;&#108; &#109;&#101;&#116;&#104;&#111;&#100; &#100;&#101;&#116;&#101;&#114;&#109;&#105;&#110;&#105;&#110;&#103; &#108;&#101;&#115;&#115; &#114;&#101;&#108;&#97;&#116;&#105;&#111;&#110;.
+        Special method determining less relation.
 </p><p>
-        &#78;&#111;&#116;&#101;&#58; &#72;&#105;&#115;&#116;&#111;&#114;y &#105;&#115; &#115;&#111;&#114;&#116;&#101;&#100; &#105;&#110; &#114;&#101;v&#101;&#114;&#115;&#101; &#111;&#114;&#100;&#101;&#114; &#98;y &#100;&#97;&#116;&#101; &#97;&#110;&#100; &#116;&#105;&#109;&#101;
+        Note: History is sorted in reverse order by date and time
 </p><dl>
 <dt><i>other</i></dt>
 <dd>
-&#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;y &#116;&#111; &#99;&#111;&#109;&#112;&#97;&#114;&#101; &#97;&#103;&#97;&#105;&#110;&#115;&#116; (&#72;&#105;&#115;&#116;&#111;&#114;y&#69;&#110;&#116;&#114;y)
+reference to the history entry to compare against (HistoryEntry)
 </dd>
 </dl><dl>
 <dt>Returns:</dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#108;&#101;&#115;&#115; (&#98;&#111;&#111;&#108;&#101;&#97;&#110;)
+flag indicating less (boolean)
 </dd>
 </dl><a NAME="HistoryEntry.userTitle" ID="HistoryEntry.userTitle"></a>
 <h4>HistoryEntry.userTitle</h4>
 <b>userTitle</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#116; &#116;&#104;&#101; &#116;&#105;&#116;&#108;&#101; &#111;&#102; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;y.
+        Public method to get the title of the history entry.
 </p><dl>
 <dt>Returns:</dt>
 <dd>
-&#116;&#105;&#116;&#108;&#101; &#111;&#102; &#116;&#104;&#101; &#101;&#110;&#116;&#114;y (&#115;&#116;&#114;&#105;&#110;&#103;)
+title of the entry (string)
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>
@@ -134,24 +134,24 @@
 <a NAME="HistoryManager" ID="HistoryManager"></a>
 <h2>HistoryManager</h2>
 <p>
-    &#67;&#108;&#97;&#115;&#115; &#105;&#109;&#112;&#108;&#101;&#109;&#101;&#110;&#116;&#105;&#110;&#103; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#109;&#97;&#110;&#97;&#103;&#101;&#114;.
+    Class implementing the history manager.
 </p><h4>Signals</h4>
 <dl>
 <dt>entryAdded</dt>
 <dd>
-&#101;&#109;&#105;&#116;&#116;&#101;&#100; &#97;&#102;&#116;&#101;&#114; &#97; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;y &#104;&#97;&#115; &#98;&#101;&#101;&#110; &#97;&#100;&#100;&#101;&#100;
+emitted after a history entry has been added
 </dd><dt>entryRemoved</dt>
 <dd>
-&#101;&#109;&#105;&#116;&#116;&#101;&#100; &#97;&#102;&#116;&#101;&#114; &#97; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;y &#104;&#97;&#115; &#98;&#101;&#101;&#110; &#114;&#101;&#109;&#111;v&#101;&#100;
+emitted after a history entry has been removed
 </dd><dt>entryUpdated(int)</dt>
 <dd>
-&#101;&#109;&#105;&#116;&#116;&#101;&#100; &#97;&#102;&#116;&#101;&#114; &#97; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;y &#104;&#97;&#115; &#98;&#101;&#101;&#110; &#117;&#112;&#100;&#97;&#116;&#101;&#100;
+emitted after a history entry has been updated
 </dd><dt>historyCleared()</dt>
 <dd>
-&#101;&#109;&#105;&#116;&#116;&#101;&#100; &#97;&#102;&#116;&#101;&#114; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#104;&#97;&#115; &#98;&#101;&#101;&#110; &#99;&#108;&#101;&#97;&#114;&#101;&#100;
+emitted after the history has been cleared
 </dd><dt>historyReset()</dt>
 <dd>
-&#101;&#109;&#105;&#116;&#116;&#101;&#100; &#97;&#102;&#116;&#101;&#114; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#104;&#97;&#115; &#98;&#101;&#101;&#110; &#114;&#101;&#115;&#101;&#116;
+emitted after the history has been reset
 </dd>
 </dl>
 <h3>Derived from</h3>
@@ -164,266 +164,266 @@
 <table>
 <tr>
 <td><a href="#HistoryManager.__init__">HistoryManager</a></td>
-<td>&#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;</td>
+<td>Constructor</td>
 </tr><tr>
 <td><a href="#HistoryManager.__checkForExpired">__checkForExpired</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#116;&#111; &#99;&#104;&#101;&#99;&#107; &#101;&#110;&#116;&#114;&#105;&#101;&#115; &#102;&#111;&#114; &#101;x&#112;&#105;&#114;&#97;&#116;&#105;&#111;&#110;.</td>
+<td>Private slot to check entries for expiration.</td>
 </tr><tr>
 <td><a href="#HistoryManager.__load">__load</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#108;&#111;&#97;&#100; &#116;&#104;&#101; &#115;&#97;v&#101;&#100; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;&#105;&#101;&#115; &#102;&#114;&#111;&#109; &#100;&#105;&#115;&#107;.</td>
+<td>Private method to load the saved history entries from disk.</td>
 </tr><tr>
 <td><a href="#HistoryManager.__refreshFrequencies">__refreshFrequencies</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#116;&#111; &#114;&#101;&#99;&#97;&#108;&#99;&#117;&#108;&#97;&#116;&#101; &#116;&#104;&#101; &#114;&#101;&#102;&#114;&#101;&#115;&#104; &#102;&#114;&#101;&#113;&#117;&#101;&#110;&#99;&#105;&#101;&#115;.</td>
+<td>Private slot to recalculate the refresh frequencies.</td>
 </tr><tr>
 <td><a href="#HistoryManager.__startFrequencyTimer">__startFrequencyTimer</a></td>
-<td>&#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#115;&#116;&#97;&#114;&#116; &#116;&#104;&#101; &#116;&#105;&#109;&#101;&#114; &#116;&#111; &#114;&#101;&#99;&#97;&#108;&#99;&#117;&#108;&#97;&#116;&#101; &#116;&#104;&#101; &#102;&#114;&#101;&#113;&#117;&#101;&#110;&#99;&#105;&#101;&#115;.</td>
+<td>Private method to start the timer to recalculate the frequencies.</td>
 </tr><tr>
 <td><a href="#HistoryManager._addHistoryEntry">_addHistoryEntry</a></td>
-<td>&#80;&#114;&#111;&#116;&#101;&#99;&#116;&#101;&#100; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#97;&#100;&#100; &#97; &#104;&#105;&#115;&#116;&#111;&#114;y &#105;&#116;&#101;&#109;.</td>
+<td>Protected method to add a history item.</td>
 </tr><tr>
 <td><a href="#HistoryManager._removeHistoryEntry">_removeHistoryEntry</a></td>
-<td>&#80;&#114;&#111;&#116;&#101;&#99;&#116;&#101;&#100; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#101;&#109;&#111;v&#101; &#97; &#104;&#105;&#115;&#116;&#111;&#114;y &#105;&#116;&#101;&#109;.</td>
+<td>Protected method to remove a history item.</td>
 </tr><tr>
 <td><a href="#HistoryManager.addHistoryEntry">addHistoryEntry</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#97;&#100;&#100; &#97; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;y.</td>
+<td>Public method to add a history entry.</td>
 </tr><tr>
 <td><a href="#HistoryManager.clear">clear</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#115;&#108;&#111;&#116; &#116;&#111; &#99;&#108;&#101;&#97;&#114; &#116;&#104;&#101; &#99;&#111;&#109;&#112;&#108;&#101;&#116;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y.</td>
+<td>Public slot to clear the complete history.</td>
 </tr><tr>
 <td><a href="#HistoryManager.close">close</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#99;&#108;&#111;&#115;&#101; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#109;&#97;&#110;&#97;&#103;&#101;&#114;.</td>
+<td>Public method to close the history manager.</td>
 </tr><tr>
 <td><a href="#HistoryManager.daysToExpire">daysToExpire</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#116; &#116;&#104;&#101; &#100;&#97;y&#115; &#102;&#111;&#114; &#101;&#110;&#116;&#114;y &#101;x&#112;&#105;&#114;&#97;&#116;&#105;&#111;&#110;.</td>
+<td>Public method to get the days for entry expiration.</td>
 </tr><tr>
 <td><a href="#HistoryManager.history">history</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#101;&#116;&#117;&#114;&#110; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y.</td>
+<td>Public method to return the history.</td>
 </tr><tr>
 <td><a href="#HistoryManager.historyContains">historyContains</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#99;&#104;&#101;&#99;&#107; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#102;&#111;&#114; &#97;&#110; &#101;&#110;&#116;&#114;y.</td>
+<td>Public method to check the history for an entry.</td>
 </tr><tr>
 <td><a href="#HistoryManager.historyFilterModel">historyFilterModel</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#116; &#97; &#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#102;&#105;&#108;&#116;&#101;&#114; &#109;&#111;&#100;&#101;&#108;.</td>
+<td>Public method to get a reference to the history filter model.</td>
 </tr><tr>
 <td><a href="#HistoryManager.historyModel">historyModel</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#116; &#97; &#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#109;&#111;&#100;&#101;&#108;.</td>
+<td>Public method to get a reference to the history model.</td>
 </tr><tr>
 <td><a href="#HistoryManager.historyTreeModel">historyTreeModel</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#116; &#97; &#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#116;&#114;&#101;&#101; &#109;&#111;&#100;&#101;&#108;.</td>
+<td>Public method to get a reference to the history tree model.</td>
 </tr><tr>
 <td><a href="#HistoryManager.preferencesChanged">preferencesChanged</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#101; &#97; &#99;&#104;&#97;&#110;&#103;&#101; &#111;&#102; &#112;&#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101;&#115;.</td>
+<td>Public method to indicate a change of preferences.</td>
 </tr><tr>
 <td><a href="#HistoryManager.removeHistoryEntry">removeHistoryEntry</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#101;&#109;&#111;v&#101; &#97; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;y.</td>
+<td>Public method to remove a history entry.</td>
 </tr><tr>
 <td><a href="#HistoryManager.save">save</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#115;&#108;&#111;&#116; &#116;&#111; &#115;&#97;v&#101; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;&#105;&#101;&#115; &#116;&#111; &#100;&#105;&#115;&#107;.</td>
+<td>Public slot to save the history entries to disk.</td>
 </tr><tr>
 <td><a href="#HistoryManager.setDaysToExpire">setDaysToExpire</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#115;&#101;&#116; &#116;&#104;&#101; &#100;&#97;y&#115; &#102;&#111;&#114; &#101;&#110;&#116;&#114;y &#101;x&#112;&#105;&#114;&#97;&#116;&#105;&#111;&#110;.</td>
+<td>Public method to set the days for entry expiration.</td>
 </tr><tr>
 <td><a href="#HistoryManager.setHistory">setHistory</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#115;&#101;&#116; &#97; &#110;&#101;w &#104;&#105;&#115;&#116;&#111;&#114;y.</td>
+<td>Public method to set a new history.</td>
 </tr><tr>
 <td><a href="#HistoryManager.updateHistoryEntry">updateHistoryEntry</a></td>
-<td>&#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#117;&#112;&#100;&#97;&#116;&#101; &#97; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;y.</td>
+<td>Public method to update a history entry.</td>
 </tr>
 </table>
 <a NAME="HistoryManager.__init__" ID="HistoryManager.__init__"></a>
 <h4>HistoryManager (Constructor)</h4>
 <b>HistoryManager</b>(<i>parent = None</i>)
 <p>
-        &#67;&#111;&#110;&#115;&#116;&#114;&#117;&#99;&#116;&#111;&#114;
+        Constructor
 </p><dl>
 <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; &#111;&#98;&#106;&#101;&#99;&#116; (&#81;&#79;&#98;&#106;&#101;&#99;&#116;)
+reference to the parent object (QObject)
 </dd>
 </dl><a NAME="HistoryManager.__checkForExpired" ID="HistoryManager.__checkForExpired"></a>
 <h4>HistoryManager.__checkForExpired</h4>
 <b>__checkForExpired</b>(<i></i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#116;&#111; &#99;&#104;&#101;&#99;&#107; &#101;&#110;&#116;&#114;&#105;&#101;&#115; &#102;&#111;&#114; &#101;x&#112;&#105;&#114;&#97;&#116;&#105;&#111;&#110;.
+        Private slot to check entries for expiration.
 </p><a NAME="HistoryManager.__load" ID="HistoryManager.__load"></a>
 <h4>HistoryManager.__load</h4>
 <b>__load</b>(<i></i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#108;&#111;&#97;&#100; &#116;&#104;&#101; &#115;&#97;v&#101;&#100; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;&#105;&#101;&#115; &#102;&#114;&#111;&#109; &#100;&#105;&#115;&#107;.
+        Private method to load the saved history entries from disk.
 </p><a NAME="HistoryManager.__refreshFrequencies" ID="HistoryManager.__refreshFrequencies"></a>
 <h4>HistoryManager.__refreshFrequencies</h4>
 <b>__refreshFrequencies</b>(<i></i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#115;&#108;&#111;&#116; &#116;&#111; &#114;&#101;&#99;&#97;&#108;&#99;&#117;&#108;&#97;&#116;&#101; &#116;&#104;&#101; &#114;&#101;&#102;&#114;&#101;&#115;&#104; &#102;&#114;&#101;&#113;&#117;&#101;&#110;&#99;&#105;&#101;&#115;.
+        Private slot to recalculate the refresh frequencies.
 </p><a NAME="HistoryManager.__startFrequencyTimer" ID="HistoryManager.__startFrequencyTimer"></a>
 <h4>HistoryManager.__startFrequencyTimer</h4>
 <b>__startFrequencyTimer</b>(<i></i>)
 <p>
-        &#80;&#114;&#105;v&#97;&#116;&#101; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#115;&#116;&#97;&#114;&#116; &#116;&#104;&#101; &#116;&#105;&#109;&#101;&#114; &#116;&#111; &#114;&#101;&#99;&#97;&#108;&#99;&#117;&#108;&#97;&#116;&#101; &#116;&#104;&#101; &#102;&#114;&#101;&#113;&#117;&#101;&#110;&#99;&#105;&#101;&#115;.
+        Private method to start the timer to recalculate the frequencies.
 </p><a NAME="HistoryManager._addHistoryEntry" ID="HistoryManager._addHistoryEntry"></a>
 <h4>HistoryManager._addHistoryEntry</h4>
 <b>_addHistoryEntry</b>(<i>itm</i>)
 <p>
-        &#80;&#114;&#111;&#116;&#101;&#99;&#116;&#101;&#100; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#97;&#100;&#100; &#97; &#104;&#105;&#115;&#116;&#111;&#114;y &#105;&#116;&#101;&#109;.
+        Protected method to add a history item.
 </p><dl>
 <dt><i>itm</i></dt>
 <dd>
-&#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#105;&#116;&#101;&#109; &#116;&#111; &#97;&#100;&#100; (&#72;&#105;&#115;&#116;&#111;&#114;y&#69;&#110;&#116;&#114;y)
+reference to the history item to add (HistoryEntry)
 </dd>
 </dl><a NAME="HistoryManager._removeHistoryEntry" ID="HistoryManager._removeHistoryEntry"></a>
 <h4>HistoryManager._removeHistoryEntry</h4>
 <b>_removeHistoryEntry</b>(<i>itm</i>)
 <p>
-        &#80;&#114;&#111;&#116;&#101;&#99;&#116;&#101;&#100; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#101;&#109;&#111;v&#101; &#97; &#104;&#105;&#115;&#116;&#111;&#114;y &#105;&#116;&#101;&#109;.
+        Protected method to remove a history item.
 </p><dl>
 <dt><i>itm</i></dt>
 <dd>
-&#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#105;&#116;&#101;&#109; &#116;&#111; &#114;&#101;&#109;&#111;v&#101; (&#72;&#105;&#115;&#116;&#111;&#114;y&#69;&#110;&#116;&#114;y)
+reference to the history item to remove (HistoryEntry)
 </dd>
 </dl><a NAME="HistoryManager.addHistoryEntry" ID="HistoryManager.addHistoryEntry"></a>
 <h4>HistoryManager.addHistoryEntry</h4>
 <b>addHistoryEntry</b>(<i>url</i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#97;&#100;&#100; &#97; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;y.
+        Public method to add a history entry.
 </p><dl>
 <dt><i>url</i></dt>
 <dd>
-&#85;&#82;&#76; &#116;&#111; &#98;&#101; &#97;&#100;&#100;&#101;&#100; (&#115;&#116;&#114;&#105;&#110;&#103;)
+URL to be added (string)
 </dd>
 </dl><a NAME="HistoryManager.clear" ID="HistoryManager.clear"></a>
 <h4>HistoryManager.clear</h4>
 <b>clear</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#115;&#108;&#111;&#116; &#116;&#111; &#99;&#108;&#101;&#97;&#114; &#116;&#104;&#101; &#99;&#111;&#109;&#112;&#108;&#101;&#116;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y.
+        Public slot to clear the complete history.
 </p><a NAME="HistoryManager.close" ID="HistoryManager.close"></a>
 <h4>HistoryManager.close</h4>
 <b>close</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#99;&#108;&#111;&#115;&#101; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#109;&#97;&#110;&#97;&#103;&#101;&#114;.
+        Public method to close the history manager.
 </p><a NAME="HistoryManager.daysToExpire" ID="HistoryManager.daysToExpire"></a>
 <h4>HistoryManager.daysToExpire</h4>
 <b>daysToExpire</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#116; &#116;&#104;&#101; &#100;&#97;y&#115; &#102;&#111;&#114; &#101;&#110;&#116;&#114;y &#101;x&#112;&#105;&#114;&#97;&#116;&#105;&#111;&#110;.
+        Public method to get the days for entry expiration.
 </p><dl>
 <dt>Returns:</dt>
 <dd>
-&#100;&#97;y&#115; &#102;&#111;&#114; &#101;&#110;&#116;&#114;y &#101;x&#112;&#105;&#114;&#97;&#116;&#105;&#111;&#110; (&#105;&#110;&#116;&#101;&#103;&#101;&#114;)
+days for entry expiration (integer)
 </dd>
 </dl><a NAME="HistoryManager.history" ID="HistoryManager.history"></a>
 <h4>HistoryManager.history</h4>
 <b>history</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#101;&#116;&#117;&#114;&#110; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y.
+        Public method to return the history.
 </p><dl>
 <dt>Returns:</dt>
 <dd>
-&#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#108;&#105;&#115;&#116; &#111;&#102; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;&#105;&#101;&#115; (&#108;&#105;&#115;&#116; &#111;&#102; &#72;&#105;&#115;&#116;&#111;&#114;y&#69;&#110;&#116;&#114;y)
+reference to the list of history entries (list of HistoryEntry)
 </dd>
 </dl><a NAME="HistoryManager.historyContains" ID="HistoryManager.historyContains"></a>
 <h4>HistoryManager.historyContains</h4>
 <b>historyContains</b>(<i>url</i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#99;&#104;&#101;&#99;&#107; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#102;&#111;&#114; &#97;&#110; &#101;&#110;&#116;&#114;y.
+        Public method to check the history for an entry.
 </p><dl>
 <dt><i>url</i></dt>
 <dd>
-&#85;&#82;&#76; &#116;&#111; &#99;&#104;&#101;&#99;&#107; &#102;&#111;&#114; (&#115;&#116;&#114;&#105;&#110;&#103;)
+URL to check for (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;)
+flag indicating success (boolean)
 </dd>
 </dl><a NAME="HistoryManager.historyFilterModel" ID="HistoryManager.historyFilterModel"></a>
 <h4>HistoryManager.historyFilterModel</h4>
 <b>historyFilterModel</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#116; &#97; &#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#102;&#105;&#108;&#116;&#101;&#114; &#109;&#111;&#100;&#101;&#108;.
+        Public method to get a reference to the history filter model.
 </p><dl>
 <dt>Returns:</dt>
 <dd>
-&#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#102;&#105;&#108;&#116;&#101;&#114; &#109;&#111;&#100;&#101;&#108; (&#72;&#105;&#115;&#116;&#111;&#114;y&#70;&#105;&#108;&#116;&#101;&#114;&#77;&#111;&#100;&#101;&#108;)
+reference to the history filter model (HistoryFilterModel)
 </dd>
 </dl><a NAME="HistoryManager.historyModel" ID="HistoryManager.historyModel"></a>
 <h4>HistoryManager.historyModel</h4>
 <b>historyModel</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#116; &#97; &#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#109;&#111;&#100;&#101;&#108;.
+        Public method to get a reference to the history model.
 </p><dl>
 <dt>Returns:</dt>
 <dd>
-&#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#109;&#111;&#100;&#101;&#108; (&#72;&#105;&#115;&#116;&#111;&#114;y&#77;&#111;&#100;&#101;&#108;)
+reference to the history model (HistoryModel)
 </dd>
 </dl><a NAME="HistoryManager.historyTreeModel" ID="HistoryManager.historyTreeModel"></a>
 <h4>HistoryManager.historyTreeModel</h4>
 <b>historyTreeModel</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#103;&#101;&#116; &#97; &#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#116;&#114;&#101;&#101; &#109;&#111;&#100;&#101;&#108;.
+        Public method to get a reference to the history tree model.
 </p><dl>
 <dt>Returns:</dt>
 <dd>
-&#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#116;&#114;&#101;&#101; &#109;&#111;&#100;&#101;&#108; (&#72;&#105;&#115;&#116;&#111;&#114;y&#84;&#114;&#101;&#101;&#77;&#111;&#100;&#101;&#108;)
+reference to the history tree model (HistoryTreeModel)
 </dd>
 </dl><a NAME="HistoryManager.preferencesChanged" ID="HistoryManager.preferencesChanged"></a>
 <h4>HistoryManager.preferencesChanged</h4>
 <b>preferencesChanged</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#101; &#97; &#99;&#104;&#97;&#110;&#103;&#101; &#111;&#102; &#112;&#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101;&#115;.
+        Public method to indicate a change of preferences.
 </p><a NAME="HistoryManager.removeHistoryEntry" ID="HistoryManager.removeHistoryEntry"></a>
 <h4>HistoryManager.removeHistoryEntry</h4>
 <b>removeHistoryEntry</b>(<i>url, title = ""</i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#114;&#101;&#109;&#111;v&#101; &#97; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;y.
+        Public method to remove a history entry.
 </p><dl>
 <dt><i>url</i></dt>
 <dd>
-&#85;&#82;&#76; &#111;&#102; &#116;&#104;&#101; &#101;&#110;&#116;&#114;y &#116;&#111; &#114;&#101;&#109;&#111;v&#101; (&#81;&#85;&#114;&#108;)
+URL of the entry to remove (QUrl)
 </dd><dt><i>title</i></dt>
 <dd>
-&#116;&#105;&#116;&#108;&#101; &#111;&#102; &#116;&#104;&#101; &#101;&#110;&#116;&#114;y &#116;&#111; &#114;&#101;&#109;&#111;v&#101; (&#115;&#116;&#114;&#105;&#110;&#103;)
+title of the entry to remove (string)
 </dd>
 </dl><a NAME="HistoryManager.save" ID="HistoryManager.save"></a>
 <h4>HistoryManager.save</h4>
 <b>save</b>(<i></i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#115;&#108;&#111;&#116; &#116;&#111; &#115;&#97;v&#101; &#116;&#104;&#101; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;&#105;&#101;&#115; &#116;&#111; &#100;&#105;&#115;&#107;.
+        Public slot to save the history entries to disk.
 </p><a NAME="HistoryManager.setDaysToExpire" ID="HistoryManager.setDaysToExpire"></a>
 <h4>HistoryManager.setDaysToExpire</h4>
 <b>setDaysToExpire</b>(<i>limit</i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#115;&#101;&#116; &#116;&#104;&#101; &#100;&#97;y&#115; &#102;&#111;&#114; &#101;&#110;&#116;&#114;y &#101;x&#112;&#105;&#114;&#97;&#116;&#105;&#111;&#110;.
+        Public method to set the days for entry expiration.
 </p><dl>
 <dt><i>limit</i></dt>
 <dd>
-&#100;&#97;y&#115; &#102;&#111;&#114; &#101;&#110;&#116;&#114;y &#101;x&#112;&#105;&#114;&#97;&#116;&#105;&#111;&#110; (&#105;&#110;&#116;&#101;&#103;&#101;&#114;)
+days for entry expiration (integer)
 </dd>
 </dl><a NAME="HistoryManager.setHistory" ID="HistoryManager.setHistory"></a>
 <h4>HistoryManager.setHistory</h4>
 <b>setHistory</b>(<i>history, loadedAndSorted = False</i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#115;&#101;&#116; &#97; &#110;&#101;w &#104;&#105;&#115;&#116;&#111;&#114;y.
+        Public method to set a new history.
 </p><dl>
 <dt><i>history</i></dt>
 <dd>
-&#114;&#101;&#102;&#101;&#114;&#101;&#110;&#99;&#101; &#116;&#111; &#116;&#104;&#101; &#108;&#105;&#115;&#116; &#111;&#102; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;&#105;&#101;&#115; &#116;&#111; &#98;&#101; &#115;&#101;&#116;
-            (&#108;&#105;&#115;&#116; &#111;&#102; &#72;&#105;&#115;&#116;&#111;&#114;y&#69;&#110;&#116;&#114;y)
+reference to the list of history entries to be set
+            (list of HistoryEntry)
 </dd><dt><i>loadedAndSorted</i></dt>
 <dd>
-&#102;&#108;&#97;&#103; &#105;&#110;&#100;&#105;&#99;&#97;&#116;&#105;&#110;&#103; &#116;&#104;&#97;&#116; &#116;&#104;&#101; &#108;&#105;&#115;&#116; &#105;&#115; &#115;&#111;&#114;&#116;&#101;&#100; (&#98;&#111;&#111;&#108;&#101;&#97;&#110;)
+flag indicating that the list is sorted (boolean)
 </dd>
 </dl><a NAME="HistoryManager.updateHistoryEntry" ID="HistoryManager.updateHistoryEntry"></a>
 <h4>HistoryManager.updateHistoryEntry</h4>
 <b>updateHistoryEntry</b>(<i>url, title</i>)
 <p>
-        &#80;&#117;&#98;&#108;&#105;&#99; &#109;&#101;&#116;&#104;&#111;&#100; &#116;&#111; &#117;&#112;&#100;&#97;&#116;&#101; &#97; &#104;&#105;&#115;&#116;&#111;&#114;y &#101;&#110;&#116;&#114;y.
+        Public method to update a history entry.
 </p><dl>
 <dt><i>url</i></dt>
 <dd>
-&#85;&#82;&#76; &#111;&#102; &#116;&#104;&#101; &#101;&#110;&#116;&#114;y &#116;&#111; &#117;&#112;&#100;&#97;&#116;&#101; (&#115;&#116;&#114;&#105;&#110;&#103;)
+URL of the entry to update (string)
 </dd><dt><i>title</i></dt>
 <dd>
-&#116;&#105;&#116;&#108;&#101; &#111;&#102; &#116;&#104;&#101; &#101;&#110;&#116;&#114;y &#116;&#111; &#117;&#112;&#100;&#97;&#116;&#101; (&#115;&#116;&#114;&#105;&#110;&#103;)
+title of the entry to update (string)
 </dd>
 </dl>
 <div align="right"><a href="#top">Up</a></div>

eric ide

mercurial