<?xml version="1.0"?>
  <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
    <!ENTITY legal SYSTEM "legal.xml">
    <!ENTITY appversion "1.99">
    <!ENTITY manrevision "2.0">
    <!ENTITY date "July 2002">
    <!ENTITY app "Goats">
  ]>

  <!-- 
       (Do not remove this comment block.)
   Maintained by the GNOME Documentation Project
   http://developer.GNOME.org/projects/gdp
   Template version: 2.0 beta
   Template last modified Jan 30, 2002
  -->

 <!-- =============Document Header ============================= -->

  <article id="index" lang="en">
 
 <!-- please do not change the id; for translations, change lang to -->
 <!-- appropriate code -->

    <articleinfo> 
      <title>&app; Manual V&manrevision;</title>
 	<copyright> 
 	  <year>2002</year>
 	  <holder>M S Craig</holder> 
        </copyright>
 
 <!-- translators: uncomment this:
 
        <copyright>
          <year>2002</year>
          <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
        </copyright>
 
    -->
 	&legal; 
 	<authorgroup> 
 	  <author> 
 	    <firstname>Martin</firstname>
            <surname>Craig</surname> 
          </author>
 
 <!-- This is appropriate place for other contributors: translators,
       maintainers,  etc. Commented out by default.
          <othercredit role="translator">
 	    <firstname>Latin</firstname> 
 	    <surname>Translator 1</surname> 
 	    <affiliation> 
 	      <orgname>Latin Translation Team</orgname> 
 	      <address> <email>translator@gnome.org</email> </address> 
 	    </affiliation>
 	    <contrib>Latin translation</contrib>
          </othercredit>
 -->

 	</authorgroup>
 
 
 <!-- According to GNU FDL, revision history is mandatory if you are -->
 <!-- modifying/reusing someone else's document.  If not, you can omit it. -->

 	<revhistory>

 <!-- Remember to remove the &manrevision; entity from the revision entries other
      than the current revision. -->
 	  <revision> 
            <revnumber>&app; Manual V&manrevision;</revnumber>
            <date>&date;</date> 
 	    <revdescription> 
 	      <para role="author">Martin Craig
 		<email>martin@menudo.freeserve.co.uk</email> 
              </para>
            </revdescription>
          </revision>
 	</revhistory>
      <releaseinfo> This manual describes version &appversion; of &app;.</releaseinfo>
      <legalnotice> 
        <title>Feedback</title>
        <para>For feedback, please contact the author.
        </para>

 <!-- Translators may also add here feedback address for translations -->
      </legalnotice>
    </articleinfo>
 
    <indexterm>
      <primary>goats</primary>
    </indexterm>
 
 <!-- ============= Document Body ============================= -->
 <!-- ============= Introduction ============================== -->

    <sect1 id="goats-intro"> 
      <title>Introduction</title>
      <para>
        <application>&app;</application> gives you post-it notes on your Gnome desktop.
      </para>
      <para>
        You can use <application>&app;</application> to make write notes to yourself, set alarms to remind you of 
        appointments, and keep important pieces of information on your desktop.
      </para>
      <para>
        All your notes are saved and recreated when you log in or when you restart the program.
      </para> 
    </sect1>

 <!-- ============= Getting Started =========================== -->

    <sect1 id="goats-getting-started"> 
      <title>Getting Started</title>
 
 <!-- ============= To Start goats ============================ -->

      <sect2 id="goats-to-start"> 
      <title>Starting &app;</title>
      <para>
        To add <application>&app;</application> to a panel click the right mouse button on the panel 
        to open the <guimenu>Panel</guimenu> menu, then choose 
        <menuchoice> 
          <guimenu>Add to panel</guimenu> 
          <guisubmenu>Utility</guisubmenu> 
          <guimenuitem>Sticky Notes</guimenuitem> 
        </menuchoice>.
        The Goats applet should appear on your panel.
      </para>

<!-- ==== Figure ==== -->
        <figure id="goats-applet-fig"> 
          <title>The Goats applet</title>
          <screenshot> 
            <mediaobject> 
              <imageobject> 
                <imagedata fileref="figures/applet.png" format="PNG"/>
              </imageobject>
              <textobject> 
                <phrase>The Goats applet</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
        </figure>
 <!-- ==== End of Figure ==== -->

      <para>
        The first time you start Goats, you will also receive a welcoming message!
      </para>
    </sect2>

 <!-- ============= To create a note ============================ -->

    <sect2 id="goats-create-note"> 
      <title>Creating a note</title>
      <para>
        To create a new note, click the left mouse button on the &app; applet
      </para>

<!-- ==== Figure ==== -->
        <figure id="goats-note-fig"> 
          <title>A note</title>
          <screenshot> 
            <mediaobject> 
              <imageobject> 
                <imagedata fileref="figures/note.png" format="PNG"/>
              </imageobject>
              <textobject> 
                <phrase>A note</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
        </figure>
 <!-- ==== End of Figure ==== -->

      <para>
        Move the mouse pointer into the note and type some text. You can move the note around 
        the screen by dragging with the left mouse button on the darker bar at the top of the note. 
        You can also resize the note by dragging the upper left corner of the note. Finally you can 
        delete the note by clicking the left button on the cross in the upper right hand corner of 
        the note
      </para>
    </sect2>
  </sect1>
 
 <!-- ============= Further use of Goats ============================ -->
 
  <sect1 id="goats-furtherd"> 
    <title>Further use of Goats</title>
 
 <!-- ============= The note menu ============================ -->
 
    <sect2 id="goats-note-properties">
      <title>The note menu</title>
      <para>
        Click with the right mouse button anywhere in the note to show the menu.
      </para>

<!-- ==== Figure ==== -->
        <figure id="goats-note-menu-fig"> 
          <title>The Note menu</title>
          <screenshot> 
            <mediaobject> 
              <imageobject> 
                <imagedata fileref="figures/note_menu.png" format="PNG"/>
              </imageobject>
              <textobject> 
                <phrase>The Note menu</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
        </figure>
 <!-- ==== End of Figure ==== -->

      <menuchoice>
        <guimenuitem>New note</guimenuitem>
      </menuchoice>
      <para>
        Select this to create a new note
      </para>
      <menuchoice>
        <guisubmenu>Text</guisubmenu>
        <guimenuitem>Save</guimenuitem>
      </menuchoice>
      <para>
        Select this to save the text in your note to a file. You will be prompted for 
        a file name.
      </para>
      <menuchoice>
        <guisubmenu>Text</guisubmenu>
        <guimenuitem>Cut/Copy/Paste</guimenuitem>
      </menuchoice>
      <para>
        Cut/Copy/Paste the text selected in the note.
      </para>
      <menuchoice>
        <guisubmenu>Text</guisubmenu>
        <guimenuitem>Print</guimenuitem>
      </menuchoice>
      <para>
        Select this to send the note to the printer.
      </para>
      <menuchoice>
        <guisubmenu>Text</guisubmenu>
        <guimenuitem>Mail</guimenuitem>
      </menuchoice>
      <para>
        Select this to send the text of the note as an email.
      </para>
      <menuchoice>
        <guisubmenu>Text</guisubmenu>
        <guimenuitem>IP Message</guimenuitem>
      </menuchoice>
      <para>
        Select this to send the text of the note to someone else using IP
        Messager (you will need to install the IP Messager program for this to work)
      </para>
      <menuchoice>
        <guisubmenu>Text</guisubmenu>
        <guimenuitem>Clear</guimenuitem>
      </menuchoice>
      <para>
        Select this delete all text from the note
      </para>
      <menuchoice>
        <guisubmenu>Set</guisubmenu>
        <guimenuitem>Title</guimenuitem>
      </menuchoice>
      <para>
        Select this to change the title of the note. The title is displayed
        in the top part of the note
      </para>
      <menuchoice>
        <guisubmenu>Set</guisubmenu>
        <guimenuitem>Alarm</guimenuitem>
      </menuchoice>
      <para>
        Select this to set an alarm for the note. Setting an alarm is described
        in more detail in the <xref linkend="goats-set-alarm"/> section
      </para>
      <menuchoice>
        <guisubmenu>Insert</guisubmenu>
        <guimenuitem>File</guimenuitem>
      </menuchoice>
      <para>
        Select this to insert the contents of a text file into the note. You
        will be prompted to select a file.
      </para>
      <menuchoice>
        <guisubmenu>Insert</guisubmenu>
        <guimenuitem>Time</guimenuitem>
      </menuchoice>
      <para>
        Select this to insert the current time into the note
      </para>
      <menuchoice>
        <guisubmenu>Insert</guisubmenu>
        <guimenuitem>Date</guimenuitem>
      </menuchoice>
      <para>
        Select this to insert the current date into the note
      </para>
      <menuchoice>
        <guisubmenu>Insert</guisubmenu>
        <guimenuitem>Calendar</guimenuitem>
      </menuchoice>
      <para>
        Select this to insert a calendar for the current month into the note.
        Note that this will look best with a fixed width font
      </para>
      <menuchoice>
        <guisubmenu>Insert</guisubmenu>
        <guimenuitem>Fortune</guimenuitem>
      </menuchoice>
      <para>
        Select this to insert a random quote, fortune or piece of wisdom into the note
      </para>
      <menuchoice>
        <guisubmenu>Properties</guisubmenu>
        <guimenuitem>Autosize</guimenuitem>
      </menuchoice>
      <para>
        Select this to make your note just wide enough to contain the the text
      </para>
      <menuchoice>
        <guisubmenu>Properties</guisubmenu>
        <guimenuitem>Note colour</guimenuitem>
      </menuchoice>
      <para>
        Select this to change the background colour of the note
      </para>
      <menuchoice>
        <guisubmenu>Properties</guisubmenu>
        <guimenuitem>Text colour</guimenuitem>
      </menuchoice>
      <para>
        Select this to change the colour of the text in the note
      </para>
      <menuchoice>
        <guisubmenu>Properties</guisubmenu>
        <guimenuitem>Font</guimenuitem>
      </menuchoice>
      <para>
        Select this to change the font that the text appears in
      </para>
      <menuchoice>
        <guimenuitem>Raise</guimenuitem>
      </menuchoice>
      <para>
        Select this to raise the note above the other windows
      </para>
      <menuchoice>
        <guimenuitem>Lower</guimenuitem>
      </menuchoice>
      <para>
        Select this to lower the note below the other windows
      </para>
      <menuchoice>
        <guimenuitem>Stick/Unstick</guimenuitem>
      </menuchoice>
      <para>
        Select "Stick" to make the note appear on all workspaces
      </para>
      <menuchoice>
        <guimenuitem>Shade/Unshade</guimenuitem>
      </menuchoice>
      <para>
        Select "Shade" to make the text area of the note disappear
        leaving only the top bar and title. This may be useful to save space on your desktop
      </para>
      <menuchoice>
        <guimenuitem>Hide</guimenuitem>
      </menuchoice>
      <para>
        Select this to make the note disappear without being deleted. You can
        get it back by selecting "Show All" from the Applet menu or using the Summary
        dialog
      </para>
      <menuchoice>
        <guimenuitem>Delete</guimenuitem>
      </menuchoice>
      <para>
        Select this to permanently delete the note
      </para>
    </sect2>
 
 <!-- ============= Setting an alarm ============================ -->
 
    <sect2 id="goats-set-alarm"> 
      <title>Setting an alarm</title>
      <para>
        To set an alarm on a note, select "Alarm" from the "Set" submenu of the note menu. 
        The Set Alarm dialog box will appear.
      </para>
 
 <!-- ==== Figure ==== -->
      <figure id="goats-alarm-dialog"> 
        <title>Set Alarm dialog</title>
        <screenshot>
          <mediaobject> 
 	    <imageobject> 
 	      <imagedata fileref="figures/alarm.png" format="PNG"/>
 	    </imageobject>
 	    <textobject> 
              <phrase>The Set Alarm dialog</phrase>
 	    </textobject> 
          </mediaobject>
        </screenshot>
      </figure>
 <!-- ==== End of Figure ==== -->
 
      <variablelist> 
        <varlistentry> 
          <term>Alarm on?</term> 
 	  <listitem> 
 	    <para>
              This selects whether the alarm is active or not. Click here to turn
              the alarm on and off
            </para>
          </listitem>
        </varlistentry>
        <varlistentry> 
          <term>Remind me at...</term> 
          <listitem> 
            <para>
              Type the date you would like the alarm to be set for in the box, or
              click the "Calendar" button to choose a day from the pop up calendar
            </para>
            <para>
              Enter a time for the alarm to go off in the next box, or press the button 
              to choose a time from the menu
            </para>
            <para>
              If you would like the alarm to be repeated at a fixed interval, select the repeat
              from the option menu
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Display a message</term> 
          <listitem> 
            <para>
              If you change this to "Pop up the note", when the alarm is triggered the note will
              pop up above your other windows so you can see it. If you select "Display a message", 
              a window will pop up containing the message given in the text entry
            </para>
          </listitem>
        </varlistentry>
        <varlistentry> 
          <term>Play sound</term> 
          <listitem> 
            <para>
              Click here to choose whether or not to play a sound when the alarm is triggered. You can
              change the sound to be played by typing a file name in the text entry, or clicking on "Browse" 
              to choose a sound file
            </para>
          </listitem>
        </varlistentry>
      </variablelist> 
    </sect2>
 
 <!-- ============= The applet menu ============================ -->
 
    <sect2 id="goats-applet-menu"> 
      <title>The Applet Menu</title>
      <para>
        Click with the right mouse button on the applet to show the applet menu. These options
        relate to the Goats program and all of your notes.
      </para>

<!-- ==== Figure ==== -->
        <figure id="goats-applet-menu-fig"> 
          <title>The Applet menu</title>
          <screenshot> 
            <mediaobject> 
              <imageobject> 
                <imagedata fileref="figures/applet_menu.png" format="PNG"/>
              </imageobject>
              <textobject> 
                <phrase>The Applet menu</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
        </figure>
 <!-- ==== End of Figure ==== -->

      <menuchoice>
        <guimenuitem>Preferences</guimenuitem>
      </menuchoice>
      <para>
        Select this to change the behaviour of Goats (see <xref linkend="goats-customize"/>)
      </para>
      <menuchoice>
        <guimenuitem>Help</guimenuitem>
      </menuchoice>
      <para>
        Select this to display this document
      </para>
      <menuchoice>
        <guimenuitem>About</guimenuitem>
      </menuchoice>
      <para>
        Select this to display some information about Goats
      </para>
      <menuchoice>
        <guisubmenu>My Goats</guisubmenu>
        <guimenuitem>Summary</guimenuitem>
      </menuchoice>
      <para>
        Select this to display a summary of all of your notes in the form of a table. Click the left mouse
        button on a row to select it. Click the right mouse button for a menu allowing you to easily raise,
        lower, hide, delete or cancel the alarm on the selected note.
      </para>
      <menuchoice>
        <guisubmenu>My Goats</guisubmenu>
        <guimenuitem>....... All</guimenuitem>
      </menuchoice>
      <para>
        These options allow you to raise, lower, show, hide, shade, unshade and delete all of your notes
      </para>
    </sect2>
 
 <!-- ============= Customizing Goats ============================ -->
 
    <sect2 id="goats-customize">
      <title>Customizing Goats</title>
        <para>Select "preferences" from the applet menu to customize the behaviour of Goats</para>
 
 <!-- ==== Figure ==== -->
        <figure id="goats-defaults-dialog"> 
          <title>Defaults</title>
          <screenshot> 
            <mediaobject> 
              <imageobject> 
 	        <imagedata fileref="figures/defaults.png" format="PNG"/>
              </imageobject>
              <textobject> 
                <phrase>The Preferences dialog (Defaults tab)</phrase>
              </textobject> </mediaobject>
          </screenshot>
        </figure>
 <!-- ==== End of Figure ==== -->
 
        <variablelist> 
          <varlistentry> 
            <term>Size</term> 
 	    <listitem> 
              <para>The height and width of new notes, in pixels</para>
            </listitem>
          </varlistentry>
          <varlistentry> 
            <term>Note colour</term> 
            <listitem> 
              <para>
                The background colour of new notes. You can choose one of three
                options, or "Random" to choose one of them at random each time
              </para>
              <para>Click on "Customize" to modify the colours</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>Font</term> 
              <listitem> 
                <para>The text font used in new notes</para>
              </listitem>
          </varlistentry>
          <varlistentry>
            <term>Text colour</term> 
            <listitem> 
              <para>The text colour in new notes</para>
            </listitem>
          </varlistentry>
          <varlistentry> 
            <term>Alarm sound</term> 
            <listitem> 
              <para>
                Use the check button to choose if a new alarm is automatically set to 
                play a sound. You can change the default alarm sound by typing the file name
                in the text entry, or clicking "Browse" to choose a sound file
              </para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>Notes appear on all workspaces</term> 
            <listitem> 
              <para>
                Determines whether new notes appear on all workspaces or just the one 
                they were created on
              </para>
            </listitem>
          </varlistentry>
        </variablelist>
 
 <!-- ==== Figure ==== -->
        <figure id="goats-options-dialog"> 
          <title>Settings</title>
          <screenshot> 
            <mediaobject> 
              <imageobject> 
                <imagedata fileref="figures/options.png" format="PNG"/>
              </imageobject>
              <textobject> 
                <phrase>The Preferences dialog (Options tab)</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
        </figure>
 <!-- ==== End of Figure ==== -->
 
        <variablelist> 
          <varlistentry> 
            <term>"Date" command</term> 
            <listitem> 
              <para>
                This command is executed when the 
                <menuchoice>
                  <guisubmenu>Insert</guisubmenu> 
                  <guimenuitem>Date</guimenuitem>
                </menuchoice> 
                menu item is selected
              </para>
            </listitem>
          </varlistentry>
          <varlistentry> 
            <term>"Calendar" command</term> 
            <listitem> 
              <para>
                This command is executed when the 
                <menuchoice>
                  <guisubmenu>Insert</guisubmenu> 
                  <guimenuitem>Calendar</guimenuitem>
                </menuchoice> 
                menu item is selected
              </para>
            </listitem>
          </varlistentry>
          <varlistentry> 
            <term>"Fortune" command</term> 
            <listitem> 
              <para>
                This command is executed when the 
                <menuchoice>
                  <guisubmenu>Insert</guisubmenu> 
                  <guimenuitem>Fortune</guimenuitem>
                </menuchoice> 
                menu item is selected
              </para>
            </listitem>
          </varlistentry>
          <varlistentry> <term>Delete/Hide button function</term> 
            <listitem> 
              <para>
                This controls whether the button in the upper right corner of the note
                deletes or hides the note when pressed. The symbol for delete is a cross, for 
                hide it is looks a bit like something disappearing.
              </para>
            </listitem>
          </varlistentry>
        </variablelist>
      </sect2>
    </sect1>
  </article>
