<?xml version="1.0" standalone="no"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" 
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<!ENTITY version "2.2.3">
]>

<article id="index" lang="en"> <!-- please do not change the id-->

  <articleinfo>
    <title>GNOME Time Tracker Manual</title>
    <copyright>
      <year>1997-2000</year>
      <holder>Eckehard Berns</holder>
    </copyright>
    <copyright>
      <year>2000</year>
      <holder>Ximian, Inc.</holder>
    </copyright>
    <copyright>
      <year>2001</year>
      <holder>Linas Vepstas &lt;linas@linas.org&gt;</holder>
    </copyright>
    <copyright>
      <year>2007</year>
      <holder>Goedson Paixão &lt;goedson@debian.org&gt;</holder>
    </copyright>

    <legalnotice id="legalnotice">
      <para>Permission is granted to copy, distribute and/or modify this document
        under the terms of the <ulink type="help"
        url="ghelp:fdl"><citetitle>GNU Free Documentation
            License</citetitle></ulink>, Version 1.1 or any later version 
        published by the Free Software Foundation with no Invariant Sections, 
        no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license
        can be found <ulink type="help" url="ghelp:fdl">here</ulink>.
      </para>
      <para>Many of the names used by companies to distinguish their products and
        services are claimed as trademarks. Where those names appear in any
        GNOME documentation, and those trademarks are made aware to the members
        of the GNOME Documentation Project, the names have been printed in caps
        or initial caps.
      </para>
    </legalnotice>

    <releaseinfo> 
         This is version 2.2.3 of the GNOME Time Tracker manual.
     </releaseinfo> 
<!-- this is version of manual, not application --> 
  </articleinfo>

<!-- =============Document Body ============================= -->



<!-- =============Introduction ============================= -->
  <sect1 id="introduction">
      <title>Introduction</title> 
    <sect2 id="whatis">
    <title>What is GNOME Time Tracker?</title>
    <para>
      <application>GNOME Time Tracker</application> 
      is a combination stop-watch, diary, to-do list tracker and 
      consultant billing system.  You can measure the amount of time you
      spend on a task, associate a memo with it, set a billing rate, print
      an invoice, as well as track the status of other projects.

      You do not need to learn or use every feature in
      <application>GNOME Time Tracker</application>
      to be productive: it is meant to be quite usable
      without requiring a deep study of the documentation.
      But once you have learned to use 
      <application>GNOME Time Tracker</application>
      effectively, it can be as effective as any desktop organizer.
    </para>
    <para>
     Features include:
     <itemizedlist>
        <listitem>
          <para>
    <emphasis>Basic Stop-Watch Support</emphasis>
    At its core, GTT is a fancy stop-watch: you can click on
    an icon to start and stop one of any number of timers.
    It is the times measured by these clocks that make up
    the core data that GTT works with.
          </para> 
        </listitem>

        <listitem>
          <para>
    <emphasis>Project Planning Support</emphasis>
    Well, OK, "project planning" may be an overstatement.  But GTT
    does provide basic to-do list support, including the ability
    to rank by importance and urgency, specify expected start/stop
    times, state the project status, and estimate the amount of
    time needed to complete the project.
          </para> 
        </listitem>

        <listitem>
          <para>
    <emphasis>Basic Billing/Invoicing Support</emphasis>
    GTT has the infrastructure necessary for storing price and
    billing information.  This allows billing invoices to be generated.
     Tasks can be marked as billable, non-billable, on-hold, or
     free-of-charge. Billing rates for regular, overtime,
     double-overtime or flat-fee can be set per task.
     (Fancier-looking invoices still needed).
          </para> 
        </listitem>

        <listitem>
          <para>
    <emphasis>Sub-Project Support</emphasis>
    New projects can be listed as sub-projects of other projects.  
	The time totals will show the total including sub-projects.  
	The Hierarchical tree can be expanded / collapsed to simplify
    viewing. The tree can be re-arranged by dragging-n-dropping
    projects. 
          </para> 
        </listitem>

        <listitem>
          <para>
    <emphasis>Simple Navigation</emphasis>
	
     Up/down keys can be used to move up &amp; down on the project
	list. The left/right arrow keys expand/collapse a sub-project
	list. Hitting return starts/stops the timer for the selected
	project.
          </para> 
        </listitem>

        <listitem>
          <para>
    <emphasis>Log Journal</emphasis>
    A journal showing explicit start and stop times is maintained.
     Blocks of time can be annotated with memos.  The journal can be
     exported as an html page.
          </para> 
        </listitem>

        <listitem>
          <para>
    <emphasis>Auto-merge/cleanup of Short Intervals Support</emphasis>
    Extremely short intervals (the length is configurable) are
    automatically removed from the logs.  Slightly longer but still
    short intervals are auto-merged into nearby neighbors. Short gaps
    between intervals are coalesced as well.  You can specify a time
    period of 0 seconds to turn these features off.
          </para> 
        </listitem>

        <listitem>
          <para>
    <emphasis>HTML-based GUI</emphasis>
    The journal GUI is based on extended html pages.  If you know
     HTML, then you can create customized report pages.  Particularly
     handy for slapping the company logo and mailing address on the top
     of the page, and generating a unique, custom look.
     User-defined reports (contained in ghtml files) can be added to the
     menus by typing in the filename into the 'new report' GUI dialog.
     Typically, a 'user-defined report' is one with customized layout,
     maybe a logo added, all-spiffed up &amp; such.
          </para> 
        </listitem>

        <listitem>
          <para>
    <emphasis>Inactivity Timeout</emphasis>
    GTT has an inactivity timeout, that will stop the timer after some
    period of inactivity on both the mouse and keyboard. This period
    can be configured (or disabled) and the user can decide what to
    do with the inactivity period when he/she returns (credit all or
    part of it to the active project or consider as if the timer was
    inactive for the whole period).
          </para> 
        </listitem>

        <listitem>
          <para>
    <emphasis>Shell Commands</emphasis>
    A shell command can be executed whenever a project timer is
    started or stopped.
          </para> 
        </listitem>

        <listitem>
          <para>
    <emphasis>Scheme Extension Language</emphasis>
    Scheme (guile) is used as an extension language, although scheme
     support is currently limited to report generation.
          </para> 
        </listitem>

        <listitem>
          <para>
    <emphasis>XML File Format</emphasis>
    All project and journal data are stored in an XML file format.
    This should simplify future interoperability and data access concerns.
          </para> 
        </listitem>
        <listitem>
          <para>
    <emphasis>Multi-Language Support</emphasis>
    The basic GTT menus have been translated to dozens of languages.
    Translations are still needed for the manual.
          </para> 
        </listitem>
		<listitem>
		  <para>
			<emphasis>
			  DBus support
			</emphasis>
			GTT uses DBus to expose some of its functionality. It is
			currently possible to start/stop the timer or save/reload
			the data file by sending DBus messages. A shell script
			named <command>gnotime-remote</command> is provided to
			ease this remote controlling of
			GTT. See <xref linkend="gnotime_remote"/> for details on
			how to use <command>gnotime-remote</command>.
		  </para>
		</listitem>
    </itemizedlist>

    </para>
    <para>
     <application>GNOME Time Tracker</application> started as part of
      the package <filename>gnome-utils</filename>, which is a
      part of the GNOME desktop environment. Now it's maintained as a
      separate application and is hosted
      at <ulink url="https://sourceforge.net/projects/gttr/">GnoTime
      Sourceforge Project</ulink>. This document describes version
      &version; of <application>GNOME Time Tracker</application>.
    </para>

    <para><application>GNOME Time Tracker</application> can be started by
      selecting <guimenuitem>Time Tracking Tool</guimenuitem> from
      the <guisubmenu>Office</guisubmenu> submenu of
      the <guimenu>Applications</guimenu>, or by running the command
      <command>gnotime</command> on the command line.
    </para>
  </sect2>
</sect1>


<sect1 id="usage"> 
   <title>Using GNOME Time Tracker</title>
   <sect2 id="working">
      <title>Working with GNOME Time Tracker</title>
      <para> <application>GNOME Time Tracker</application> can be
    used to keep track of the amount of time you spend on different
    things you do.  You do this by defining several projects
    and then, as you go through the day, telling
    <application>GNOME Time Tracker</application> which
    project you're working on.  It will tell you how much time you spend
    on each project each day, the total time spent on each project,
    and the amount of time logged on all projects each day.
    </para>

    <para>
      Unfortunately, <application>GNOME Time Tracker</application> 
      isn't particularly smart: it won't turn the timer off for you if you 
      take a break for a quick game of solitaire and it turns into several hours of distraction.
      The inactivity timer will notice that you are still using the keyboard and mouse;
      it does not know that it's just solitaire.
      When you stop work on a project, be sure to turn off
      the timer by clicking the <guibutton>Timer</guibutton> button or using <guimenuitem>
      Stop</guimenuitem> from the <guimenu>Timer</guimenu> menu.  As long as you remember to do 
      this, your work will be recorded effectively.  You can, however, alter the times from the
      <interface>Activity Report</interface> if they are incorrect.
      See <xref linkend="activity_report" /> for more information. 
    </para>
 
<para id="timer"><application>GNOME Time Tracker</application> can inform you about your
      project times in several ways.
      For each project, it maintains a timer for the amount 
      of time you have spent on the project today, this week, this month, this year, 
      and how much time you have spent on it total.
      In addition,<application>GNOME Time Tracker</application> counts how much time you have spent
      on all projects in the current day.  This last figure is the one displayed in the lower left hand
      corner of the status bar.
      </para>

<para>
        When you first start <application>GNOME Time Tracker</application>, you see
        the <interface>Main window</interface>, as shown in 
  <xref linkend="mainwindowfig"/>.
<!-- ==============Figure=================================== -->
        <figure id="mainwindowfig" xreflabel="GNOME Time Tracker Main Window">
          <title>GNOME Time Tracker Main Window</title>
          <screenshot>
            <screeninfo>GNOME Time Tracker Main Window, with a project selected</screeninfo>
      <graphic fileref="figures/gtt_mainwin.png" />
          </screenshot>
        </figure>
<!-- ==============End of Figure=================================== -->
      

The main window consists of five areas. There is a menu bar (see <xref linkend="menubar"/>) and
a toolbar (see <xref linkend="toolbar"/>) at the top of the window, 
a status bar (see <xref linkend="statusbar"/>) at the bottom of the window,
and between the toolbar and the status bar,
a scrollable project list (see <xref linkend="projects-navigating"/>) and a
resizable notes area (see <xref linked="notesarea"/>).
      When you start <application>GNOME Time Tracker</application> for
the first time, the project list area will show you an empty list.
   </para>


   <tip>
   <para>
      You can customize the appearance of the main window in the 
      <interface>preferences dialog</interface>. See <xref linkend="preferences"/>
      for more information about changing the toolbar, project list, and time display.
   </para>
  </tip>
</sect2>


      <!-- =========Subsection=========================== -->   
    <sect2 id="menubar" xreflabel="Menus">
      <title>Menus</title>
   <para>
      Nearly all menu items in <application>GNOME Time Tracker</application> have a shortcut or
      accelerator key.  Shortcuts appear right after the
      name of the menu item on the menus.
   </para>

   <para>
       The menu bar consists of six menus: <guimenu>File</guimenu>,
       <guimenu>Projects</guimenu>, <guimenu>Settings</guimenu>, <guimenu>Reports</guimenu>, <guimenu>Timer</guimenu> and <guimenu>Help</guimenu>.
   </para>

      <!-- =========List=========================== -->
      <variablelist>
        <varlistentry> 
          <term><guimenu>File</guimenu></term>
            <listitem>
              <para>
                 This menu contains the following commands:
              </para>
            <para>
                <menuchoice>
                  <shortcut>
                    <keysym>
                      Ctrl-E
                    </keysym>
                    </shortcut>
                    <guimenuitem>Export Tasks</guimenuitem>
                  </menuchoice>
               &mdash; Saves a file containing information about all the tasks
              for the currently selected project.
              </para>

              <para>
              <menuchoice>
                <shortcut><keysym>Ctrl-P</keysym>
                </shortcut>
                <guimenuitem>Export Projects</guimenuitem>
              </menuchoice>
               &mdash; Saves a file containing information about all top-level projects.
              </para>

              <para>
              <menuchoice>
                <shortcut><keysym>Ctrl-Q</keysym>
                </shortcut>
                <guimenuitem>Quit</guimenuitem>
              </menuchoice>
              &mdash; Closes <application>GNOME Time
              Tracker</application>, saving projects data and updating
              the logfile if a logfile is in use.
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guimenu>Projects</guimenu></term>
          <listitem>
            <para>
              This menu contains the following commands:
			</para>
            <para>
               <menuchoice>
                    <shortcut>
                      <keysym>
                        Ctrl-N
                      </keysym>
                    </shortcut>
                    <guimenuitem>
                   New ...
                    </guimenuitem>
                 </menuchoice>
                 &mdash; brings up the <interface>New Project</interface> dialog so you
                 can create a new project.
            </para>
			<para>
              <menuchoice>
                 <shortcut><keysym>Ctrl-D</keysym></shortcut>
                <guimenuitem>Cut</guimenuitem>
              </menuchoice>
              &mdash; Removes an item from the project list, saving it in
              memory if you want to paste it back in somewhere else.
              </para>

              <para>
                 <menuchoice>
                    <shortcut><keysym>Ctrl-F</keysym></shortcut>
                    <guimenuitem>Copy</guimenuitem>
                 </menuchoice>
                &mdash; Duplicates a selected project, copying it to memory.
                </para>
                <para>
                   <menuchoice>
                      <shortcut><keysym>Ctrl-G</keysym></shortcut>
                      <guimenuitem>Paste</guimenuitem>
                   </menuchoice>
                     &mdash; Places the project in memory onto the task list.  Projects are inserted
                     before the selected item.  If no item is selected, they will appear at the bottom of the list.
                </para>
                <para>
                    <menuchoice>
                       <guimenuitem>Edit Times</guimenuitem>
                    </menuchoice>
                      &mdash; Opens the <interface>Activity Report</interface> for the
                      currently selected project so that you can edit
                      the time intervals currently saved for it.
                 </para>

                 <para>
                 <menuchoice>
                    <guimenuitem>Properties...</guimenuitem>
                 </menuchoice>
                 &mdash; This selection opens the <interface>Properties</interface> dialog for
                 the currently selected project.  Here you can view and edit the name,
                 description, planning and billing data for your project.  Note that this is the same action
     as the <guibutton>Props</guibutton> button on the toolbar.  See
                 <xref linkend="projects-editing"/> for more
                 information. 
                 </para>
            </listitem>
        </varlistentry>

        <varlistentry> 
            <term><guimenu>Settings</guimenu></term>
            <listitem>
               <para>
                 This menu contains only one command:
                 <guimenuitem>Preferences</guimenuitem>, which launches the
           <interface>Preferences Dialog</interface>.  See <xref linkend="preferences"/>
                 for more information.
               </para>
             </listitem>
        </varlistentry>

        <varlistentry>
           <term><guimenu>Timer</guimenu></term>
           <listitem>
             <para>
               This menu contains the following commands:
			 </para>
			 <para>
               <menuchoice>
                 <shortcut><keysym>Ctrl-S</keysym></shortcut>
                <guimenuitem>Start</guimenuitem>
               </menuchoice>
              &mdash; Starts the timer on the selected project.
             </para>

             <para>
               <menuchoice>
                <shortcut><keysym>Ctrl-W</keysym></shortcut>
                <guimenuitem>Stop Timer</guimenuitem>
               </menuchoice>
               &mdash; Stops the timer.
             </para>
  
              <para>
                <menuchoice>
                <shortcut><keysym>Ctrl-T</keysym></shortcut>
                <guimenuitem>Toggle Timer</guimenuitem>
              </menuchoice> 
                &mdash; This item toggles the timer on or off.
              </para>
            </listitem>
        </varlistentry>
        <varlistentry>
          <term><guimenu>Reports</guimenu></term>
          <listitem>
            <para>
              This menu contains various predefined reports and
              may have new items added by the user. See
              <xref linkend="reports"/> for a list of the
              predefined reports.
			</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term><guimenu>Help</guimenu></term>
          <listitem>
            <para>
              This menu contains the following commands:
			</para>
			<para>
              <menuchoice><guimenuitem>Manual</guimenuitem></menuchoice>
                   &mdash; Shows this manual.
            </para>
            <para>
              <menuchoice><guimenuitem>About</guimenuitem></menuchoice>
              &mdash; Displays copyright and author information for
              <application>GNOME Time Tracker</application>.
            </para>
          </listitem>
        </varlistentry>
      </variablelist>
      <!-- =========End of list=========================== -->
        </sect2>

        <sect2 id="toolbar" xreflabel="The Toolbar">
        <title>The Toolbar</title>
        <para>
        The toolbar is another way to speed up your most frequently performed operations in
        <application>GNOME Time Tracker</application>.  Each icon in it is a shortcut to
        one of the menu functions.  By default, the buttons are:
        <itemizedlist>
        <listitem>
          <para>
            <guibutton>New</guibutton>,which opens the <interface>New Project</interface>dialog.
          </para> 
        </listitem>

        <listitem>
          <para>
            <guibutton>Props</guibutton>,which opens the <interface>Properties</interface> dialog.
          </para>
        </listitem>

        <listitem>
          <para>
            <guibutton>Timer</guibutton>, which toggles the timer between on and off.
          </para>
        </listitem>
        <listitem>
          <para>
            <guibutton>Prefs</guibutton>,
             which opens the <interface>Preference</interface> dialog.
          </para>
        </listitem>
        <listitem>
           <para>
              <guibutton>Manual</guibutton>, which opens this manual.
           </para>
        </listitem>

        <listitem>
          <para>
             <guibutton>Quit</guibutton>, which quits <application>GNOME Time Tracker</application>.
          </para>
        </listitem>
     </itemizedlist>
You can choose which functions appear in the toolbar from the <interface>Preferences</interface> dialog.
See <xref linkend="preferences"/> for more information.
        </para>
        </sect2>


	<sect2 id="projects" xreflabel="Manipulating projects">
	  <title>Manipulating projects</title>
	  <para>
		Projects are the central concept in working
		with <application>GNOME Time Tracker</application>. In this
		section we will learn what we can do with projects
		in <application>GNOME Time Tracker</application> and how to do
		it.
	  </para>

	  <sect3 id="projects-creating" xreflabel="Creating new projects">
		<title>Creating new projects</title>
		<para>
		  You need to have projects to work with <application>GNOME
		  Time Tracker</application>. So, the first thing you need to
		  learn is how to create new projects.
		</para>
		<para>
		  To create a new project, you must invoke the
		  <xref linkend="new_project_figure"/> by selecting
		  the <guimenuitem>New ...</guimenuitem> item from
		  the <guimenu>Projects</guimenu> menu. Alternatively, you may
		  type Ctrl-N or click on the <interface>New</interface>
		  button in the toolbar.
		</para>

<!-- ==============Figure=================================== -->
        <figure id="new_project_figure" xreflabel="New Project Dialog">
          <title>New Project Dialog</title>
          <screenshot>
            <screeninfo>New Project Dialog</screeninfo>
			<graphic fileref="figures/gtt_new_project.png" />
          </screenshot>
        </figure>
<!-- ==============End of Figure============================= -->

        <para>
		  In the <interface>New Project Dialog</interface>, you just
		  inform the <interface>Project Title</interface> and
		  the <interface>Project Description</interface>. After
		  clicking the <interface>OK</interface> button, the new
		  project will be added to the <interface>Projects
		  List</interface> and you're ready to start working on your
		  new project.
		</para>

	  </sect3>

      <sect3 id="projects-navigating" xreflabel="Navigating through your projects">
		<title>Navigating through your projects</title>
        <para>
          The project list is located in the central area of the
          main window. It shows the list of projects and which
          project is currently selected. Each line corresponds to
          one project, and displays various attributes of that
          project. You may choose which attributes are shown in the
          project list from the <interface>Preferences</interface>
          dialog (see <xref linkend="preferences"/>).
        </para>

        <para>
          You can select a project by clicking on it with the left
          mouse button. Note that you can only have one project
          selected at any given time.
        </para>

		<para>
		  You toggle the timer for a project by double clicking it
		  on the project list. You may, alternatively, select it
		  and click on the <interface>Timer</interface> button in
		  the toolbar or selecting the <guimenuitem>Timer
			Running</guimenuitem> item from
		  the <guimenu>Timer</guimenu> menu.
		</para>

        <para>
          To get a popup menu for a project, click the right mouse
          button on it. If the project wasn't selected, it will now
          receive the selection, and the <guimenu>Project popup</guimenu>
          menu will be displayed.
        </para>
      </sect3>
	  <sect3 id="projects-editing" xreflabel="Editing Project Properties">
		<title>Editing Project Properties</title>
		<para>
		  You may edit the properties of a project by invoking
		  the <interface>Project Properties Dialog</interface> through
		  the <guimenuitem>Properties</guimenuitem> menu item from
		  the <guimenu>Projects</guimenu> menu. This dialog is formed by
		  four tabs
		  named <interface>Project</interface>, <interface>Rates</interface>,
		  <interface>Intervals</interface> and <interface>Planning</interface>.
		</para>
		<para>
		  The <interface>Project</interface> tab, which you see in
		  <xref linkend="props_project_figure"/>, is where you edit
		  the basic information about your project,
		  like <interface>Project
		  Title</interface>, <interface>Project
		  Description</interface> and <interface>Notes</interface>.
<!-- ==============Figure=================================== -->
        <figure id="props_project_figure" xreflabel="Properties Dialog -
												  Project Tab">
          <title>Properties Dialog - Project Tab</title>
          <screenshot>
            <screeninfo>Properties dialog - project tab</screeninfo>
			<graphic fileref="figures/gtt_props_project.png" />
          </screenshot>
        </figure>
<!-- ==============End of Figure=================================== -->
		</para>
		<para>
		  The <interface>Rates</interface> tab, which you see in
		  <xref linkend="props_rates_figure"/>, is where you inform
		  the ammount you will be billing for the project. You may
		  enter rates for <interface>Normal</interface>
		  hours, <interface>Overtime</interface>
		  hours, <interface>Double Overtime</interface> hours and
		  a <interface>Flat Rate</interface>. Then, you can select for
		  each task you do in the project which of these billing types
		  should be used so that the invoices can be calculated
		  correctly.
<!-- ==============Figure=================================== -->
        <figure id="props_rates_figure" xreflabel="Properties Dialog -
												  Rates Tab">
          <title>Properties Dialog - Rates Tab</title>
          <screenshot>
            <screeninfo>Properties dialog - rates tab</screeninfo>
			<graphic fileref="figures/gtt_props_rates.png" />
          </screenshot>
        </figure>
<!-- ==============End of Figure=================================== -->
		</para>
		<para>
		  The <interface>Intervals</interface> tab, which you see in
		  <xref linkend="props_intervals_figure"/>, is where you set
		  your preferences for interval recording and
		  auto-merging for the project. The options presented in this
		  tab are:
		  <simplelist>
			<member><interface>Minimum Interval</interface> &mdash; the
			  minimum size of interval that will be recorded. Intervals that
			  last less than this will be discarded.</member>
			<member><interface>Auto-merge Interval</interface> &mdash; the
			  maximum duration for intervals that should be auto-merged. If
			  the duration of an interval is less than this value, it will be
			  automatically merged to its neighbors.</member>
			<member><interface>Auto-merge Gap</interface> &mdash; the
			  minimum distance between two neighbor intervals that will keep
			  them apart. If the time difference from the end of one
			  interval and the start of the next interval is less than this
			  value, they will be automatically merged.</member>
		  </simplelist>
		  
		  <!-- ==============Figure=================================== -->
        <figure id="props_intervals_figure" xreflabel="Properties Dialog -
												  Intervals Tab">
          <title>Properties Dialog - Intervals Tab</title>
          <screenshot>
            <screeninfo>Properties dialog - intervals tab</screeninfo>
			<graphic fileref="figures/gtt_props_intervals.png" />
          </screenshot>
        </figure>
		<!-- ==============End of Figure============================= -->
		</para>
		<para>
		  If you want to disable any of these automatic interval
		  cleanups, just set the corresponding value to 0.
		</para>
		<para>
		  The <interface>Planning</interface> tab, which you see in
		  <xref linkend="props_planning_figure"/>, is where you may
		  enter data about your planning for the execution of the
		  project. The following information may be set for the project:
		  <simplelist>
			<member><interface>Urgency</interface> &mdash; how urgent
			this project is </member>
			<member><interface>Importance</interface> &mdash; how
			important this project is</member>
			<member><interface>Planned Start</interface> &mdash; when
			we plan to start working on this project</member>
			<member><interface>Planned Finish</interface> &mdash;
			when we plan to finish working in this project</member>
			<member><interface>Due Date</interface> &mdash; when the
			project must be finish</member>
			<member><interface>Hours to Finish</interface> &mdash;
			How many hours of work will be needed to finish this
			project</member> 
			<member><interface>&percnt; Complete</interface> &mdash;
			How much of the project has already been done</member>
		  </simplelist>
		  
		  <!-- ==============Figure=================================== -->
        <figure id="props_planning_figure" xreflabel="Properties Dialog -
												  Planning Tab">
          <title>Properties Dialog - Planning Tab</title>
          <screenshot>
            <screeninfo>Properties dialog - planning tab</screeninfo>
			<graphic fileref="figures/gtt_props_planning.png" />
          </screenshot>
        </figure>
		<!-- ==============End of Figure============================= -->
		</para>
	  </sect3>
        
    </sect2>

    <sect2 id="statusbar" xreflabel="The Status Bar">
      <title>The Status Bar</title>

        <para>
        The first field of the status bar displays the sum of all projects'
        daily time. It reflects the total time you have worked on your
        projects today.
        </para>

        <para>
        The second field holds the title and description of the
        currently active project.  If no project is active, the
        display reads: <computeroutput>Timer is not
        running</computeroutput>.
        </para>

        <para>
        The far right corner of the status bar holds a small clock if
        the timer is running. If the timer is off, the space is blank.
        </para>
</sect2>
</sect1>


<!-- =============New section============================= --> 
  <sect1 id="preferences" xreflabel="Customization">
      <title>Customization</title> 
      <para>
      To change default settings, select the
      <guimenuitem>Preferences</guimenuitem> command in the
      <guimenu>Settings</guimenu> menu. This launches the
      <interface>Preferences dialog</interface>. There are seven tabs
      of preferences in the window.
     </para>
 <sect2 id="fields-settings">
   <title>The Fields Preferences Tab</title>
   <para>
	 Through this tab, shown in <xref linkend="prefs_fields_figure"/>,
	 you can control which information is shown in the project
	 list. The following fields may be enabled or disabled by toggling
	 the buttons present in this tab:
	 <simplelist>
	   <member><guibutton>Project Importance</guibutton> &mdash;
	   importance of the project as defined in the <xref linkend="properties"/></member>
	   <member><guibutton>Project Urgency</guibutton> &mdash;
	   urgency of the project as defined in the <xref linkend="properties"/></member>
	   <member><guibutton>Project Status</guibutton> &mdash;
	   status of the project as defined in the <xref linkend="properties"/></member>
	   <member><guibutton>Total Time</guibutton> &mdash;
	   total time worked on the project since its creation</member>
	   <member><guibutton>Time this year</guibutton> &mdash;
	   total time worked on the project this year</member>
	   <member><guibutton>Time this month</guibutton> &mdash;
	   total time worked on the project this month</member>
	   <member><guibutton>Time this week</guibutton> &mdash;
	   total time worked on the project this week</member>
	   <member><guibutton>Time last week</guibutton> &mdash;
	   total time worked on the project last week</member>
	   <member><guibutton>Time today</guibutton> &mdash;
	   total time worked on the project today</member>
	   <member><guibutton>Time yesterday</guibutton> &mdash;
	   total time worked on the project yesterday</member>
	   <member><guibutton>Time for the current diary
	   entry</guibutton> &mdash;
	   total time worked on the project for the current diary entry</member>
	   <member><guibutton>Project description</guibutton> &mdash;
	   description of the project as defined in the <xref linkend="properties"/></member>
	   <member><guibutton>Current diary entry</guibutton> &mdash;
	   title of the current diary entry</member>
	   <member><guibutton>Planned project start date</guibutton> &mdash;
	   start date of the project as defined in the <xref linkend="properties"/></member>
	   <member><guibutton>Planned project end date</guibutton> &mdash;
	   end date of the project as defined in the <xref linkend="properties"/></member>
	   <member><guibutton>Project due date</guibutton> &mdash;
	   due date for the project as defined in the <xref linkend="properties"/></member>
	   <member><guibutton>Estimated effort</guibutton> &mdash;
	   estimated work time for the project as defined in the <xref linkend="properties"/></member>
	   <member><guibutton>Percent complete</guibutton> &mdash;
	   percent of the project already done as defined in the <xref linkend="properties"/></member>
	 </simplelist>
   </para>
<!-- ==============Figure=================================== -->
        <figure id="prefs_fields_figure" xreflabel="Preferences Dialog -
												  Fields Tab">
          <title>Preferences Dialog - Fields Tab</title>
          <screenshot>
            <screeninfo>Preferences dialog - fields tab</screeninfo>
      <graphic fileref="figures/gtt_prefs_fields.png" />
          </screenshot>
        </figure>
<!-- ==============End of Figure=================================== -->
</sect2>
 <sect2 id="display-prefs">
   <title>The Display Preferences Tab</title>
   <para>
	 This tab, shown in <xref linkend="prefs_display_figure"/>,
	 controls some aspects of the main window display. The following
	 aspects may be controlled through the settings available in this
	 tab:
   </para>
	 <simplelist>
	   <member><guibutton>Show seconds</guibutton> &mdash; display
	   seconds in the various time counters</member>
	   <member><guibutton>Show statusbar</guibutton> &mdash; show the
	   statusbar at the bottom of the window</member>
	   <member><guibutton>Show Table Header</guibutton> &mdash; display
	   the headers with names of the fields in the <interface>Project List</interface></member>
	   <member><guibutton>Show Sub-projects</guibutton> &mdash;
	   display the project tree structure through lines linking the
	   projects to its sub-projects</member>
	 </simplelist>

<!-- ==============Figure=================================== -->
        <figure id="prefs_display_figure" xreflabel="Preferences Dialog -
												  Display Tab">
          <title>Preferences Dialog - Display Tab</title>
          <screenshot>
            <screeninfo>Preferences dialog - display tab</screeninfo>
      <graphic fileref="figures/gtt_prefs_display.png" />
          </screenshot>
        </figure>
<!-- ==============End of Figure=================================== -->
 </sect2>
<sect2 id="shell-prefs">
<title>The Shell Preferences Tab</title>
<para>
This tab, shown in <xref linkend="prefs_shell_figure"/>, allows you to
define commands to be executed when starting or stopping the timer for
a project. When composing your command line, you may use the following
variables:
<itemizedlist>
  <listitem><para><literal>&percnt;t</literal> &mdash; The project's title.</para></listitem>
  <listitem><para><literal>&percnt;d</literal> &mdash; The project's description.</para></listitem>
  <listitem><para><literal>&percnt;T</literal> &mdash; The total time logged on the project, in the format Hours:Minutes:Seconds.</para></listitem>
  <listitem><para><literal>&percnt;h</literal> &mdash; The number of hours logged on the project today.</para></listitem>
  <listitem><para><literal>&percnt;H</literal> &mdash; The number of hours spent on the project today, in two digits.</para></listitem>
  <listitem><para><literal>&percnt;m</literal> &mdash; The number of minutes spent on the project today.</para></listitem>
  <listitem><para><literal>&percnt;M</literal> &mdash; The number of minutes spent on the project today (00-59).</para></listitem>
  <listitem><para><literal>&percnt;s</literal> &mdash; The number of seconds spent on the project today.</para></listitem>
  <listitem><para><literal>&percnt;S</literal> &mdash; The number of seconds spent on the project today (00-59).</para></listitem>
</itemizedlist>
</para>
<!-- ==============Figure=================================== -->
        <figure id="prefs_shell_figure" xreflabel="Preferences Dialog -
												  Shell Tab">
          <title>Preferences Dialog - Shell Tab</title>
          <screenshot>
            <screeninfo>Preferences dialog - shell tab</screeninfo>
			<graphic fileref="figures/gtt_prefs_shell.png" />
          </screenshot>
        </figure>
<!-- ==============End of Figure=================================== -->
</sect2>
<sect2 id="logfile-prefs">
<title>The Logfile Preferences Tab</title>
<para>
  This tab, shown in
  <xref linkend="prefs_logfile_figure"/>, contains
  a <guibutton>Use Logfile</guibutton> Checkbox, which
  determines whether you use a logfile at all, and the
  following text entry boxes, governing its behavior: 
  <itemizedlist>
    <listitem><para>
        <guilabel>Filename</guilabel>
        Determines the path and name of the log file.  This should be the complete
        path and filename, without variables like $HOME or ~.
    </para></listitem>
	
    <listitem><para>
        <guilabel>Entry Start</guilabel>
        This is the string which marks the start of a log entry.  It can include the same
        variables as described in <xref linkend="shell-prefs"/>.
    </para></listitem>
	
    <listitem><para>
        <guilabel>Entry Stop</guilabel>
        This string marks the end of a log entry.  It can include the same
		variables as described in <xref linkend="shell-prefs"/>.
	  </para>
				</listitem>
    <listitem><para>
        <guilabel>Min Recorded</guilabel>
        The minimum size of intervals that should be recorded in the logfile.
	  </para>
	</listitem>
  </itemizedlist>
  <!-- ==============Figure=================================== -->
        <figure id="prefs_logfile_figure" xreflabel="Preferences Dialog -
												  Logfile Tab">
          <title>Preferences Dialog - Logfile Tab</title>
          <screenshot>
            <screeninfo>Preferences dialog - logfile tab</screeninfo>
			<graphic fileref="figures/gtt_prefs_logfile.png" />
          </screenshot>
        </figure>
<!-- ==============End of Figure=================================== -->

              <tip>
                 <para>Note that a project will not get logged until you
                 either quit <application>GNOME Time Tracker</application>, switch to another project, or
                 deselect that project. Don't be confused when you look at
                 your logfile and your current project still isn't listed,
                 even if it has been running for two hours.</para>
              </tip>
  </para>
</sect2>
 <sect2 id="toolbar-prefs">
      <title>The Toolbar Preferences Tab</title>
      <para>
        This tab, shown in <xref linkend="prefs_toolbar_figure"/>,
        contains two sections of buttons: <guilabel>Toolbar</guilabel>
        and <guilabel>Toolbar Segments</guilabel>
<!-- ==============Figure=================================== -->
        <figure id="prefs_toolbar_figure" xreflabel="Preferences Dialog -
												  Toolbar Tab">
          <title>Preferences Dialog - Toolbar Tab</title>
          <screenshot>
            <screeninfo>Preferences dialog - toolbar tab</screeninfo>
			<graphic fileref="figures/gtt_prefs_toolbar.png" />
          </screenshot>
        </figure>
<!-- ==============End of Figure============================ -->
        <itemizedlist>
          <listitem>
            <para> 
              The <guilabel>Toolbar</guilabel> section contains the
              following checkboxes:
              <simplelist>
                <member>
                  <guibutton> Show Toolbar</guibutton>
                </member>
                <member>
                  <guibutton> Show Tooltips</guibutton>
                </member>
              </simplelist>
              They determine whether the toolbar buttons should be
              displayed and whether tooltips describing the button
              should appear when the mouse pointer hovers over a
              toolbar item. The control of wheter text, icons or both
              should be shown in the toolbar buttons is done through the
              global GNOME toolbar settings.
            </para>
          </listitem>
          <listitem>
              <para>
                The <guilabel>Toolbar Segments</guilabel> checkboxes determine which shortcut
                buttons appear on the toolbar:
                <simplelist>
                <member><guilabel>  Show 'New' </guilabel></member>
                <member><guilabel> Show 'Cut', 'Copy', 'Paste'</guilabel></member>
                <member><guilabel> Show 'Journal' </guilabel></member>
                <member><guilabel> Show 'Properties' </guilabel></member>
                <member><guilabel> Show 'Timer' </guilabel></member>
                <member><guilabel> Show 'Preferences' </guilabel></member>
                <member><guilabel> Show 'Help' </guilabel></member>
                <member><guilabel>  Show 'Quit' </guilabel></member>
                </simplelist>
              </para>
          </listitem>
        </itemizedlist>
        </para>
    </sect2>

   <sect2 id="prefs-misc">
      <title>The Misc Preferences Tab</title>
         <para>
         This tab, shown in <xref linkend="prefs_misc_figure"/>,
         contains three sections.

<!-- ==============Figure=================================== -->
        <figure id="prefs_misc_figure" xreflabel="Preferences Dialog -
												  Misc Tab">
          <title>Preferences Dialog - Misc Tab</title>
          <screenshot>
            <screeninfo>Preferences dialog - misc tab</screeninfo>
			<graphic fileref="figures/gtt_prefs_misc.png" />
          </screenshot>
        </figure>
<!-- ==============End of Figure============================ -->
         <variablelist>
           
           <varlistentry> 
              <term><guilabel>Inactivity Timeout</guilabel></term>
              <listitem> 
                <para>
                  The Inactivity timeout defines the number of seconds
                  of inactivity after which GnoTime will stop the
                  timer and alert the user if the timer was running
                  and give her/him the opportunity to tune how much of
                  that time should really be credited to the active
                  project. If you don't want this timeout to be
                  active, set this value to zero or some negative value.
                 </para>
              </listitem>
            </varlistentry>

            <varlistentry>
                <term><guilabel>No Project Timeout</guilabel></term>
                <listitem>
                   <para>
					 The <guilabel>No Project Timeout</guilabel>
					 defines the number of seconds after which GnoTime
					 will alert the user if there is no active project
					 and offer to start the timer running for some
					 project and credit the elapsed time to it. If you
					 don't want this timeout to be active, set this
					 value to zero or some negative value.
                   </para>
                 </listitem>
             </varlistentry>
         <varlistentry>
            <term><guilabel>End of Day/Week</guilabel></term>
            <listitem>
              <para>
                The <guilabel>End of Day/Week</guilabel> section
                allows the user to define at which time of day
                GnoTime should start counting as a different day and
                which day of the week should be considered as the
                start of a new week.
        </para></listitem>
        </varlistentry>
        </variablelist></para>
  </sect2>
<sect2 id="prefs-reports">
<title>The Reports Preferences Tab</title>
<para>
This tab, shown in <xref linkend="prefs_reports_figure"/>, contains
two sections that allow users to choose how some values are formated
in reports.
<!-- ==============Figure=================================== -->
        <figure id="prefs_reports_figure" xreflabel="Preferences Dialog -
												  Reports Tab">
          <title>Preferences Dialog - Reports Tab</title>
          <screenshot>
            <screeninfo>Preferences dialog - reports tab</screeninfo>
			<graphic fileref="figures/gtt_prefs_reports.png" />
          </screenshot>
        </figure>
<!-- ==============End of Figure============================ -->
<variablelist>
  <varlistentry>
    <term><guilabel>Time format</guilabel></term>
	<listitem>
	  <para>
		This option allows you to choose how times should be displayed in
		reports. You may choose among a <guilabel>12 hours</guilabel>
		format, <guilabel>24 hours</guilabel> or the default format based on
		your current locale settings.
	  </para>
	</listitem>
  </varlistentry>
  <varlistentry>
    <term><guilabel>Currency settings</guilabel></term>
	<listitem>
	  <para>
		This option allows you to set a customized currency symbol to
		be used in reports or choose to use the currency symbol
		defined by your locale settings.
	  </para>
	</listitem>
  </varlistentry>
</variablelist></para>
</sect2>
      <sect2 id="ok-apply-close">
          <title>OK, Apply and Close</title>
        <para>
          If you are pleased by the changes you have made, click
          <guibutton>OK</guibutton> to activate the changes and have the dialog go
          away.
        </para>

        <para>
          If you want to see what your changes will look like without closing the window,
          press <guibutton>Apply</guibutton> to activate the values while keeping the dialog
          open.
        </para>

        <para>
          If you don't want to activate your changes,
          press <guibutton>Close</guibutton>. That will close the dialog, but will
          not save any of the changes you have made. This does not reverse any changes activated
          by the <guibutton>Apply</guibutton> command.  Note that pressing <guibutton>Apply</guibutton>
         and then <guibutton>Close</guibutton> has the the same effect as pressing <guibutton>OK</guibutton>.
        </para>
      </sect2>
    </sect1>
<sect1 id="timeouts">
       <title>The timeout dialogs</title>
<para>
  As we have seen at <xref linkend="prefs-misc"/>, <application>GNOME
	Time Tracker</application> allows you to define two timeouts for
	conditions in which it will popup a dialog to warn about it and
	let you take action to correct the situation. In this section, we
	will learn how these dialogs work.
</para>
<sect2 id="idletimer">
  <title>The Restart Timer Dialog</title>
  <para>When <application>GNOME Time Tracker</application> detects that you
    have not entered anything into your computer for a period of time
    (configured under <xref linkend="preferences" />), it stops the timer
    and pops up a dialog asking if you want to restart the timer.</para>
  <figure id="restart_timer_dialog" xreflabel="Restart Timer Dialog">
    <title>Restart Timer Dialog</title>
    <screenshot>
      <screeninfo>Restart Timer Dialog</screeninfo>
      <graphic fileref="figures/gtt_restartwin.png" />
    </screenshot>
  </figure>
  <para>If you want the time credited to the project anyway (If you had to
    make a call related to the project, for instance) GnoTime provides a
    slider which can be set to the time you want to credit the project with.
    Pressing <guibutton>Yes</guibutton> credits the project and restarts the
    timer.  Pressing <guibutton>No</guibutton> halts the timer.</para>
  </sect2>
<sect2 id="start_project_dialog" xreflabel="Start Project Dialog">
<title>Start Project Dialog</title>
  <para>Similarly, when there is no project running, <application>GNOME Timer
    Tracker</application> pops up a dialog asking if you want to start
    one.</para>
  <figure id="start_project_figure" xreflabel="Start Project Dialog">
    <title>No Project Dialog</title>
    <screenshot>
      <screeninfo>Start Project Dialog</screeninfo>
      <graphic fileref="figures/gtt_startprojwin.png" />
    </screenshot>
  </figure>
  <para>It provides a drop-down list of your projects which you can choose to
    select as well as a place to enter any time you want credited to the
    timer.  If you choose to restart the timer with a project, press the
    <guibutton>Execute</guibutton> button.  Otherwise, press
    <guibutton>Cancel</guibutton>.</para>
</sect2>
</sect1>

<sect1 id="reports" xreflabel="Reports">
  <title>Reports</title>
  <para>
	GnoTime provides a set of default reports that can be used to take
	different views to your project data ranging from a detailed listing of the
	work done with all time interval data recorded  to an invoice
	listing the each task and it's billing status and value. Some of
	these reports may be used to edit data that you would not be
	able to do otherwise (You're right, that's a bug in the
	application and we should fix it in the future but, for now, it's
	good to know how you can access these data while we don't fix
	it). Some samples of the default reports can be seen below.
  </para>
  <sect2 id="journal_report" xreflabel="The Journal Report">
	<title>The Journal Report</title>
	<para>
	  The journal report displays a summary of the Diary Entries
	  associated with a project containing its title, date and time of
	  first activity, date and time of last activity, and the notes
	  associated. An example of a Journal Report for a project
	  containing only one Diary Entry can be seen in
	  <xref linkend="journal_report_figure"/>.
	</para>
	<figure id="journal_report_figure" xreflabel="Journal Report">
	  <title>Journal Report</title>
	  <screenshot>
		<screeninfo>Journal Report</screeninfo>
		<graphic fileref="figures/gtt_report_journal.png" />
	  </screenshot>
	</figure>
	<tip>
	  <para>
		By clicking the title of a Diary Entry in the report, you
		activate the <interface>Diary Entry menu</interface>, from which
		you can do various operations like creating a new diary entry, 
		editing the properties of the diary entry,
		deleting/copying/pasting the diary entry and creating a new time
		interval for the diary entry.
	  </para>
	</tip>
  </sect2>
  <sect2 id="activity_report" xreflabel="The Activity Report">
	<title>The Activity Report</title>
	<para>
	  The activity report displays a list of the diary entries for a
	  project detailing the start and stop times for each of the
	  recorded time intervals. An example of an Activity Report can be
	  seen in <xref linkend="activity_report_figure"/>.
	</para>
	<figure id="activity_report_figure" xreflabel="Activity Report">
	  <title>Activity Report</title>
	  <screenshot>
		<screeninfo>Activity Report</screeninfo>
		<graphic fileref="figures/gtt_report_activity.png" />
	  </screenshot>
	</figure>
	<tip>
	  <para>
		Clicking in a time interval's data, you will activate
		the <interface>Time Interval menu</interface> which will allow
		you to edit its data, cut, copy, paste, merge to its neighbors
		and create new time intervals.
	  </para>
	</tip>
  </sect2>
  <sect2 id="todo_report" xreflabel="The Todo Report">
	<title>The Todo Report</title>
	<para>
	  The todo report lists all the sub-projects of a given project,
	  displaying its importance, urgency, title, description and
	  status. An example Todo Report is shown in <xref linkend="todo_report_figure"/>.
	</para>
	<figure id="todo_report_figure" xreflabel="Todo Report">
	  <title>Todo Report</title>
	  <screenshot>
		<screeninfo>Todo Report</screeninfo>
		<graphic fileref="figures/gtt_report_todo.png" />
	  </screenshot>
	</figure>
	<tip>
	  <para>
		Clicking the title of a sub-project will take you to the Journal
		Report for that sub-project.
	  </para>
	</tip>
  </sect2>
  <sect2 id="invoice_report" xreflabel="The Invoice Report">
	<title>The Invoice Report</title>
	<para>
	  The Invoice Report displays the list of billable tasks for a
	  project with its respective worked time and value. An example
	  Invoice Report can be seen at <xref linkend="invoice_report_figure"/>.
	</para>
	<figure id="invoice_report_figure" xreflabel="Invoice Report">
	  <title>Invoice Report</title>
	  <screenshot>
		<screeninfo>Invoice Report</screeninfo>
		<graphic fileref="figures/gtt_report_invoice.png" />
	  </screenshot>
	</figure>
  </sect2>
  <sect2 id="daily" xreflabel="The Daily Report">
	<title>The Daily Report</title>
	<para>
	  The Daily Report shows the total time worked each day for a
	  given project with a list of the tasks worked on each day. An
	  example Daily Report can be seen at <xref linkend="daily_report_figure"/>.
	</para>
	<figure id="daily_report_figure" xreflabel="Daily Report">
	  <title>Daily Report</title>
	  <screenshot>
		<screeninfo>Daily Report</screeninfo>
		<graphic fileref="figures/gtt_report_daily.png" />
	  </screenshot>
	</figure>
  </sect2>
  <sect2 id="customizing_reports" xreflabel="Customizing Reports">
	<title>Customizing Reports</title>
  <para>
	We know GnoTime's default set of reports will not satisfy all the
	reporting needs for everyone. They may be missing some data, or
	may be showing data you don't want to be shown or may be pretty
	ugly or simply we may have not envisioned some that particular way
	you want to display your data.
  </para>
  <para>
	Fortunately, the available reports are not set in stone. GnoTime's
	reporting engine is based on HTML files with scheme scripting. So
	you can edit them at will to change their formating, add or remove
	data and even create whole new reports and add them to the set
	of reports available from the Reports menu. If you do create some
	new report you think could be useful for the community in general,
	you may post it in our patch tracker and we will consider its
	inclusion in future releases.
  </para>
  <para>
	To add a new report to GnoTime, you
	choose <menuchoice><guimenu>Reports</guimenu><guimenuitem>New
	report</guimenuitem></menuchoice>, which will invoke the
	<xref linkend="new_report_dialog_figure"/>. In this dialog, you
	must enter the name that should be displayed in the Reports menu
	for the new report you are creating, a tooltip to be displayed for
	the menu item and the full path to the file with the code for the
	new report.
  </para>
	<figure id="new_report_dialog_figure" xreflabel="New Report Dialog">
	  <title>New Report Dialog</title>
	  <screenshot>
		<screeninfo>New Report Dialog</screeninfo>
		<graphic fileref="figures/gtt_new_report_dialog.png" />
	  </screenshot>
	</figure>
	<para>
	  After adding new reports to GnoTime, you may want to organize
	  the menu items in a different way, instead of keeping them in a
	  flat list in the order the were added. To do this, you
	  choose <menuchoice><guimenu>Reports</guimenu><guimenuitem>Edit
	  Reports</guimenuitem></menuchoice>, which will open the
	  <xref linkend="edit_reports_dialog_figure"/>. In this dialog,
	  you will be able to reorder the menu items, create sub menus,
	  create keyboard shortcuts for the reports, and change all the
	  properties entered when creating the report.
	</para>
	<figure id="edit_reports_dialog_figure" xreflabel="Edit Reports Dialog">
	  <title>Edit Reports Dialog</title>
	  <screenshot>
		<screeninfo>Edit Reports Dialog</screeninfo>
		<graphic fileref="figures/gtt_edit_reports_dialog.png" />
	  </screenshot>
	</figure>  </sect2>
</sect1>

<sect1 id="gnotime_remote" xreflabel="Sending commands to GnoTime">
  <title>Sending commands to GnoTime</title>
  <para>
	<application>GNOME Time Tracker</application> exposes some of its
	functionality through DBus. To ease the use of the exposed
	functions, we provide a shell script named gnotime-remote that can
	be used to send commands to GnoTime. Currently, the following
	commands are supported:
	<simplelist>
	  <member><command>start-timer</command> &mdash; starts the timer
	  for the currently selected project</member>
	  <member><command>stop-timer</command> &mdash; stops the timer</member>
	  <member><command>save-file</command> &mdash; saves project data
	  to the data file</member>
	  <member><command>reload-file</command> &mdash; reloads project
	  data from the data file</member>
	</simplelist>
  </para>
</sect1>

<!-- =============New section============================= -->
  <sect1 id="bugs">
    <title>Known bugs and limitations</title>
    <para>
	  You may refer to
      the <ulink url="https://sourceforge.net/projects/gttr/">GnoTime
      Sourceforge Project Site</ulink> for a list of known bugs.
    </para>
  </sect1>

<!-- =============Authors Section============================= -->

  <sect1 id="authors">
    <title>Authors</title>
    <para>
       <application>GNOME Time Tracker</application> was written by 
       Eckehard Berns <email>eb@berns.i-s-o.net</email> and Linas
       Vepstas <email>linas@linas.org</email>.
       It is currently maintained by Goedson Paixão <email>goedson@debian.org</email>.

      Please submit all comments, suggestions, and bug reports 
      on the  
      <ulink url="https://sourceforge.net/projects/gttr/">GnoTime 
      Sourceforge Project Site</ulink>; you may want to drop Goedson
      an email as well.
    </para>
    <para>
      There is a web page devoted to the latest GTT news at
      <ulink url="http://gttr.sourceforge.net">
       http://gttr.sourceforge.net</ulink> (mirrored at
      <ulink url="http://www.linas.org/linux/gtt/gtt.html">
       http://www.linas.org/linux/gtt/gtt.html</ulink>).  
    </para>
    <para>
      This manual was written by 
      Aaron Weber (<email>aaron@helixcode.com</email>) 
      Eckehard Berns (<email>eb@berns.i-s-o.net</email>)
      Linas Vepstas (<email>linas@linas.org</email>)
	  and
	  Goedson Paixão (<email>goedson@debian.org</email>)
      Please send all comments
      and suggestions regarding the manual
      to our bug tracker at
      the <ulink url="http://www.sourceforge.net/projects/gttr">SourceForge
      project page</ulink>. 
      </para>
    <!-- For translations: uncomment this:
      <para> Latin translation was done by ME
      (<email>MYNAME@MYADDRESS</email>). Please send all comments
      and suggestions regarding this translation to SOMEWHERE.
     </para> 
     -->
      </sect1>


 <!-- ============= Application License ============================= -->

 <sect1 id="license">
  <title>License</title>
  <para>
   This program is free software; you can redistribute it and/or
   modify it under the terms of the<ulink url="ghelp:gpl" type="help">
   GNU General Public License</ulink> as published by the Free Software Foundation;
   either version 2 of the License, or (at your option) any later
   version.
  </para>
  <para>
   This program is distributed in the hope that it will be useful, but
   WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   <citetitle>GNU General Public License</citetitle> for more details.
  </para>
  <para>
      You may obtain a copy of the
      <citetitle>GNU General Public License</citetitle> from the Free
      Software Foundation by visiting <ulink type="http"
      url="http://www.fsf.org">their Web site</ulink> or by writing to
      <address>
        Free Software Foundation, Inc.
        <street>51 Franklin Street</street> - Fifth Floor
        <city>Boston</city>, <state>MA</state> <postcode>02110-1301</postcode>
        <country>USA</country>
   </address>
  </para>
 </sect1>
</article>
