--- a/TimeTracker/Documentation/source/Plugin_Time_Tracker.TimeTracker.TimeTrackEntry.html Thu Apr 09 18:44:42 2020 +0200
+++ b/TimeTracker/Documentation/source/Plugin_Time_Tracker.TimeTracker.TimeTrackEntry.html Tue Jun 23 19:40:26 2020 +0200
@@ -18,359 +18,477 @@
</style>
</head>
-<body><a NAME="top" ID="top"></a>
+<body>
+<a NAME="top" ID="top"></a>
<h1>Plugin_Time_Tracker.TimeTracker.TimeTrackEntry</h1>
+
<p>
Module implementing the time track entry class.
</p>
<h3>Global Attributes</h3>
+
<table>
<tr><td>None</td></tr>
</table>
<h3>Classes</h3>
+
<table>
+
<tr>
<td><a href="#TimeTrackEntry">TimeTrackEntry</a></td>
<td>Class implementing the time track entry.</td>
</tr>
</table>
<h3>Functions</h3>
+
<table>
<tr><td>None</td></tr>
</table>
-<hr /><hr />
+<hr />
+<hr />
<a NAME="TimeTrackEntry" ID="TimeTrackEntry"></a>
<h2>TimeTrackEntry</h2>
+
<p>
Class implementing the time track entry.
</p>
<h3>Derived from</h3>
object
<h3>Class Attributes</h3>
+
<table>
<tr><td>LineMarker</td></tr><tr><td>Separator</td></tr>
</table>
<h3>Class Methods</h3>
+
<table>
<tr><td>None</td></tr>
</table>
<h3>Methods</h3>
+
<table>
+
<tr>
<td><a href="#TimeTrackEntry.__init__">TimeTrackEntry</a></td>
<td>Constructor</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.__calculateDuration">__calculateDuration</a></td>
<td>Private method to calculate the duration in minutes.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.__currentDateTime">__currentDateTime</a></td>
<td>Private method to get the current date and time without milliseconds.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.__lt__">__lt__</a></td>
<td>Special method implementing the less than function.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.addDuration">addDuration</a></td>
<td>Public method to add a duration.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.continue_">continue_</a></td>
<td>Public method to continue the entry.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.fromString">fromString</a></td>
<td>Public method to populate the entry from the given string.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.getComment">getComment</a></td>
<td>Public method to get the comment.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.getDuration">getDuration</a></td>
<td>Public slot to get the duration.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.getEntryData">getEntryData</a></td>
<td>Public method to get the entry data.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.getID">getID</a></td>
<td>Public method to get the ID of the entry.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.getStartDateTime">getStartDateTime</a></td>
<td>Public method to get the start date and time.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.getTask">getTask</a></td>
<td>Public method to get the task description.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.isPaused">isPaused</a></td>
<td>Public method to check for a paused state.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.isValid">isValid</a></td>
<td>Public method to check the validity of the entry.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.pause">pause</a></td>
<td>Public method to pause the entry.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.setComment">setComment</a></td>
<td>Public method to set a comment.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.setDuration">setDuration</a></td>
<td>Public method to set the duration.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.setID">setID</a></td>
<td>Public method to assign an ID to the entry.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.setStartDateTime">setStartDateTime</a></td>
<td>Public method to set the start date and time.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.setTask">setTask</a></td>
<td>Public method to set the task description.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.start">start</a></td>
<td>Public method to set the start time of this entry.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.stop">stop</a></td>
<td>Public method to stop this entry.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#TimeTrackEntry.toString">toString</a></td>
<td>Public method to get a string representation of the entry.</td>
</tr>
</table>
<h3>Static Methods</h3>
+
<table>
<tr><td>None</td></tr>
</table>
+
<a NAME="TimeTrackEntry.__init__" ID="TimeTrackEntry.__init__"></a>
<h4>TimeTrackEntry (Constructor)</h4>
<b>TimeTrackEntry</b>(<i>plugin</i>)
+
<p>
Constructor
-</p><dl>
+</p>
+<dl>
+
<dt><i>plugin</i></dt>
<dd>
reference to the plugin object (TimeTrackerPlugin)
</dd>
-</dl><a NAME="TimeTrackEntry.__calculateDuration" ID="TimeTrackEntry.__calculateDuration"></a>
+</dl>
+<a NAME="TimeTrackEntry.__calculateDuration" ID="TimeTrackEntry.__calculateDuration"></a>
<h4>TimeTrackEntry.__calculateDuration</h4>
<b>__calculateDuration</b>(<i>start, stop</i>)
+
<p>
Private method to calculate the duration in minutes.
-</p><dl>
+</p>
+<dl>
+
<dt><i>start</i></dt>
<dd>
start date and time (QDateTime)
-</dd><dt><i>stop</i></dt>
+</dd>
+<dt><i>stop</i></dt>
<dd>
end date and time (QDateTime)
</dd>
-</dl><dl>
+</dl>
+<dl>
<dt>Returns:</dt>
<dd>
duration in minutes (int)
</dd>
-</dl><a NAME="TimeTrackEntry.__currentDateTime" ID="TimeTrackEntry.__currentDateTime"></a>
+</dl>
+<a NAME="TimeTrackEntry.__currentDateTime" ID="TimeTrackEntry.__currentDateTime"></a>
<h4>TimeTrackEntry.__currentDateTime</h4>
<b>__currentDateTime</b>(<i></i>)
+
<p>
Private method to get the current date and time without milliseconds.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
current date and time (QDateTime)
</dd>
-</dl><a NAME="TimeTrackEntry.__lt__" ID="TimeTrackEntry.__lt__"></a>
+</dl>
+<a NAME="TimeTrackEntry.__lt__" ID="TimeTrackEntry.__lt__"></a>
<h4>TimeTrackEntry.__lt__</h4>
<b>__lt__</b>(<i>other</i>)
+
<p>
Special method implementing the less than function.
-</p><dl>
+</p>
+<dl>
+
<dt><i>other</i></dt>
<dd>
reference to the other object (TimeTrackEntry)
</dd>
-</dl><dl>
+</dl>
+<dl>
<dt>Returns:</dt>
<dd>
flag indicating that self is less than other (boolean)
</dd>
-</dl><a NAME="TimeTrackEntry.addDuration" ID="TimeTrackEntry.addDuration"></a>
+</dl>
+<a NAME="TimeTrackEntry.addDuration" ID="TimeTrackEntry.addDuration"></a>
<h4>TimeTrackEntry.addDuration</h4>
<b>addDuration</b>(<i>duration</i>)
+
<p>
Public method to add a duration.
-</p><dl>
+</p>
+<dl>
+
<dt><i>duration</i></dt>
<dd>
duration to be added in minutes (integer). Negative
values are ignored.
</dd>
-</dl><a NAME="TimeTrackEntry.continue_" ID="TimeTrackEntry.continue_"></a>
+</dl>
+<a NAME="TimeTrackEntry.continue_" ID="TimeTrackEntry.continue_"></a>
<h4>TimeTrackEntry.continue_</h4>
<b>continue_</b>(<i></i>)
+
<p>
Public method to continue the entry.
-</p><a NAME="TimeTrackEntry.fromString" ID="TimeTrackEntry.fromString"></a>
+</p>
+<a NAME="TimeTrackEntry.fromString" ID="TimeTrackEntry.fromString"></a>
<h4>TimeTrackEntry.fromString</h4>
<b>fromString</b>(<i>line</i>)
+
<p>
Public method to populate the entry from the given string.
-</p><dl>
+</p>
+<dl>
+
<dt><i>line</i></dt>
<dd>
stringified entry data as generated by toString() (string)
</dd>
-</dl><dl>
+</dl>
+<dl>
<dt>Returns:</dt>
<dd>
ID of the tracker entry; -1 indicates an error (integer)
</dd>
-</dl><a NAME="TimeTrackEntry.getComment" ID="TimeTrackEntry.getComment"></a>
+</dl>
+<a NAME="TimeTrackEntry.getComment" ID="TimeTrackEntry.getComment"></a>
<h4>TimeTrackEntry.getComment</h4>
<b>getComment</b>(<i></i>)
+
<p>
Public method to get the comment.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
comment (string)
</dd>
-</dl><a NAME="TimeTrackEntry.getDuration" ID="TimeTrackEntry.getDuration"></a>
+</dl>
+<a NAME="TimeTrackEntry.getDuration" ID="TimeTrackEntry.getDuration"></a>
<h4>TimeTrackEntry.getDuration</h4>
<b>getDuration</b>(<i></i>)
+
<p>
Public slot to get the duration.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
duration (integer)
</dd>
-</dl><a NAME="TimeTrackEntry.getEntryData" ID="TimeTrackEntry.getEntryData"></a>
+</dl>
+<a NAME="TimeTrackEntry.getEntryData" ID="TimeTrackEntry.getEntryData"></a>
<h4>TimeTrackEntry.getEntryData</h4>
<b>getEntryData</b>(<i></i>)
+
<p>
Public method to get the entry data.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
entry data as a tuple of start date (string), start time
(string), duration (integer), task (string), comment (string)
and flag indicating a paused state (boolean)
</dd>
-</dl><a NAME="TimeTrackEntry.getID" ID="TimeTrackEntry.getID"></a>
+</dl>
+<a NAME="TimeTrackEntry.getID" ID="TimeTrackEntry.getID"></a>
<h4>TimeTrackEntry.getID</h4>
<b>getID</b>(<i></i>)
+
<p>
Public method to get the ID of the entry.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
ID of the entry (integer)
</dd>
-</dl><a NAME="TimeTrackEntry.getStartDateTime" ID="TimeTrackEntry.getStartDateTime"></a>
+</dl>
+<a NAME="TimeTrackEntry.getStartDateTime" ID="TimeTrackEntry.getStartDateTime"></a>
<h4>TimeTrackEntry.getStartDateTime</h4>
<b>getStartDateTime</b>(<i></i>)
+
<p>
Public method to get the start date and time.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
start date and time (QDateTime)
</dd>
-</dl><a NAME="TimeTrackEntry.getTask" ID="TimeTrackEntry.getTask"></a>
+</dl>
+<a NAME="TimeTrackEntry.getTask" ID="TimeTrackEntry.getTask"></a>
<h4>TimeTrackEntry.getTask</h4>
<b>getTask</b>(<i></i>)
+
<p>
Public method to get the task description.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
task description (string)
</dd>
-</dl><a NAME="TimeTrackEntry.isPaused" ID="TimeTrackEntry.isPaused"></a>
+</dl>
+<a NAME="TimeTrackEntry.isPaused" ID="TimeTrackEntry.isPaused"></a>
<h4>TimeTrackEntry.isPaused</h4>
<b>isPaused</b>(<i></i>)
+
<p>
Public method to check for a paused state.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
flag indicating a paused state (boolean)
</dd>
-</dl><a NAME="TimeTrackEntry.isValid" ID="TimeTrackEntry.isValid"></a>
+</dl>
+<a NAME="TimeTrackEntry.isValid" ID="TimeTrackEntry.isValid"></a>
<h4>TimeTrackEntry.isValid</h4>
<b>isValid</b>(<i></i>)
+
<p>
Public method to check the validity of the entry.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
validity of the entry (boolean)
</dd>
-</dl><a NAME="TimeTrackEntry.pause" ID="TimeTrackEntry.pause"></a>
+</dl>
+<a NAME="TimeTrackEntry.pause" ID="TimeTrackEntry.pause"></a>
<h4>TimeTrackEntry.pause</h4>
<b>pause</b>(<i></i>)
+
<p>
Public method to pause the entry.
-</p><a NAME="TimeTrackEntry.setComment" ID="TimeTrackEntry.setComment"></a>
+</p>
+<a NAME="TimeTrackEntry.setComment" ID="TimeTrackEntry.setComment"></a>
<h4>TimeTrackEntry.setComment</h4>
<b>setComment</b>(<i>comment</i>)
+
<p>
Public method to set a comment.
-</p><dl>
+</p>
+<dl>
+
<dt><i>comment</i></dt>
<dd>
comment to set (string)
</dd>
-</dl><a NAME="TimeTrackEntry.setDuration" ID="TimeTrackEntry.setDuration"></a>
+</dl>
+<a NAME="TimeTrackEntry.setDuration" ID="TimeTrackEntry.setDuration"></a>
<h4>TimeTrackEntry.setDuration</h4>
<b>setDuration</b>(<i>duration</i>)
+
<p>
Public method to set the duration.
-</p><dl>
+</p>
+<dl>
+
<dt><i>duration</i></dt>
<dd>
duration in minutes (integer)
</dd>
-</dl><a NAME="TimeTrackEntry.setID" ID="TimeTrackEntry.setID"></a>
+</dl>
+<a NAME="TimeTrackEntry.setID" ID="TimeTrackEntry.setID"></a>
<h4>TimeTrackEntry.setID</h4>
<b>setID</b>(<i>eid</i>)
+
<p>
Public method to assign an ID to the entry.
-</p><dl>
+</p>
+<dl>
+
<dt><i>eid</i></dt>
<dd>
ID for the entry (integer)
</dd>
-</dl><a NAME="TimeTrackEntry.setStartDateTime" ID="TimeTrackEntry.setStartDateTime"></a>
+</dl>
+<a NAME="TimeTrackEntry.setStartDateTime" ID="TimeTrackEntry.setStartDateTime"></a>
<h4>TimeTrackEntry.setStartDateTime</h4>
<b>setStartDateTime</b>(<i>startDateTime</i>)
+
<p>
Public method to set the start date and time.
-</p><dl>
+</p>
+<dl>
+
<dt><i>startDateTime</i></dt>
<dd>
start date and time (QDateTime)
</dd>
-</dl><a NAME="TimeTrackEntry.setTask" ID="TimeTrackEntry.setTask"></a>
+</dl>
+<a NAME="TimeTrackEntry.setTask" ID="TimeTrackEntry.setTask"></a>
<h4>TimeTrackEntry.setTask</h4>
<b>setTask</b>(<i>description</i>)
+
<p>
Public method to set the task description.
-</p><dl>
+</p>
+<dl>
+
<dt><i>description</i></dt>
<dd>
task description (string)
</dd>
-</dl><a NAME="TimeTrackEntry.start" ID="TimeTrackEntry.start"></a>
+</dl>
+<a NAME="TimeTrackEntry.start" ID="TimeTrackEntry.start"></a>
<h4>TimeTrackEntry.start</h4>
<b>start</b>(<i></i>)
+
<p>
Public method to set the start time of this entry.
-</p><a NAME="TimeTrackEntry.stop" ID="TimeTrackEntry.stop"></a>
+</p>
+<a NAME="TimeTrackEntry.stop" ID="TimeTrackEntry.stop"></a>
<h4>TimeTrackEntry.stop</h4>
<b>stop</b>(<i></i>)
+
<p>
Public method to stop this entry.
-</p><a NAME="TimeTrackEntry.toString" ID="TimeTrackEntry.toString"></a>
+</p>
+<a NAME="TimeTrackEntry.toString" ID="TimeTrackEntry.toString"></a>
<h4>TimeTrackEntry.toString</h4>
<b>toString</b>(<i></i>)
+
<p>
Public method to get a string representation of the entry.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
string representation of the entry (string)
