summaryrefslogtreecommitdiffstats
path: root/tde-i18n-nl/docs/tdepim/karm/index.docbook
blob: 350d941cbde18390d1171aa219495ae7f95d789e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&karm;">
  <!ENTITY package "tdepim">
  <!ENTITY % Dutch "INCLUDE"> <!-- change language only here -->
  <!ENTITY % addindex "IGNORE">
]>

<book lang="&language;">

<bookinfo>
<title>Het handboek van &karm;</title>

<authorgroup>
<author><firstname>Jonathan</firstname> <surname>Singer</surname> <affiliation> <address><email>jsinger@leeta.net</email></address>
</affiliation>
</author>

<author><firstname>Mark</firstname> <surname>Bucciarelli</surname> <affiliation> <address><email>mark@hubcapconsulting.com</email></address>
</affiliation>
</author>

<author><firstname>Sirtaj</firstname> <othername>Singh</othername> <surname>Kang</surname> <affiliation><address><email>taj@kde.org</email></address></affiliation>
</author>

<othercredit role="reviewer"><firstname>Lauri</firstname> <surname>Watts</surname> <contrib>Nalezer</contrib>
<affiliation><address><email>lauri@kde.org</email></address></affiliation>
</othercredit>
&Tom.Albers;&Sander.Koning;&Natalie.Koning; 
</authorgroup>

<copyright>
<year>2000-2004</year>
<holder>Jonathan Singer</holder>
</copyright>

<copyright>
<year>2004-2005</year>
<holder>Mark Bucciarelli</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>2005-02-02</date>
<releaseinfo>1.5.0</releaseinfo>

<abstract><para>&karm; houdt de tijd bij die besteed wordt aan verschillende taken.</para></abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>karm</keyword>
<keyword>tdeutils</keyword>
<keyword>tijd</keyword>
<keyword>bijhouder</keyword>
<keyword>project</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title>Inleiding</title>

<para>&karm; houdt de tijd bij die besteed wordt aan verschillende taken. Het kan gebruikt worden om de tijd bij te houden van taken die bijvoorbeeld aan klanten gefactureerd moet worden, de tijd kan per taak en per dag gerapporteerd worden.</para>

<para>Deze tijdsgeschiedenis kan naar een komma-gescheiden tekstbestand ge&euml;xporteerd worden om dit in andere facturerings- of projectbeheer-hulpmiddelen te importeren.</para>

<para>&karm; detecteert wanneer uw toetsenbord en muis ongebruikt zijn en kan verschillende taken aan diverse bureaubladen koppelen, twee hulpmiddelen die kunnen helpen bij het correct bijhouden van de taken.</para>

<para>&karm; is in eerste instantie geschreven door Sirtaj Singh Kang. Het woord <quote>karm</quote> betekent <quote>werk</quote> of <quote>daden</quote> in het Punjaabs, de moedertaal van de auteur, en is hetzelfde woord (maar een betere transcriptie) als <quote>karma</quote>.</para>

</chapter>


<chapter id="using-Karm">
<title>&karm; gebruiken</title>

<sect1 id="starting">
<title>&karm; starten</title>

<para>Typ <command>karm</command> in op de commandoregel of kies <guimenuitem>Tijdsregistratie</guimenuitem> uit de groep <guisubmenu>Hulpmiddelen</guisubmenu> van het <guimenu>KDE-startmenu</guimenu>. De standaard &Qt; en &kde; parameters zijn beschikbaar. Een overzicht van beschikbare parameters kan verkregen worden door <userinput><command>karm</command> <option>--help</option></userinput> op de commandoregel te typen.</para>

<para>&karm; biedt een additionele opdrachtoptie waarmee u de naam van het iCalendar-bestand kunt opgeven dat gebruikt wordt om uw werkgeschiedenis in op te slaan. U kunt een extern iCalendar-bestand opgeven door "http" of "ftp" als deel van de bestandsnaam te gebruiken, bijvoorbeeld http://www.mijnsite.com/mijndata/mijnwerk.ics</para>

</sect1>

<sect1 id="general-use">
<title>Taken</title>

<informalexample>
<para><emphasis>Probleem:</emphasis> U bent een software-consultant met veel klanten. Sommige klanten hebben meerdere projecten. Gedurende een dag schakelt u heen en weer tussen de verschillende projecten. U moet uw tijd bijhouden om maandelijkse rekeningen te kunnen maken.</para>
<para><emphasis>Oplossing:</emphasis> Maak een topniveau-taak voor elke klant en een subtaak voor elk project. Voor projecten die gedetailleerder bijgehouden moeten worden, maakt u een lijst van project-subtaken. U houdt de tijd bij door te dubbelklikken op de taak waar u op het moment aan werkt.</para>
</informalexample>

<para>&karm; biedt grote flexibiliteit in het bijhouden van uw tijd door een ongelimiteerd aantal taken en taakniveaus. Tijd kan bij elke taak worden bijgehouden en er kunnen meerdere taken tegelijkertijd actief zijn.</para>

<para>Om een topniveau-taak aan te maken kiest u <menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo> </shortcut> <guimenu>Taak</guimenu> <guimenuitem>Nieuw</guimenuitem> </menuchoice>. Om een subtaak aan te maken kiest u de bovenliggende taak en kiest u <menuchoice> <shortcut> <keycombo action="simul">&Ctrl;&Alt;<keycap>N</keycap></keycombo> </shortcut> <guimenu>Taak</guimenu> <guimenuitem>Nieuwe subtaak</guimenuitem> </menuchoice>. </para>

<para>Als u &karm; afsluit wordt de takenlijst opgeslagen in het bestand dat opgegeven is in <menuchoice><guimenu>Instellingen</guimenu> <guimenuitem>KArm instellen</guimenuitem> </menuchoice>. Bij de volgende start wordt de takenlijst uit hetzelfde bestand geladen.</para>

<para>&karm; kan taken importeren en exporteren om uw werk te minimaliseren. Zie <link linkend="interfaces">Andere systemen</link>.</para>

</sect1>

<sect1 id="timers"><title>Timers</title>

<informalexample>
<para><emphasis>Probleem:</emphasis> Om al uw uitgaven te kunnen doen moet u een gemiddelde van vijf uur per dag factureren. Om ervoor te zorgen dat u dit haalt, houdt u uw dag- en weektotalen in de gaten.</para>
<para><emphasis>Oplossing:</emphasis> Reset de sessie-timer aan het begin van elke werkdag en reset alle timers aan het begin van elke week.</para> </informalexample>

<para>&karm; maakt het bijhouden van tijd eenvoudig. Om de tijd die aan een taak besteed wordt bij te houden dubbelklikt u op de taak. Om het bijhouden te stoppen, dubbelklikt u opnieuw op de taak. Actieve taken worden aangegeven door een klokje in de kolom <guilabel>Sessietijd</guilabel>.</para>
	
<para>Een andere visuele aanwijzing van activiteit is het systeemvakpictogram van &karm;. Als er een taak actief is, beweegt de secondewijzer in het pictogram. Als u de muiswijzer op dit pictogram laat rusten, wordt de naam van de actieve taak in een hulpballon weergegeven. Als er meer dan één taak actief is, worden de taaknamen in de hulpballon gescheiden door komma's.</para>

<para>&karm; houdt twee timers bij voor elke taak: één voor de sessietijd en één voor de totale tijd. In de standaardinstelling geeft &karm; twee kolommen voor elke timer weer, hetgeen op vier kolommen voor elke taak uitkomt:</para>

<variablelist>
<varlistentry> <term><guilabel>Sessietijd</guilabel></term>
<listitem><para>De tijd die aan de taak is besteed sinds het begin van de sessie.</para></listitem> </varlistentry> 

<varlistentry> <term><guilabel>Totale sessietijd</guilabel></term>
<listitem><para>De tijd die aan de taak en alle subtaken ervan besteed is sinds het begin van de sessie.</para></listitem> </varlistentry> 
<varlistentry> <term><guilabel>Tijd</guilabel></term> <listitem><para>De tijd die aan de taak is besteed sinds alle tijden gereset zijn.</para></listitem>
</varlistentry> 

<varlistentry> <term><guilabel>Totale tijd</guilabel></term>
<listitem><para>De tijd die aan de taak en alle subtaken ervan is besteed sinds alle tijden gereset zijn.</para></listitem> </varlistentry> 
</variablelist>

<para>Om een nieuwe sessie te starten, kiest u het menu <menuchoice> <guimenu>Bestand</guimenu> <guimenuitem>Nieuwe sessie starten</guimenuitem> </menuchoice>. </para>

<para>Om alle tijden te resetten, kiest u het menu <menuchoice> <guimenu>Bestand</guimenu> <guimenuitem>Alle tijden resetten</guimenuitem> </menuchoice>. </para>

<sect2><title>Bureaubladen volgen</title>

<informalexample>
<para><emphasis>Probleem:</emphasis> U hebt twee hoofdprojecten waartussen u elke dag heen en weer schakelt. Om uw werk te organiseren houdt u de bestanden van project 1 op bureaublad 1 en die van project 2 op bureaublad 2.</para>

<para><emphasis>Oplossing:</emphasis> Verbind de taak van project 1 met bureaublad 1 en de taak van project 2 met bureaublad 2. Als u van bureaublad 2 naar bureaublad 1 overschakelt, stopt &karm; automatisch de taak van project 2 en start de taak van project 1.</para>
</informalexample>

<para>Om een taak met één of meer bureaubladen te verbinden, kiest u het menu <menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo> </shortcut> <guimenu>Taak</guimenu> <guimenuitem>Bewerken</guimenuitem> </menuchoice>. Schakel <guilabel>Automatisch volgen</guilabel> in en kies de bureaubladen waaraan u de taak wilt verbinden. Als één van de gekozen bureaubladen actief wordt, begint &karm; na korte tijd automatisch de tijd voor die taak bij te houden.</para>

</sect2>

<sect2><title>Inactiviteitsdetectie</title>

<informalexample> <para><emphasis>Probleem:</emphasis> U gaat vroeg van uw werk weg op vrijdag om een bericht te bezorgen en vergeet de timer stop te zetten. Als u terugkomt op maandag loopt de timer nog steeds.</para>
<para><emphasis>Oplossing:</emphasis> Schakel inactiviteitsdetectie in.</para>
</informalexample>

<para>&karm; kan ingesteld worden om inactiviteit van muis en toetsenbord te detecteren. Als de muis en het toetsenbord langer dan de ingestelde tijd inactief zijn, toont &karm; het volgende dialoogvenster:</para>

<screenshot>
 <screeninfo>Inactiviteitsdetectie van &karm;</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="idle-detect.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Het dialoogvenster "Inactiviteitsdetectie" van &karm;</phrase>
          </textobject>
        </mediaobject>
</screenshot>

<variablelist>
<varlistentry><term><guibutton>Terugdraaien &amp; stoppen</guibutton></term>
<listitem><para>Trek de hoeveelheid inactieve tijd van alle actieve timers af en stop de timers.</para><para>U was niet aan de taken aan het werken toen uw computer inactief was en u bent nog steeds niet aan het werk.</para></listitem></varlistentry> 

<varlistentry> <term><guibutton>Terugdraaien &amp; doorgaan</guibutton></term>
<listitem><para>Trek de hoeveelheid inactieve tijd van alle actieve timers af maar laat ze wel lopen.</para><para>U was niet aan het werk toen uw computer inactief was, maar bent nu wel aan het werk. </para></listitem></varlistentry> 

<varlistentry> <term><guibutton>Doorgaan met tijd opnemen</guibutton></term>
<listitem><para>Pas de inactieve tijd toe op alle actieve timers en laat ze lopen.</para><para>U was aan de taken aan het werk toen uw computer inactief was en bent nog steeds aan het werk. </para></listitem></varlistentry> </variablelist>

</sect2>

</sect1>

<sect1 id="reporting"><title>Rapportage</title>

<para>&karm; biedt drie manieren om de bijgehouden tijd te rapporteren. U kunt de sessie- en tijdstotalen naar de printer sturen, de tijdstotalen naar het klembord kopiëren, of de tijdsgeschiedenis naar het klembord kopiëren.</para>

<sect2><title>Totalen afdrukken</title>
<para>Om het totalenrapport voor de printer te genereren, kiest u het menu <menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo> </shortcut> <guimenu>Bestand</guimenu> <guimenuitem>Afdrukken</guimenuitem> </menuchoice>. Dit genereert een rapport met drie kolommen voor de complete takenlijst. De eerste kolom is de taaknaam, de tweede kolom is de <guilabel>Totale sessietijd</guilabel> en de derde kolom is de <guilabel>Totale tijd</guilabel>.</para>
</sect2>

<sect2><title>Totalen op klembord</title>
<para>Om het totalenrapport naar het klembord te kopiëren, kiest u <menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> </shortcut> <guimenu>Bestand</guimenu> <guimenuitem>Totalen kopiëren naar klembord</guimenuitem> </menuchoice>. </para>

<para>Dit rapport wordt gegenereerd voor de huidige taak en alle subtaken ervan. Als de huidige taak een topniveau-taak is, vraagt &karm; u of u het rapport voor de huidige taak en subtaken wilt genereren, of voor de gehele takenlijst.</para>

<screenshot>
<screeninfo>&karm; Kopieer deze taak</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="copy-this-task.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Het dialoogvenster "Kopieer deze taak" in &karm;</phrase>
</textobject>
</mediaobject>
</screenshot>

<para>Als het rapport gegenereerd is, opent u KEdit of een andere editor en plakt u de rapportdata.</para>

<literallayout><computeroutput>
Taaktotaal
2004-07-10 02:26

  Tijd    Taak
----------------------------------------------
  9:14    kde
   9:14    karm
    1:08    bugs
    0:00    wijzigingen
   0:00    promo
   0:00    web zaken
----------------------------------------------
  9:14 Totaal
</computeroutput>
</literallayout>

<para>De eerste kolom is de <guilabel>Totale tijd</guilabel> en is ingesprongen (net als de taaknamen) om taak-/subtaak-relaties aan te geven. De gerapporteerde tijden zijn inclusief subtaaktijden.</para> 

</sect2>

<sect2><title>Geschiedenis op klembord</title>

<para>Om het totalenrapport op het klembord te plaatsen, kiest u het menu <menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo> </shortcut> <guimenu>Bestand</guimenu> <guimenuitem>Geschiedenis kopiëren naar klembord</guimenuitem> </menuchoice>. </para>

<important><para>U dient de optie <guilabel>Loggeschiedenis</guilabel> in <menuchoice> <guimenu>Instellingen</guimenu> <guimenuitem>KArm instellen</guimenuitem></menuchoice> in te schakelen. Anders houdt &karm; alleen totalen bij en niet de gedetailleerde taakgeschiedenis.</para></important>

<para>Dit rapport wordt voor de huidige taak en subtaken gegenereerd. In tegenstelling tot het totalenrapport kunt u bij dit rapport niet de hele takenlijst laten rapporteren. U kunt alleen rapporteren op de huidige taak en subtaken.</para>

<para>Als u het geschiedenisrapport kiest, vraagt &karm; u eerst om het datumbereik voor het rapport in te voeren.</para>

<screenshot>
<screeninfo>&karm; Datumbereik</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="daterange.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&karm; Datumbereik invoeren</phrase>
</textobject>
</mediaobject>
</screenshot>

<para>Na het invoeren van een datumbereik opent u KEdit of een andere editor en plakt u daar de rapportdata.</para>

<literallayout><computeroutput>
Taakgeschiedenis
Van donderdag 01 juli 2004 tot maandag 12 juli 2004
Afgedrukt op: 2004-07-12 17:18

                               Week van maandag 05 juli 2004
     5     6     7     8     9    10    11
-------------------------------------------------------------------------
                                             0:00 kde
                                             0:00  dc
              1:22  1:46  3:14  1:44         8:06  karm
                                             0:00   3.2 planning
              1:08                           1:08   bugs
                                             0:00   wijzigingen
                                             0:00  promo
                                             0:00  web-dingen
-------------------------------------------------------------------------
              2:30  1:46  3:14  1:44         9:14 Totaal
</computeroutput>
</literallayout>

<para>De taakgeschiedenis wordt opgeteld voor elke dag en taak, gegroepeerd per week. De eerste zeven kolommen zijn maandag tot en met zondag. De achtste kolom is het weektotaal en de negende kolom is de taaknaam. De taaknamen worden ingesprongen om de taak-/subtaak-relaties aan te geven.</para>

</sect2>
</sect1>

<sect1 id="interfaces">
<title>Andere systemen</title>
<sect2 id="korganizer"><title>KOrganizer</title>

<para>&karm; gebruikt net als KOrganizer en Apple's iCal de industriestandaard <ulink url="http://developer.kde.org/documentation/standards/index.html">iCalendar</ulink> als formaat voor gegevens. &karm; kan takenlijsten van deze twee toepassingen lezen en schrijven.</para>

<warning><para>Als zowel &karm; als KOrganizer hetzelfde bestand geopend hebben, riskeert u gegevensverlies als u het bestand met KOrganizer bewerkt. Bewerk voor de veiligheid het bestand slechts met één toepassing tegelijk.</para></warning>

</sect2>

<sect2 id="planner"><title>Planner</title>

<para>Als een typisch voorbeeld wilt u wellicht een project plannen met het projectbeheergereedschap Imendio Planner (van <ulink url="http://planner.imendio.org">planner.imendio.org</ulink>) en de taken daaruit importeren in &karm;, om ze in het industrie-standaardformaat <ulink url="http://developer.kde.org/documentation/standards/index.html">iCalendar</ulink> te hebben. Als u dat gedaan hebt, kunt u de taken in KOrganizer inroosteren en de tijd die u aan de taken besteed hebt in &karm; bijhouden. Dat is één manier om ervoor te zorgen dat uw project op tijd en binnen het budget afkomt.</para>

</sect2>

<sect2 id="dcop"><title>&DCOP;</title>

<para>&DCOP; is het mechanisme waarmee KDE-programma's met elkaar communiceren. Een KDE-programma biedt een lijst van functies (zoals een Bash-script) die andere programma's kunnen gebruiken.</para>

<example><title>Bash-script dat de versie van &karm; weergeeft</title>
<programlisting>DCOPID=`dcop | grep karm`
        if [ $DCOPID ]
        then
                VERS=`dcop $DCOPID KarmDCOPIface version`
                echo "&karm; versie is $VERS"
        else
                echo "&karm; niet actief"
        fi
</programlisting>
</example>

<para>&karm;'s huidige &DCOP;-interface wordt momenteel vooral gebruikt voor geautomatiseerd testen en is dus erg beperkt. Zie voor de volledige interfacedefinitie <link linkend="dcopappendix">&DCOP;-interface appendix</link>.</para>

<para>Om de volledige &DCOP;-interface te zien van de &karm;-versie die op uw systeem staat, voert u het volgende Bash-script uit:</para>

<example><title>&karm;'s &DCOP;-interface op het scherm weergeven</title>
<programlisting>DCOPID=`dcop | grep karm`
        if [ $DCOPID ]
        then
                dcop $DCOPID KarmDCOPIface
        else
                echo "&karm; niet actief"
        fi
</programlisting>
</example>
</sect2>

<sect2 id="csv-export"><title>Totalen exporteren naar CSV</title>

<para>&karm; kan zowel totalen als geschiedenis naar een komma-gescheiden bestand exporteren. Om totalen te exporteren, kiest u het menu <menuchoice> <guimenu>Bestand</guimenu> <guisubmenu>Importeren/Exporteren</guisubmenu> <guimenuitem>Exporteren naar CSV-bestand...</guimenuitem> </menuchoice> en &karm; toont het volgende dialoogvenster:</para>

<screenshot>
<screeninfo>Het dialoogvenster "CVS-export" van &karm;</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="csvexport.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Het dialoogvenster "CVS-export" van &karm;</phrase>
</textobject>
</mediaobject>
</screenshot>

<para>Voer de bestandsnaam in waarnaar u de data wilt exporteren, en wijzig de andere instellingen indien nodig. Merk op dat het datumbereik niet ingesteld kan worden aangezien u de totalen exporteert, niet de geschiedenis. Klik op de knop <guibutton>Exporteren</guibutton> en &karm; exporteert de totalen voor alle taken naar het gekozen bestand.</para>

<para>Hier is een voorbeeld van het uitvoerformaat:</para>

<literallayout><computeroutput>
"kde",,,,,0.00,0.00,6.88,9.83
,"karm",,,,6.88,8.70,6.88,9.83
,,"3.2 plan",,,0.00,0.00,0.00,0.00
,,"bugs",,,0.00,1.13,0.00,1.13
,,"wijzigingen - vertalingen",,,0.00,0.00,0.00,0.00
,,"tijdrapport",,,0.00,0.00,0.00,0.00
,"kopete",,,,0.00,0.00,0.00,0.00
,"promo",,,,0.00,0.00,0.00,0.00
,"web-dingen",,,,0.00,0.00,0.00,0.00
</computeroutput>
</literallayout>

<para>Topniveau-taken staan in de eerste kolom, subtaken in de tweede, en zo door. De tijdsgegevens worden vermeld na de maximale taakdiepte (vijf in dit voorbeeld). De eerste tijdkolom is <guilabel>Sessietijd</guilabel>, de tweede <guilabel>Tijd</guilabel>, de derde <guilabel>Totale sessietijd</guilabel> en de vierde de <guilabel>Totale tijd</guilabel>. </para>


</sect2>

<sect2 id="csv-export-history"><title>Geschiedenis naar CSV exporteren</title>

<para>Om de taakgeschiedenis te exporteren, kiest u het menu <menuchoice> <guimenu>Bestand</guimenu> <guisubmenu>Importeren/exporteren</guisubmenu> <guimenuitem>Geschiedenis naar CSV-bestand exporteren...</guimenuitem> </menuchoice> en &karm; toont hetzelfde dialoogvenster als hierboven.</para>

<para>Voer de bestandsnaam in waarnaar u de data wilt exporteren, en kies een datumbereik waarvan u de taakgeschiedenis wilt. Wijzig de andere instellingen indien nodig. Klik op de knop <guibutton>Exporteren</guibutton> en &karm; exporteert de taakgeschiedenis voor alle taken naar het gekozen bestand.</para>

<para>Hier is een voorbeeld van het uitvoerformaat:</para>

<literallayout><computeroutput>
Taakgeschiedenis
Van dinsdag 06 juli 2004 tot dinsdag 13 juli 2004
Afgedrukt op: 2004-07-13 18:10
2004-07-06,2004-07-07,2004-07-08,2004-07-09,2004-07-10,2004-07-11,2004-07-12,2004-07-13,
,,,,,,,,0.00,"kde"
,,1.77,3.23,1.73,,1.37,0.82,8.95,,"karm"
,,,,,,,,0.00,,,"3.2 plan"
,1.13,,,,,,,1.13,,,"bugs"
,,,,,,,,0.00,,,"wijzigingen - vertalingen"
,,,,,,,,0.00,,,"tijdrapportt"
,,,,,,,,0.00,,"kopete"
,,,,,,,,0.00,,"promo"
,,,,,,,,0.00,,"web-dingen"
</computeroutput>
</literallayout>

<para>De eerste drie regels geven aan wanneer het rapport gegenereerd is en voor welk datumbereik. De vierde regel is een komma-gescheiden lijst met de datums in het bereik in ISO 8601 formaat (jjjj-mm-dd). Alle volgende rijen geven de tijd weer die per taak gelogd is. De laatste numerieke kolom is het rijtotaal over alle dagen. De taaknaam wordt afgedrukt na de totaalkolom en is ingesprongen om taak-/subtaakrelaties aan te geven. Namen van topniveau taken verschijnen in de eerste kolom na het totaal.</para>

</sect2>
</sect1>

</chapter>

<chapter id="interface">
<title>Het uiterlijk van &karm;</title>

<para>Het hoofdvenster van &karm; bestaat uit de volgende onderdelen: menubalk, werkbalk, taak- en tijdvak en een statusbalk.</para>

<screenshot>
<screeninfo>Het venster van &karm;</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="karm.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Het venster van &karm;</phrase>
          </textobject>
        </mediaobject>
</screenshot>

<sect1 id="main-window">
<title>Het taak- en tijdvak</title>

<para>De verschillende taken worden in dit vak weergegeven, tezamen met de tijd die aan deze taak is besteed. Zowel de tijd van de sessie als de totaal besteedde tijd. Taken die op dit moment bijgehouden worden hebben een klokje bij de sessietijd staan.</para>

<para>Voor iedere taak kunnen er subtaken gecreërd worden. Door het plus- en minteken voor de hoofdtaak kan de weergave van de subtaken aan- en uitgezet worden. De totale tijd van een hoofdtaak is de tijd van de taak zelf tezamen met de tijden van de subtaken.</para>

</sect1>

<sect1 id="menus">
<title>De menubalk van &karm;</title>
<sect2>
<title>Het menu <guimenu>Bestand</guimenu></title>

<variablelist>
<varlistentry>
<term>
<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo> </shortcut> <guimenu>Bestand</guimenu> <guimenuitem>Opslaan</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Bewaart de huidige taken en subtaken, met de bijbehorende tijden</action></para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo> </shortcut> <guimenu>Bestand</guimenu> <guimenuitem>Afdrukken</guimenuitem> </menuchoice></term>
<listitem><para>Drukt het &karm;-scherm af</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Bestand</guimenu> <guimenuitem>Nieuwe sessie starten</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Zet</action> alle sessietijden op nul</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Bestand</guimenu> <guimenuitem>Alle tijden resetten</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Zet</action> alle tijden op nul</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Bestand</guimenu> <guisubmenu>Importeren/exporteren</guisubmenu> <guimenuitem>Oud "plat" bestand importeren...</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Importeert</action> bestanden in het oude &karm;-formaat (&karm; slaat nu in het iCalendar-formaat op).</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Bestand</guimenu> <guisubmenu>Importeren/exporteren</guisubmenu> <guimenuitem>Taken uit planner importeren...</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Importeer</action> een imendio planner-project (zie <ulink url="http://planner.imendio.org">planner.imendio.org</ulink>). Alle taken, subtaken en de vlag "voltooid" worden geïmporteerd uit een .planner-bestand. U kunt ze importeren als een subtaak door een subtaak te creëren, deze geselecteerd te laten en dan te importeren. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice><guimenu>Bestand</guimenu> <guisubmenu>Importeren/exporteren</guisubmenu> <guimenuitem>Naar CSV-bestand exporteren...</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Exporteer</action> <guilabel>Totale sessietijd</guilabel>, <guilabel>Sessietijd</guilabel>, <guilabel>Tijd</guilabel> en <guilabel>Totale tijd</guilabel> naar een tekstbestand.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Bestand</guimenu> <guisubmenu>Importeren/exporteren</guisubmenu> <guimenuitem>Geschiedenis naar CSV-bestand exporteren...</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Exporteer</action> taakgeschiedenis naar een tekstbestand. </para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> </shortcut> <guimenu>Bestand</guimenu> <guimenuitem>Totalen kopiëren naar klembord</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Kopieert</action> de huidige totaaltijd van de taak of alle taken naar het &kde;-klembord</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;&Alt;<keycap>C</keycap></keycombo> </shortcut> <guimenu>Bestand</guimenu> <guimenuitem>Geschiedenis kopiëren naar klembord</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Kopieert</action> de dagelijkse sessietijden voor een gegeven periode naar het &kde;-klembord</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> </shortcut> <guimenu>Bestand</guimenu> <guimenuitem>Afsluiten</guimenuitem> </menuchoice></term>
<listitem>
<para><action>Sluit</action> &karm; af</para>
</listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title>Het menu <guimenu>Klok</guimenu></title>

<variablelist>
<varlistentry>
<term>
<menuchoice><shortcut><keycap>S</keycap></shortcut> <guimenu>Klok</guimenu> <guimenuitem>Starten</guimenuitem> </menuchoice>
</term>
<listitem>
<para><action>Start</action> het bijhouden van de tijd voor de geselecteerde taak</para></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice><guimenu>Klok</guimenu> <guimenuitem>Stoppen</guimenuitem> </menuchoice>
</term>
<listitem>
<para><action>Stopt</action> het bijhouden van de tijd voor de geselecteerde taak</para></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice><shortcut><keycap>&Esc;</keycap></shortcut> <guimenu>Klok</guimenu> <guimenuitem>Alle tijden stoppen</guimenuitem> </menuchoice>
</term>
<listitem><para><action>Stopt</action> het bijhouden van de tijd voor alle taken</para></listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>Het menu <guimenu>Taak</guimenu></title>

<variablelist>
<varlistentry>
<term>
<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo> </shortcut> <guimenu>Taak</guimenu> <guimenuitem>Nieuw</guimenuitem> </menuchoice>
</term>
<listitem><para><action>Voegt</action> een nieuwe taak <action>toe</action></para></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice><shortcut> <keycombo action="simul">&Ctrl;&Alt;<keycap>N</keycap></keycombo> </shortcut> <guimenu>Taak</guimenu> <guimenuitem>Nieuwe Subtaak</guimenuitem> </menuchoice>
</term>
<listitem>
<para><action>Voegt</action> een nieuwe subtaak <action>toe</action> </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice><shortcut> <keycap>Del</keycap> </shortcut> <guimenu>Taak</guimenu> <guimenuitem>Verwijderen</guimenuitem> </menuchoice>
</term>
<listitem>
<para><action>Verwijdert</action> de geselecteerde taak of subtaak</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo> </shortcut> <guimenu>Taak</guimenu> <guimenuitem>Wijzigen</guimenuitem> </menuchoice>
</term>
<listitem>
<para><action>Wijzigt de naam of de tijden</action> van de huidige taak</para><para>Er zijn twee manieren waarop de tijden gewijzigd kunnen worden. Bij "Absolute tijd bewerken" kunnen de tijd en de sessietijd onafhankelijk van elkaar bewerkt worden. Bij "Relatieve tijd bewerken" is het mogelijk tijd bij de huidige sessie en totaaltijd op te tellen of af te trekken.</para><para>Het keuzevakje <guilabel>Automatisch volgen</guilabel> maakt het mogelijk om de klok automatisch te starten en te stoppen wanneer naar een bepaalde &kde;-desktop geschakeld wordt.</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2>
<title>Het menu <guimenu>Instellingen</guimenu></title>
<variablelist>


<varlistentry>
<term>
<menuchoice><guimenu>Instellingen</guimenu> <guimenuitem>Sneltoetsen instellen...</guimenuitem> </menuchoice>
</term>
<listitem><para><action>Opent</action> een dialoogvenster waarin u de sneltoetsen aan kunt passen</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice><guimenu>Instellingen</guimenu> <guimenuitem>KArm instellen...</guimenuitem> </menuchoice>
</term>
<listitem><para><action>Opent</action> een dialoogvenster waarin u &karm; kunt instellen</para>

<para>Het venster bevat drie tabbladen. Bij <guilabel>Gedrag</guilabel> kunt u een waarschuwing voor inactiviteit opgeven en een waarschuwing voor het verwijderen van een verzameling taken, bij <guilabel>Weergave</guilabel> kunt u aangeven welke kolommen er getoond worden in het hoofdvenster, en <guilabel>Opslag</guilabel> geeft aan waar de gegevens moeten worden opgeslagen, of de gegevens automatisch moeten worden opgeslagen en hoe vaak.</para> </listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2>
<title>Het menu <guimenu>Help</guimenu></title>
&help.menu.documentation; </sect2>

</sect1>

<sect1 id="tool-bar">
<title>De werkbalk</title>
<para>De werkbalk bevat pictogrammen voor de volgende acties:</para>

<note><para>(De functionaliteit is overigens identiek aan de opties uit het menu)</para></note>

<itemizedlist>
<listitem><para><guiicon>Starten</guiicon></para></listitem>
<listitem><para><guiicon>Stoppen</guiicon></para></listitem>
<listitem><para><guiicon>Nieuwe taak</guiicon></para></listitem>
<listitem><para><guiicon>Nieuwe subtaak</guiicon></para></listitem>
<listitem><para><guiicon>Verwijderen</guiicon></para></listitem>
<listitem><para><guiicon>Wijzigen</guiicon></para></listitem>
</itemizedlist>

</sect1>

<sect1 id="status-bar">
<title>De statusbalk</title>

<para>Laat de totaal verstreken tijd in de huidige sessie zien.</para>
</sect1>

</chapter>

<chapter id="credits">

<title>Dankbetuigingen en licentie</title>

<para>&karm; </para>

<para>Programma copyright: </para>

<itemizedlist>

<listitem><para>1997-2000 Sirtaj Singh Kang <email>taj@kde.org</email>.</para>  </listitem> 

<listitem><para>2001-2002 Tomas Pospisek <email>tpo_deb@sourcepole.ch</email></para></listitem>

<listitem><para>2003-2004 Mark Bucciarelli<email>mark@hubcapconsulting.com</email></para></listitem>

</itemizedlist>

<para>Bijdragen door (in alfabetische volgorde)</para>
<itemizedlist>
<listitem><para>Allen Winter <email>winterz@verizon.net</email></para></listitem>
<listitem><para>David Faure <email>faure@kde.org</email></para></listitem>
<listitem><para>Espen Sand <email>espen@kde.org</email></para></listitem>
<listitem><para>Gioele Barabucci <email>gioele@gioelebarabucci.com</email></para></listitem>
<listitem><para>Jan Schaumann <email>jschauma@netmeister.org</email></para></listitem>
<listitem><para>Jesper Pedersen <email>blackie@ifad.dk</email></para></listitem>
<listitem><para>Kalle Dalheimer <email>kalle@kde.org</email></para></listitem>
<listitem><para>Klar&auml;lvdalens Datakonsult AB</para></listitem>
<listitem><para>Mark Bucciarelli <email>mark@hubcapconsulting.com</email></para></listitem>
<listitem><para>Thorsten St&auml;rk <email>dev@staerk.de</email></para></listitem>
<listitem><para>Tomas Pospisek <email>tpo_deb@sourcepole.ch</email></para></listitem>
<listitem><para>Willi Richert <email>w.richert@cox.net</email></para></listitem>
</itemizedlist>

<para>De auteur van &karm; is geinspireerd door de toepassing <application>titrax</application> van Harald Tveit Alvestrand. Het nadeel van die toepassing is echter dat het gebaseerd is op de Xt-toolkit.</para>

<para>Documentatie copyright 2000-2004 Jonathan Singer <email>jsinger@leeta.net</email> en Sirtaj Singh Kang <email>taj@kde.org</email>.</para>
&underFDL; &underGPL; </chapter>

<glossary id="glossary">

<glossentry id="gloss-active-task">
<glossterm>actieve taak</glossterm>
<glossdef><para>Een taak waarvan een timer loopt.</para></glossdef>
</glossentry>

<glossentry id="gloss-dcop">
<glossterm>&DCOP;</glossterm>
<glossdef><para>Het communicatieprotocol dat tussen KDE-processen gebruikt worden. Afkoring van Desktop COmmunication Protocol.</para></glossdef>
</glossentry>

<glossentry id="gloss-desktop">
<glossterm>bureaublad</glossterm>
<glossdef><para>GNU/Linux, FreeBSD en andere systemen die X Windows draaien hebben meerdere bureaubladen. U hebt normaal gesproken vier verschillende bureaubladen. Elk bureaublad kan een eigen verzameling programma's en bestanden weergeven. Als KDE opstart ziet u bureaublad 1. Als u <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> drukt, ziet u bureaublad 2. Met <keycombo action="simul">&Alt;<keycap>F1</keycap></keycombo> brengt u bureaublad 1 terug. </para></glossdef> </glossentry>

<glossentry id="gloss-history">
<glossterm>geschiedenis</glossterm>
<glossdef><para>Als &karm; ingesteld is om geschiedenis bij te houden, wordt elke start- of stopgebeurtenis onthouden. Deze geschiedenis wordt niet gewist als de tijden worden gereset en wordt onthouden totdat de taak wordt verwijderd.</para></glossdef>
</glossentry>

<glossentry id="gloss-session"> <glossterm>sessie</glossterm>
<glossdef><para>Een gebruikergedefinieerd beginpunt voor de sessietimers. Een nieuwe sessie begint als u het menu <menuchoice> <guimenu>Bestand</guimenu> <guimenuitem>Nieuwe sessie starten</guimenuitem> </menuchoice> kiest. Sessiegegevens worden niet opgeslagen als u een nieuwe sessie start. </para></glossdef> </glossentry>

<glossentry id="gloss-system-time"> <glossterm><guilabel>Sessietijd</guilabel></glossterm> <glossdef><para>De tijd die aan de taak is besteed sinds het begin van de sessie.</para></glossdef> </glossentry> 

<glossentry id="gloss-system-tray"> <glossterm>systeemvak</glossterm>
<glossdef><para>Het systeemvak bevindt zich in de balk die standaard onderaan uw scherm verschijnt. In dit systeemvak <inlinemediaobject><imageobject><imagedata fileref="systray.png" format="PNG"/></imageobject></inlinemediaobject> bevindt het &karm;-pictogram zich uiterst rechts.</para></glossdef>
</glossentry>

<glossentry id="gloss-top-level-task">
<glossterm>topniveau-taak</glossterm>
<glossdef><para>Een taak zonder bovenliggende taken.</para></glossdef>
</glossentry>

<glossentry id="gloss-total-session-time"> <glossterm><guilabel>Totale sessietijd</guilabel></glossterm> <glossdef><para>De tijd die aan de taak en alle subtaken ervan besteed is sinds het begin van de sessie.</para></glossdef> </glossentry>
<glossentry> <glossterm><guilabel>Tijd</guilabel></glossterm>
<glossdef><para>De tijd die aan de taak is besteed sinds alle tijden gereset zijn.</para></glossdef> </glossentry> 

<glossentry id="gloss-total-time"> <glossterm><guilabel>Totale tijd</guilabel></glossterm>
<glossdef><para>De tijd die aan de taak en alle subtaken ervan is besteed sinds alle tijden gereset zijn.</para></glossdef> </glossentry> 

</glossary>

<appendix id="installation">
<title>Installatie</title>

<sect1 id="getting-karm">
<title>&karm; verkrijgen</title>
&install.intro.documentation; &install.compile.documentation; </sect1>

</appendix>

<appendix id="dcopappendix"><title>&DCOP;-interface</title>

<refentry id="dcop-version">
<refmeta>
<refentrytitle>version</refentrytitle>
</refmeta>
<refnamediv>
<refname>version</refname>
<refpurpose>Retourneer de versie van &karm;</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>TQString version()
</synopsis>
</refsynopsisdiv>
<refsect1>
<title>Beschrijving</title>
<para><function>version()</function> is een &DCOP;-aanroep die &karm;'s versienummer retourneert; bijvoorbeeld 1.5.0. Het versienummer wordt geretourneerd als een tekenreeks in het standaard GNU-formaat hoofdversie.subversie.bugfix.</para>
</refsect1>
</refentry>

<refentry id="dcop-quit">
<refmeta>
<refentrytitle>quit</refentrytitle>
</refmeta>
<refnamediv>
<refname>quit</refname>
<refpurpose>Retourneer &karm;'s afsluiting.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>TQString quit()
</synopsis>
</refsynopsisdiv>
<refsect1>
<title>Beschrijving</title>
<para><function>quit()</function> is een &DCOP;-aanroep die een manier biedt waarmee een extern programma &karm; beschaafd kan afsluiten. </para>
</refsect1>
</refentry>

<refentry id="dcop-hastodo">
<refmeta>
<refentrytitle>hastodo</refentrytitle>
</refmeta>
<refnamediv>
<refname>hastodo</refname>
<refpurpose>Controleer of topniveau-taak bestaat.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>TQString hastodo(TQString taskname)
</synopsis>
<refsect2>
<title>Parameters</title>
<variablelist>
<varlistentry>
<term><parameter>taskname</parameter></term>
<listitem>
	<para>De naam van de taak waarnaar gezocht moet worden.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>
<refsect1>
<title>Beschrijving</title>
<para><function>hastodo(TQString taskname)</function> is een &DCOP;-aanroep die een gegeven naam opzoekt. Als deze gevonden wordt, wordt de bijbehorende iCalendar-UID van de taak geretourneerd. Als deze niet gevonden wordt, wordt een lege tekenreeks geretourneerd. </para>
<para>Het iCalendar-bestand dat &karm; momenteel open heeft is het bestand dat doorzocht wordt. Alle taakbomen worden doorzocht, niet alleen topniveau taken. Als meer dan één taak een overeenkomende naam heeft, wordt de eerste geretourneerd.</para>
</refsect1>
</refentry>

<refentry id="dcop-addtodo">
<refmeta>
<refentrytitle>addtodo</refentrytitle>
</refmeta>
<refnamediv>
<refname>addtodo</refname>
<refpurpose>Een nieuwe taak toevoegen.</refpurpose>
</refnamediv>
<refsynopsisdiv>
<synopsis>TQString addtodo(TQString todoname)
</synopsis>
<refsect2>
<title>Parameters</title>
<variablelist>
<varlistentry>
<term><parameter>todoname</parameter></term>
<listitem>
	<para>De naam van de nieuwe taak.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsynopsisdiv>

<refsect1>
<title>Beschrijving</title>
<para><function>addtodo(TQString todoname)</function> is een &DCOP;-aanroep die een nieuwe topniveau-taak aan het huidige bestand toevoegt. De UID van de nieuwe taak wordt geretourneerd. </para>
</refsect1>
</refentry>

</appendix>

&documentation.index; 
</book>