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
|
<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY kappname "&ktimer;">
<!ENTITY package "tdeutils">
<!ENTITY Stefan.Schimanski "<personname><firstname>Stefan</firstname><surname>Schimanski</surname></personname>">
<!ENTITY A.L.Spehr "<personname><firstname>A. L.</firstname><surname>Spehr</surname></personname>">
<!ENTITY % English "INCLUDE">
<!ENTITY % addindex "IGNORE">
]>
<article lang="&language;">
<title>The &ktimer; Handbook</title>
<articleinfo>
<authorgroup>
<author><firstname>A. L.</firstname><surname>Spehr</surname></author>
<author>&tde-authors;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
<releaseinfo>&tde-release-version;</releaseinfo>
<date>Reviewed: &tde-release-date;</date>
<copyright>
<year>2010</year>
<holder>A. L. Spehr</holder>
</copyright>
<copyright>
<year>&tde-copyright-date;</year>
<holder>&tde-team;</holder>
</copyright>
<!-- <legalnotice>&FDLNotice;</legalnotice> -->
<abstract>
<para>
&ktimer; is a simple countdown timer.
</para>
</abstract>
<keywordset>
<keyword>TDE</keyword>
<keyword>tdeutils</keyword>
<keyword>ktimer</keyword>
</keywordset>
</articleinfo>
<sect1 id="introduction">
<title>Introduction</title>
<para>&ktimer; allows you to enter several tasks and to set a timer for each of them.
When the timer reaches zero, the task is executed. The timers for each task can be started,
stopped, changed, or looped.</para>
</sect1>
<sect1 id="using-ktimer">
<title>Using &ktimer;</title>
<screenshot>
<screeninfo>Here's a screenshot of &ktimer; when you start it for the first
time</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="main.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>&ktimer; main window</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>To start, first add a task by selecting <guibutton>New</guibutton>. Then type the
command you wish to execute into the <guilabel>Command line:</guilabel> box. You can then
adjust the settings, or start the timer countdown. When the time is up, the command
will be run.</para>
<screenshot>
<screeninfo>Here's a screenshot of &ktimer; after you have told it to run &konqueror;.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="first.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>add a task</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>Let's use &konqueror; as an example. By default, &konqueror; will start in 100 seconds
after the timer countdown is started.</para>
<screenshot>
<screeninfo>Here it is counting down: in 56 seconds &konqueror; will be run.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="running.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>56 seconds to go</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>Now let's start the task. Here it has been running for a bit and is partway through the
countdown. In 56 seconds, &konqueror; will be started.</para>
<para>See that sliding bar? You can use it to quickly increase or decrease the amount of time
on a task.</para>
<screenshot>
<screeninfo>Let's add a second task.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="two_at_once.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>start another &konqueror;, you can never have too many!</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>Now two &konqueror;s are scheduled to be run. The top one will be run in 20 seconds,
and the bottom one is currently stopped. You can add more commands. While you can never have
too many &konqueror;s, you probably want to use other executables. Your own shell script, perhaps.</para>
</sect1>
<sect1 id="settings">
<title>Settings</title>
<para>
<variablelist>
<varlistentry>
<term><guibutton>New</guibutton></term>
<listitem><para><action>Adds a new task.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><guibutton>Remove</guibutton></term>
<listitem><para><action>Removes the current task.</action></para></listitem>
</varlistentry>
<varlistentry>
<term><guibutton>Help</guibutton></term>
<listitem><para><action>Opens the Handbook.</action></para></listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
<sect1 id="credits">
<title>Credits and License</title>
<para>
&ktimer;
</para>
<!--List all the copyright holders here-->
<para>Program Copyright 2001 &Stefan.Schimanski;</para>
<para>Documentation Copyright 2008 &A.L.Spehr;</para>
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
&underFDL; <!-- FDL: do not remove -->
&underGPL; <!-- GPL License -->
</sect1>
</article>
|
