← Back to branch summary

~ubuntu-branches/ubuntu/vivid/kdepim/vivid

« back to all changes in this revision

Viewing changes to doc/ktimetracker/index.docbook

  • Committer: Package Import Robot
  • Author(s): Scott Kitterman, Jonathan Riddell, Rohan Garg, Scott Kitterman
  • Date: 2012-11-21 13:12:36 UTC
  • mfrom: (0.2.33)
  • Revision ID: package-import@ubuntu.com-20121121131236-32ijw9a2txrar80k
Tags: 4:4.9.80-0ubuntu1
[ Jonathan Riddell ]
* New upstream beta release

[ Rohan Garg ]
* Add nepomuk-core-dev to build-deps

[ Scott Kitterman ]
* Add new package, libpimcommon4
  - Add libpimcommon4.install
  - Add to debian/control, including kdepim-dbg and kdepim-dev depends
  - Add to kdepim-dev.install
* Remove usr/bin/backupmail and related files from kmail.install as they are
  not provided by upstream anymore
* Add usr/bin/pimsettingexporter and related files to kmail.install
* Add libnepomukwidgets-dev to build-depends

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/ktimetracker/index.docbook
8
8
 
9
9
<book id="ktimetracker" lang="&language;">
10
10
 
11
 
<bookinfo>
 
11
<bookinfo id="ktimetrackerinfo">
12
12
<title>The &ktimetracker; Handbook</title>
13
13
 
14
14
<authorgroup>
118
118
<title>Tasks</title>
119
119
 
120
120
<informalexample>
121
 
<para><emphasis>Problem:</emphasis> You are a free software consultant with
 
121
<para><emphasis>Problem:</emphasis> You are a freelance software consultant with
122
122
many clients.  Some clients have multiple projects.  During the course of a
123
123
day, you switch back and forth between different projects.  You need to track
124
124
your time to generate monthly invoices.</para>
125
125
<para><emphasis>Solution:</emphasis> Create one top-level task for each client
126
126
and a subtask for each client project.  For projects that require more
127
127
detailed tracking, create a list of project subtasks.  Track time by
128
 
double-clicking on task you are currently working on.</para>
 
128
double-clicking on the task you are currently working on.</para>
129
129
</informalexample>
130
130
 
131
131
<para>&ktimetracker; provides great flexibility in tracking your time, allowing
143
143
<guimenuitem>New Task...</guimenuitem>
144
144
</menuchoice>. 
145
145
 
146
 
To create a subtask, pick the parent task and select
 
146
To create a subtask, highlight the parent task and select
147
147
 
148
148
<menuchoice>
149
149
<shortcut>
281
281
 
282
282
<varlistentry><term><guibutton>Revert timing</guibutton></term>
283
283
<listitem><para>Subtract the amount of idle time from all active timers and
284
 
stop them.</para><para>You were not working on the task(s) while you
285
 
computer was idle and you are still are
286
 
not.</para></listitem></varlistentry> 
 
284
stop them.</para><para>You were not working on the task(s) while your
 
285
computer was idle and you are still not.</para></listitem></varlistentry>
287
286
</variablelist>
288
287
 
289
288
</sect2>
296
295
 
297
296
<para>&ktimetracker;, like &korganizer; and Apple's iCal, uses the industry standard
298
297
<ulink url="http://www.faqs.org/rfcs/rfc2445.html">iCalendar</ulink>
299
 
format for its data.  &ktimetracker; can read and write the to do lists created by
 
298
format for its data.  &ktimetracker; can read and write the to-do lists created by
300
299
these two applications.</para>
301
300
<para>
302
301
You can even work synchronously on one file with &korganizer; and &ktimetracker;. 
327
326
other.  A &kde; program provides a list of functions that other programs (a Bash
328
327
script, for example) can use.</para>
329
328
 
330
 
<example><title>Bash script that echo's &ktimetracker;'s version</title>
 
329
<example><title>Bash script that echoes &ktimetracker;'s version</title>
331
330
<programlisting>
332
331
qdbus org.kde.ktimetracker /KTimeTracker version 2>/dev/null || echo "ktimetracker not running"
333
332
</programlisting>
369
368
</mediaobject>
370
369
</screenshot>
371
370
 
372
 
<para>Enter the file you would like to export the data to, and modify the
 
371
<para>Enter the filename that you would like to export the data to, and modify the
373
372
other dialog defaults if necessary.  Click
374
373
<guibutton>Export</guibutton> and &ktimetracker; exports the totals for all tasks to
375
374
the file you selected.</para>
409
408
<guimenuitem>Export History...</guimenuitem>
410
409
</menuchoice> and &ktimetracker; displays the same export dialog as shown above.</para>
411
410
 
412
 
<para>Enter the file you would like to export the data to, and select a date
413
 
range that you want the task history.  Modify the other dialog defaults if
 
411
<para>Enter the filename that you would like to export the data to, and select a date
 
412
range that you want the task history to cover.  Modify the other dialog defaults if
414
413
necessary.  Click <guibutton>Export</guibutton> and &ktimetracker; exports the
415
 
task history for all tasks to the file you selected.</para>
416
 
<para>Use the <guibutton>Export to Clipboard</guibutton> button to export the history to the clipboard</para>
 
414
task history to the chosen file.</para>
 
415
<para>Use the <guibutton>Export to Clipboard</guibutton> button to export the history to the clipboard.</para>
417
416
 
418
417
<para>Here is an example of the output format:</para>
419
418
 
435
434
</computeroutput>
436
435
</literallayout>
437
436
 
438
 
<para>The three lines identify when the report was generated and for which
 
437
<para>The first three lines identify when the report was generated and for which
439
438
date range.  The fourth row is a comma-delimited list of the dates in the
440
439
date range, in ISO 8601 format (YYYY-MM-DD).  All subsequent rows list the
441
440
time logged against each task.   The last numeric column is the row total
454
453
<para>The main &ktimetracker; window has the following components: menubar, toolbar, 
455
454
searchbar, task/time window and status bar.</para>
456
455
 
457
 
<para>The searchbar is a combined field. As long as you do not type &Enter;, it acts as a 
 
456
<para>The searchbar is a combined field. As long as you do not press &Enter;, it acts as a
458
457
filter. Then, only tasks that match your input are shown. As soon as you 
459
 
type &Enter;, your input is used as name to create a new task.
 
458
press &Enter;, your input is used as a name to create a new task.
460
459
</para>
461
460
 
462
461
<para>Choose <guilabel>Configuration for PDA</guilabel> in the settings dialog
494
493
<title>The Toolbar and Statusbar</title>
495
494
<para>The toolbar contains icons for the following commands:</para>
496
495
 
497
 
<note><para>(All behave identically to the menu command.)</para></note>
 
496
<note><para>All behave identically to the menu command.</para></note>
498
497
 
499
498
<itemizedlist>
500
499
<listitem><para><guiicon>New Task</guiicon></para></listitem>
586
585
<glossentry id="gloss-desktop">
587
586
<glossterm>desktop</glossterm>
588
587
<glossdef><para>&GNU;/&Linux;, FreeBSD and other systems that run X-Windows have
589
 
multiple desktops.  You typically have four different desktops installed by
 
588
multiple desktops.  You can typically have four different desktops installed by
590
589
default.  Each desktop can display its own set of programs and files.  When
591
590
&kde; first starts up, the desktop you see is Desktop 1.  If you press
592
591
<keycombo action="simul">&Ctrl;<keycap>F2</keycap></keycombo>, you will see
599
598
<title>H</title> 
600
599
<glossentry id="gloss-history">
601
600
<glossterm>history</glossterm>
602
 
<glossdef><para>If &ktimetracker; is configured to log history, it will record ever
603
 
start/stop timer event. This history is never cleared when times are reset
604
 
cleared and remains on file until the task is deleted.</para></glossdef>
 
601
<glossdef><para>If &ktimetracker; is configured to log history, it will record every
 
602
start/stop timer event. This history is not cleared when times are reset
 
603
and remains on file until the task is deleted.</para></glossdef>
605
604
</glossentry>
606
605
</glossdiv>
607
606