You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
174 lines
4.7 KiB
174 lines
4.7 KiB
<?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>
|