|
|
|
@ -2,6 +2,8 @@
|
|
|
|
|
<!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">
|
|
|
|
|
]>
|
|
|
|
@ -10,9 +12,9 @@
|
|
|
|
|
<title>The &ktimer; Handbook</title>
|
|
|
|
|
|
|
|
|
|
<articleinfo>
|
|
|
|
|
<title>The &ktimer; Handbook</title>
|
|
|
|
|
|
|
|
|
|
<authorgroup>
|
|
|
|
|
<author><firstname>A. L.</firstname><surname>Spehr</surname></author>
|
|
|
|
|
<author>&tde-authors;</author>
|
|
|
|
|
<!-- TRANS:ROLES_OF_TRANSLATORS -->
|
|
|
|
|
</authorgroup>
|
|
|
|
@ -20,6 +22,10 @@
|
|
|
|
|
<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>
|
|
|
|
@ -36,29 +42,132 @@
|
|
|
|
|
<keywordset>
|
|
|
|
|
<keyword>TDE</keyword>
|
|
|
|
|
<keyword>tdeutils</keyword>
|
|
|
|
|
<keyword>kcharselect</keyword>
|
|
|
|
|
<keyword>ktimer</keyword>
|
|
|
|
|
</keywordset>
|
|
|
|
|
|
|
|
|
|
</articleinfo>
|
|
|
|
|
|
|
|
|
|
<sect1 id="apologies">
|
|
|
|
|
<title>We Apologize</title>
|
|
|
|
|
<para>No documentation has yet been written for &ktimer;.</para>
|
|
|
|
|
<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>If you need help, please check <ulink url="http://www.trinitydesktop.org">The &tde;
|
|
|
|
|
web site</ulink>, submit questions to the <ulink url="http://www.trinitydesktop.org/mailinglist.php">
|
|
|
|
|
&tde; mail lists</ulink>, or file a bug report at the <ulink url="http://bugs.trinitydesktop.org/">
|
|
|
|
|
&tde; bug tracker</ulink>.</para>
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
</sect1>
|
|
|
|
|
|
|
|
|
|
<sect1 id="credits">
|
|
|
|
|
<title>Credits and License</title>
|
|
|
|
|
|
|
|
|
|
<para>
|
|
|
|
|
&ktimer;
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
<para>If you are interested in helping, please consider writing the help file.
|
|
|
|
|
Submitting a basic text file is acceptable as the &tde-team; will convert the text.</para>
|
|
|
|
|
<!--List all the copyright holders here-->
|
|
|
|
|
<para>Program Copyright 2001 &Stefan.Schimanski;</para>
|
|
|
|
|
|
|
|
|
|
<para>Thank you for helping and thank you for your patience.</para>
|
|
|
|
|
<para>Documentation Copyright 2008 &A.L.Spehr;</para>
|
|
|
|
|
|
|
|
|
|
&underFDL;
|
|
|
|
|
&underGPL;
|
|
|
|
|
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
|
|
|
|
|
&underFDL; <!-- FDL: do not remove -->
|
|
|
|
|
&underGPL; <!-- GPL License -->
|
|
|
|
|
|
|
|
|
|
</sect1>
|
|
|
|
|
|
|
|
|
|
&documentation.index;
|
|
|
|
|
</article>
|
|
|
|
|