<HTML
><HEAD
><TITLE
>Customization</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
REL="HOME"
TITLE="GNOME Time Tracking Tool"
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="Using GNOME Time Tracker"
HREF="usage.html"><LINK
REL="NEXT"
TITLE="Additional GNOME Time Tracker Dialogs"
HREF="dialogs.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>GNOME Time Tracking Tool</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="usage.html"
>&#60;&#60;&#60; Previous</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="dialogs.html"
>Next &#62;&#62;&#62;</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="PREFERENCES"
>Customization</A
></H1
><P
>      To change default settings, select the
      <B
CLASS="GUIMENUITEM"
>Preferences</B
> command in
      <B
CLASS="GUIMENU"
>Settings</B
> menu. This launches the
      <SPAN
CLASS="INTERFACE"
>Preferences dialog</SPAN
>, shown in <A
HREF="preferences.html#PREFSFIGURE"
></A
>.
       There are two tabs of preferences in the window.
     </P
><DIV
CLASS="FIGURE"
><A
NAME="PREFSFIGURE"
></A
><P
><IMG
SRC="gtt_prefswin.png"></P
><P
><B
>Figure 2. Preferences Dialog</B
></P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN278"
>The Toolbar Preferences Tab</A
></H2
><P
>        This tab contains two sections of buttons: <TT
CLASS="GUILABEL"
><B
>Toolbar</B
></TT
>
	and <TT
CLASS="GUILABEL"
><B
>Toolbar Segments</B
></TT
>
        <P
></P
><UL
><LI
><P
> 
	      The <TT
CLASS="GUILABEL"
><B
>Toolbar</B
></TT
> contains the following checkboxes: 
	      <P
></P
><TABLE
BORDER="0"
><TBODY
><TR
><TD
>		  <B
CLASS="GUIBUTTON"
> Show Toolbar Icons</B
>
		</TD
></TR
><TR
><TD
>		  <B
CLASS="GUIBUTTON"
> Show Toolbar Texts</B
>
		</TD
></TR
><TR
><TD
>		  <B
CLASS="GUIBUTTON"
> Show Tooltips</B
>
		</TD
></TR
></TBODY
></TABLE
><P
></P
>
	      They determine whether icons and their descriptions appear on the
	      toolbar, and whether tooltips describing the button appear when the mouse pointer hovers 
	      over a toolbar item.
	    </P
></LI
><LI
><P
>	        The <TT
CLASS="GUILABEL"
><B
>Toolbar Segments</B
></TT
> checkboxes determine which shortcut 
                buttons appear on the toolbar:
		<P
></P
><TABLE
BORDER="0"
><TBODY
><TR
><TD
><TT
CLASS="GUILABEL"
><B
>  Show 'New' </B
></TT
></TD
></TR
><TR
><TD
><TT
CLASS="GUILABEL"
><B
> Show 'Save', 'Reload'</B
></TT
></TD
></TR
><TR
><TD
><TT
CLASS="GUILABEL"
><B
> Show 'Cut', 'Copy', 'Paste'</B
></TT
></TD
></TR
><TR
><TD
><TT
CLASS="GUILABEL"
><B
> Show 'Properties' </B
></TT
></TD
></TR
><TR
><TD
><TT
CLASS="GUILABEL"
><B
> Show 'Timer' </B
></TT
></TD
></TR
><TR
><TD
><TT
CLASS="GUILABEL"
><B
> Show 'Preferences' </B
></TT
></TD
></TR
><TR
><TD
><TT
CLASS="GUILABEL"
><B
> Show 'Help' </B
></TT
></TD
></TR
><TR
><TD
><TT
CLASS="GUILABEL"
><B
>  Show 'Quit' </B
></TT
></TD
></TR
></TBODY
></TABLE
><P
></P
>
	      </P
></LI
></UL
>
        </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="OTHER-SETTINGS"
>Other Settings</A
></H2
><P
>         There are three sections within the <B
CLASS="GUIBUTTON"
>Misc</B
> tab.
	 <P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="GUILABEL"
><B
>Display</B
></TT
></DT
><DD
><P
>	          The Display box contains three check-boxes:
	          <P
></P
><TABLE
BORDER="0"
><TBODY
><TR
><TD
><TT
CLASS="GUILABEL"
><B
> Show Seconds </B
></TT
></TD
></TR
><TR
><TD
><TT
CLASS="GUILABEL"
><B
> Show Status Bar </B
></TT
> </TD
></TR
><TR
><TD
><TT
CLASS="GUILABEL"
><B
> Show Table Header </B
></TT
></TD
></TR
></TBODY
></TABLE
><P
></P
>
	          They toggle whether seconds appear in the timer displays, and whether
	          the status bar and table header appear in the <SPAN
CLASS="INTERFACE"
>Main Window</SPAN
>
	         </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Shell Commands</B
></TT
></DT
><DD
><P
>                     <A
NAME="SHELLCMD"
></A
>
                      There are two shell commands
                      executed by <TT
CLASS="APPLICATION"
>GNOME Time Tracker</TT
>.
                      One is executed when you switch between projects, and the other when you deselect a project or
                      quit the application.
                      <P
></P
><UL
><LI
><P
>		            <TT
CLASS="GUILABEL"
><B
>Switch Project Command</B
></TT
>:
		            This shell command is executed every
		            time you select a project which was previously
		            unselected. If you use <TT
CLASS="LITERAL"
>%s</TT
> in this command,
		            <TT
CLASS="APPLICATION"
>GNOME Time Tracker</TT
> will replace that with the title of the
		            selected project. I use the following entry to update
		            my <TT
CLASS="FILENAME"
>.project</TT
> file:
		            <TT
CLASS="USERINPUT"
><B
>echo '%s' &#62;~/.project</B
></TT
>
		           </P
></LI
><LI
><P
>                             <TT
CLASS="GUILABEL"
><B
>No Project Command</B
></TT
>
		             This shell command is executed every
		             time you deselect a project or exit
		             <TT
CLASS="APPLICATION"
>GNOME Time Tracker</TT
>. To complete the example above, I use
		             this command:
		             <TT
CLASS="USERINPUT"
><B
>rm -f ~/.project</B
></TT
>
                           </P
></LI
></UL
>
                   </P
></DD
><DT
><TT
CLASS="GUILABEL"
><B
>Logfile Preferences</B
></TT
></DT
><DD
><P
>	        The Logfile Preferences area contains a <B
CLASS="GUIBUTTON"
>Use Logfile</B
>
	        Checkbox, which determines whether you use a logfile at all,
	        and the following text entry boxes, governing its behavior:
	        <P
></P
><UL
><LI
><P
>	             <TT
CLASS="GUILABEL"
><B
>Filename</B
></TT
>
		      Determines the path and name of the log file.  This should be the complete
		      path and filename, without variables like $HOME or ~.
		</P
></LI
><LI
><P
>                      <TT
CLASS="GUILABEL"
><B
>Entry Start</B
></TT
>
                      This is the string which marks the start of a log entry.  It can include the same
                      variables the <TT
CLASS="GUILABEL"
><B
>Entry Stop</B
></TT
> can.
                </P
></LI
><LI
><P
>                      <TT
CLASS="GUILABEL"
><B
>Entry Stop</B
></TT
>
                      This string marks the end of a log entry.  Both this string and the <TT
CLASS="GUILABEL"
><B
>Entry Start</B
></TT
>
                      can contain the following variables:
                      <P
></P
><UL
><LI
><P
><TT
CLASS="LITERAL"
>%t</TT
> &#8212; The project's title.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>%d</TT
> &#8212; The project's title.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>%t</TT
> &#8212; The project's description.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>%T</TT
> &#8212; The total time logged on the project, in the format Hours:Minutes:Seconds.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>%h</TT
> &#8212; The number of hours logged on the project today.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>%H</TT
> &#8212; The number of hours spent on the project today, in two digits.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>%m</TT
> &#8212; The number of minutes spent on the project today.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>%M</TT
> &#8212; The number of minutes spent on the project today (00-59).</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>%s</TT
> &#8212; The number of seconds spent on the project today.</P
></LI
><LI
><P
><TT
CLASS="LITERAL"
>%S</TT
> &#8212; The number of seconds spent on the project today (00-59).</P
></LI
></UL
>
                </P
></LI
><LI
><P
>		    <TT
CLASS="GUILABEL"
><B
>Timeout in secs</B
></TT
> &#8212; 
		    This value represents the minimum time a
		    project must be selected before it will be logged.
		    This is useful if you don't want to log very short tasks,
		    or if you click on the wrong project
		    first. For example, suppose you wanted to start working on
		    a letter to your friend Joe, and so you selected the
		    project <I
CLASS="EMPHASIS"
>Letter to Joe</I
>), but that reminds
		    you that you have to prepare a list of Christmas
		    presents first (Joe has asked you to give him some
		    good ideas). So, you switch to the project
		    <I
CLASS="EMPHASIS"
>Xmas presents</I
>.  You wouldn't want the
		    project <I
CLASS="EMPHASIS"
>Letter to Joe</I
>to be in your
		    logfile, because you didn't really start it yet. I
		    would suggest you set this value at least to 10
		    seconds.
	        </P
></LI
></UL
>
            
              <DIV
CLASS="TIP"
><P
></P
><TABLE
CLASS="TIP"
WIDTH="90%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/tip.gif"
HSPACE="5"
ALT="Tip"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>Note that a project will not get logged until you
		 either quit <TT
CLASS="APPLICATION"
>GNOME Time Tracker</TT
>, switch to another project, or
		 de-selecet 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.</P
></TD
></TR
></TABLE
></DIV
>
		 
	
	</P
></DD
></DL
></DIV
></P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN410"
>OK, Apply and Close</A
></H2
><P
>	  If you are pleased by the changes you have made, click
	  <B
CLASS="GUIBUTTON"
>OK</B
> to activate the changes and have the dialog go
	  away.
	</P
><P
>	  If you want to see what your changes will look like without closing the window,
          press <B
CLASS="GUIBUTTON"
>Apply</B
> to activate the values while keeping the dialog
	  open.
	</P
><P
>	  If you don't want to activate your changes,
	  press <B
CLASS="GUIBUTTON"
>Close</B
>. 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 <B
CLASS="GUIBUTTON"
>Apply</B
> command.  Note that pressing <B
CLASS="GUIBUTTON"
>Apply</B
>
         and then <B
CLASS="GUIBUTTON"
>Close</B
> has the the same effect as pressing <B
CLASS="GUIBUTTON"
>OK</B
>.
	</P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="usage.html"
>&#60;&#60;&#60; Previous</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="dialogs.html"
>Next &#62;&#62;&#62;</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Using GNOME Time Tracker</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Additional GNOME Time Tracker Dialogs</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>