<?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 appversion "0.99.3"> 
<!ENTITY manrevision "2.0">
<!ENTITY date "July 2003">
<!ENTITY app "GnomeICU">
]>

<!-- 
      (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 Feb 12, 2002
-->

<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>2003</year>
   <holder>Christopher Ness</holder>
  </copyright>
  <copyright>
   <year>2001</year>
   <holder>Thomas Canty, Ilya Konstantinov, Trevor Curtis</holder>
  </copyright>

  <!-- translators: uncomment this:

  <copyright>
   <year>2000</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->

<!-- An address can be added to the publisher information.  If a role is
     not specified, the publisher/author is the same for all versions of the
     document.  -->

<!-- GDP has not looked at this file to approve it yet, besides, I did all
     the publishing.  :)  CN 
    <publisher>
      <publishername> GNOME Documentation Project </publishername>
    </publisher>
-->

  <!-- do not put authorname in the header except in copyright - use
  section "authors" below -->

  <legalnotice>
   <para>
    Permission is granted to copy, distribute and/or modify this
    document under the terms of the <citetitle>GNU Free Documentation
    License</citetitle>, 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. You may obtain a copy
    of the <citetitle>GNU Free Documentation 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:
    Free Software Foundation, Inc., 59 Temple Place - Suite 330,
    Boston, MA 02111-1307, USA.
   </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>

  <authorgroup>
   <author>
        <firstname>Thomas</firstname>
        <surname>Canty</surname>
        <affiliation>
          <address> <email>tommydal@ihug.com.au</email> </address>
        </affiliation>
   </author>
   <author>
        <firstname>Ilya</firstname>
        <surname>Konstantinov</surname>
        <affiliation>
          <address> <email>gnomeicu-docs@future.galanet.net</email> </address>
        </affiliation>
   </author>
   <othercredit role="maintainer">
        <firstname>Christopher</firstname>
        <surname>Ness</surname>
        <affiliation>
          <orgname>Documentation Team</orgname>
          <address> <email>nesscg@mcmaster.ca</email> </address>
        </affiliation>
   </othercredit>
<!-- This is appropriate place for other contributors: translators,^M
      maintainers,  etc. Commented out by default.^M
       <othercredit role="translator">^M
        <firstname>Latin</firstname> ^M
        <surname>Translator 1</surname> ^M
        <affiliation> ^M
          <orgname>Latin Translation Team</orgname> ^M
          <address> <email>translator@gnome.org</email> </address> ^M
        </affiliation>^M
        <contrib>Latin translation</contrib>^M
      </othercredit>^M
-->^M
  </authorgroup>

<!-- According to GNU FDL, revision history is mandatory if you are
     modifying/reusing someone else's document.  If not, you can omit it.
     Remember to remove the &manrevision; entity from the revision entries other
     than the current revision. -->

<!-- The revision numbering system for GNOME manuals is as follows:
      * the revision number consists of two components
      * the first component of the revision number reflects the release 
        version of the GNOME desktop.
      * the second component of the revision number is a decimal unit that 
        is incremented with each revision of the manual.
     For example, if the GNOME desktop release is V2.x, the first version of the 
     manual that is written in that desktop timeframe is V2.0, the second version
     of the manual is V2.1, etc.

     When the desktop release version changes to V3.x, the revision number of the
     manual changes to V3.0, and so on. -->  

  <revhistory>
   <revision>
    <revnumber>&app; Manual V1.0</revnumber>
    <date>27 July, 2003</date>
    <revdescription>
      <para role="author">Christopher Ness
      <email>nesscg@mcmaster.ca</email>
      </para>
<!--  <para role="publisher">GNOME Documentation Project</para> -->
    </revdescription>
    <revremark>Major overhaul of all sections.  New screenshots for Gnome2.2 and
               lots of little changes to style, tips and overall readability of
               the document.
    </revremark>
   </revision>
   <revision>
    <revnumber>&app; Manual V0.2</revnumber>
    <date>7 October, 2000</date>
    <revdescription>
<!--  <para role="publisher">GNOME Documentation Project</para> -->
    </revdescription>
    <revremark>Style corrections, tips and changes to accomodate new developments</revremark>
   </revision>
  </revhistory>                                                                             
  <releaseinfo>
       This manual describes version &appversion; of &app;.
  </releaseinfo>
  <legalnotice>
    <title>Feedback</title>
    <para>To report a bug or make a suggestion regarding the &app; 
          application or this manual, follow the directions in the
          <ulink url="ghelp:gnome-feedback" 
           type="help">GNOME Feedback Page</ulink>.
    </para>
<!-- Translators may also add here feedback address for translations -->
  </legalnotice>
 </articleinfo>

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

 <!-- ============= Introduction ============================== -->
 <sect1 id="intro">
  <title>Introduction</title>

  <para>
   <application>&app;</application> is a <ulink url="http://www.gnome.org">GNOME</ulink>
   application for connecting to AOL's
   <ulink url="http://www.icq.com">ICQ&reg; instant messaging service</ulink>
   or any other ICQ server.
   <application>&app;</application> is an alternative to the original
   <application>ICQ</application> application by ICQ Inc. and
   strives for compatibility with it. Currently, it is based
   on the ICQ v5 protocol (following specifications by
   Matthew Smith), which is equivalent to the protocol used
<!-- Is this protocal information still correct?  CN -->
   in the <application>ICQ99b</application> application.
  </para>
  
  <para>  
   The ICQ instant messaging service is free for all users.
   It allows you to keep in touch with people around the world
   via messages which they receive immediately if they're online.
   This is very similar to the traditional "pager" device.

   <application>&app;</application> notifies you when your friends
   go online and allows you to communicate with them,
   via text messages, chats and by sending files.
  </para>

  <para>
   To run <application>&app;</application>, select
   <guimenuitem>&app;</guimenuitem> from the
   <guisubmenu>Internet</guisubmenu> submenu of the <guimenu>Main
   Menu</guimenu>, or type <command>gnomeicu</command> on the
   command line.
  </para>

  <para>
   This document describes version
   &appversion; of <application>&app;</application>.
  </para>

 </sect1>


 <!-- ================ Usage ================================ -->
 <!-- This section should describe basic usage of the application. -->

 <sect1 id="starting">
  <title>Starting up</title>
  <para>
   This section details the first steps you need to take to use 
   <application>GnomeICU</application>.
  </para>

  <para>
   Each ICQ user has a Universal Internet Number, or UIN, that is unique to 
   that user only.  The UIN is used to identify themselves and link other 
   information, such as nickname and e-mail address to themselves. 
   To communicate with other ICQ users, you need to register and receive an 
   ICQ UIN.
  </para>
  
  <para>
   <note>
    <para>
     This section refers to AOL's official ICQ service. If you intend to 
     use a standalone ICQ server, e.g. one provided by your company for 
     internal communications, the procedure may differ.
    </para>
   </note>
     
   To sign-up for a UIN you will be presented with a wizard that will walk
   you through the steps.  You will have the choice of creating a new UIN
   or using an existing one that you know the password for.
  </para>

  <para> 
   Now you are ready to use all features of ICQ.
   To learn how to use them, read the next sections.
  </para>
 </sect1>
  
 <sect1 id="basics">
  <title>GnomeICU basics</title>

<!-- deleted screenshot brought back by CN -->

 <figure id="mainwindow">
   <title>The Main Window</title>
   <screenshot>
     <mediaobject>
       <imageobject>
         <imagedata fileref="figures/mainwindow.png" format="PNG"/>
       </imageobject>
       <textobject>
         <phrase>The main window of <application>GnomeICU</application> is
                 the hub of activity.  All incoming communications, status and
                 your online contacts will be shown here.</phrase>
       </textobject>
     </mediaobject>
   </screenshot>
 </figure>

   
  <sect2 id="icq-basics">
   <title>Glossary</title>
   
   <para>   
    <itemizedlist>

     <listitem>
      <para>
       <emphasis>Contact List</emphasis>
       
       In the <interface>Main window</interface>, you see a list of people
       (or "contacts") which is called a "Contact List". Those are usually
       people you know and wish to remain in contact with.  This list is also 
       called a 'Buddy List' in similar instant messaging applications.
      </para>
     </listitem>

     <listitem>
      <para>
       <emphasis>Status</emphasis>
       
       When a user is not connected to ICQ, his/her status is <emphasis>Offline</emphasis>.
       When a user is connected to ICQ, his/her status is one of the following:
       <itemizedlist>
         <listitem>
          <para>
           <emphasis>Online</emphasis>

           You may contact the user.
          </para>
         </listitem>

         <listitem>
          <para>
           <emphasis>Free For Chat</emphasis>
          </para>
         </listitem>
                                                                                   
         <listitem>
          <para>
           <emphasis>Away</emphasis>

           The user is currently away from the computer),
          </para>
         </listitem>
                                                                                   
         <listitem>
          <para>
           <emphasis>Not Available</emphasis>

           The user may be away from the computer for a long time.
          </para>
         </listitem>
                                                                                   
         <listitem>
          <para>
           <emphasis>Occupied</emphasis>
          </para>
         </listitem>
                                                                                   
         <listitem>
          <para>
           <emphasis>Do Not Disturb</emphasis>
          </para>
         </listitem>
                                                                                   
         <listitem id="lstitm_invisible">
          <para>
           <emphasis>Invisible</emphasis>
          </para>
         </listitem>
                                                                                   
       </itemizedlist>
      </para>
      
      <para>
       The icon beside each name show the person's status.
       The Contact List contains an <interface>Online</interface> tab, which
       contains <emphasis>only</emphasis> contacts which are connected and are
       in a state that is not Invisible.  The <interface>All Contacts</interface>
       tab contains every contact on your list.

       <note>
        <para>
          Two special groups exist in the <interface>All Contacts</interface> tab.
          <itemizedlist>
            <listitem>
             <para>
              <emphasis>Waiting for authorization</emphasis>

              Contacts who you have asked to add to your list.  These users have
              not authorized you to do so yet.  These users will remain in this
              list indefinitly until they authorize you to add them.
             </para>
            </listitem>

            <listitem>
             <para>
              <emphasis>New Users</emphasis>

              Contacts who write to you in your current session but you do
              not have on your list.  These contacts are not remembered if
              you close &app;.
             </para>
            </listitem>
          </itemizedlist>
        </para>
       </note>

      </para>
     </listitem>

     <listitem>
      <para>
       <emphasis>Invisible user</emphasis>

       By setting your status to Invisible, others would not know you went online
       until you send them an event (e.g. a message, a chat request etc.).
       If you see a user with an Invisible status, that means the other user
       in Invisible mode and either has contacted you or has you in his/her
       Visible List.
      </para>
     </listitem>

    </itemizedlist>
   </para>
  </sect2>

<!-- Is this going to be cut out of the helpfile?  
  <sect2>
   <title>Performing ICQ operations</title> -->

<!-- deleted screenshot -->
<!--   <para>
    <tip>
     <title>Performing ICQ operations with the keyboard only</title>
     <para>
      You can perform most ICQ operations with the keyboard by selecting
      a contact from the list with the <keycap>Up</keycap> and <keycap>Down</keycap>
      buttons, and then pressing <keycombo><keycap>Alt</keycap><keycap>Space</keycap></keycombo>
      to open the popup menu and selecting a menu item with the <keycap>Up</keycap> and
      <keycap>Down</keycap> keys.
     </para>
    </tip>
   </para>

   <para>
    <itemizedlist>
     <listitem>
      <para>
       To add a contact to your list, see <xref linkend="contact"/>.
      </para>
     </listitem>

     <listitem>
      <para>
       To send a message over ICQ, see <xref linkend="message"/> 
      </para>
     </listitem>

     <listitem>
      <para>
      To send a file over ICQ, see <xref linkend="file"/>.
      </para>
     </listitem>

     <listitem>
      <para>
      To send a URL over ICQ, see <xref linkend="URL"/>.
      </para>
     </listitem>

     <listitem>
      <para>
      To chat with someone over ICQ, see <xref linkend="chat"/>.
      </para>
     </listitem>
    </itemizedlist>
   </para>
  </sect2> -->
  <sect2 id="notification-icon">
   <title>The Notification Icon</title>
   <para>
    <application>&app;</application> uses the 
    <interface>Notification Area</interface> which is an applet that is part
    of the Gnome Desktop.  A <interface>Notification Area</interface> can be
    added to any panel.
   </para>

 <figure id="notifyicon">
   <title>Notification Icon - Two Forms</title>
   <screenshot>
     <mediaobject>
       <imageobject>
         <imagedata fileref="figures/notificationicon.png" format="PNG"/>
       </imageobject>
       <textobject>
         <phrase>The Notification Icon in <application>&app;</application> 
                 alerts the user to new messages and allows a change of status.
         </phrase>
       </textobject>
     </mediaobject>
   </screenshot>
 </figure>

   <para>
    The <emphasis>Notification Icon</emphasis> which is shown above allows
    basic control of <application>&app;</application>.  It displays the current
    state of <application>&app;</application> and becomes animated when a 
    message is waiting.  It also will tell you the number of users currently
    online in your contact list.
   </para>
   <para>
    Clicking this icon in the
    <interface>Notification Area</interface> will show and hide the 
    <interface>Main Window</interface> respectivly.
   </para>

   <tip>
    <title>Notification Tooltips</title>
    <para>
     Try moving your mouse cursor over the <application>&app;</application> 
     Notification Icon for a few seconds to receive quick information about 
     the status (without clicking or opening any windows). As soon as
     you move the mouse cursor away from the applet, the "tooltip" dispappers.
    </para>
   </tip>
  </sect2>

  <sect2 id="panel-applet">
   <title>The Panel Applet</title>
   <para> 
    <application>&app;</application> no longer supports the panel applet.  It is
    depreciated as of version 0.99. 
   </para>
  </sect2>


  <!-- This section should also describe main elements of graphic user
       interface, such as menus and buttons, unless this description
       is too long - in that case, it should be moved to a separate
       section. For example -->


  <!-- ========= Menus =========================== -->
  <sect2 id="menubar">
   <title>Menus</title>
   <para>
    The menu bar, located at the top of the <interface>Main
    Window</interface>, contains the following menus:
   </para>

   <variablelist>
    <varlistentry>
     <term><guimenu>Account</guimenu></term>
      <listitem>
       <para>
	This menu contains:
	<itemizedlist>
	 <listitem>
	  <para>
	   <guimenuitem>Add Contact</guimenuitem>
	    this command brings up the <link linkend="contact">Add Contact</link> 
        dialog, which allows a user to add a contact to their contact list.
	  </para>
         </listitem>
	 <listitem>
	  <para>
        <guimenuitem>Manage Groups</guimenuitem>
         this command brings up the Manage Groups dialog,
         showing a list of groups that are available in your contact list.
         You can add a new group, rename an old group or remove a group
	  </para>
	 </listitem>
     <listitem>
      <para>
       <guimenuitem>Change Account Info</guimenuitem>
       this command brings up the <link linkend="accountinfo">My Information</link> 
       dialog, which allows you to add and change your personal information 
       in the ICQ user directory.
      </para>
     </listitem>
     <listitem>
      <para>
       <guimenuitem>Exit</guimenuitem>
       this command exits <application>&app;</application> and removes the icon
       in the <link linkend="notification-icon"><interface>notification area</interface></link>.
      </para>
     </listitem>
    </itemizedlist> 
   </para>
  </listitem>
  </varlistentry>

    <varlistentry>
     <term><guimenu>Tools</guimenu></term>
     <listitem>
      <para>
       This menu contains:
       <itemizedlist>
        <listitem>
         <para>
          <guimenuitem>Ignore List</guimenuitem>
           this command brings up the ignore list dialog, which 
           allows users to add contacts to their ignore list.  You will not
           recieve messages from these users.
         </para>
        </listitem>
        <listitem>
         <para>
          <guimenuitem>Visible List</guimenuitem>
           this command brings up the visible list dialog, which 
           allows users to add contacts to their visible list.  Users on this
           list will be able to view your status even when you are in
           <interface>invisible</interface> mode.
         </para>
        </listitem>
	<listitem>
	 <para>
	  <guimenuitem>Invisible List</guimenuitem>
	   this command brings up the invisible list dialog, which 
       allows users to add contacts to their invisible list.  Users on this
       list will <emphasis>always</emphasis> see the user as 
       <interface>invisible</interface>.
         </para>
        </listitem>
	<listitem>
	 <para>
	  <guimenuitem>Online Notify List</guimenuitem>
           this command brings up the online notify list dialog, which 
          allows users to add contacts to their online notify list.
	 </para>
	</listitem>
    <listitem>
     <para>
      <guimenuitem>Preferences</guimenuitem>
        this command brings up the 
        <link linkend="prefs"><interface>&app; Preferences</interface></link>
        dialog, which allows users to modify <application>&app;</application>
        configuration settings.
     </para>
    </listitem>


       </itemizedlist>
      </para>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term><guimenu>Help</guimenu></term>
     <listitem>
      <para>
       This menu contains:
       <itemizedlist>
        <listitem>
         <para>
          <guimenuitem>Contents</guimenuitem>
           shows this manual.
         </para>
        </listitem>

        <listitem>
         <para>
          <guimenuitem>&app; Home</guimenuitem>
           opens the default web browser to the &app;
           <ulink url="http://gnomeicu.sourceforge.net/index.php">home page</ulink> 
           on the Internet.
         </para>
        </listitem>
                                                                                
        <listitem>
         <para>
          <guimenuitem>&app; Updates</guimenuitem>
           opens the default web browser to the &app;
           <ulink url="http://gnomeicu.sourceforge.net/updates.php">download page</ulink>
           on the Internet.
         </para>
        </listitem>

        <listitem>
         <para>
          <guimenuitem>About</guimenuitem>
           shows general information about
          <application>&app;</application>, such as
          the authors' names and the application version number.
         </para>
        </listitem>
       </itemizedlist>

      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </sect2>
 </sect1>

 <sect1 id="operations">
  <title>ICQ Operations</title>
  <sect2 id="message">
   <title>Sending a Message</title>
 
   <para> 
    To send a message over ICQ, either double-click on a contact or 
    right-click on a contact and select <guimenuitem>Message...</guimenuitem>.
    The <interface>Send Message dialog</interface> shown in 
    <xref linkend="fig_message"/> 
    appears. Type a message and click the <guibutton>Send</guibutton> 
    button to send the message.

    <tip>
     <para>
      You can press <emphasis><keycombo><keycap>Ctrl</keycap><keycap>Enter</keycap></keycombo></emphasis> to quickly send the message.  Pressing <keycap>Esc</keycap> will close the window.
<!-- Don't think this statment is true for URL's -->
<!--      This accelerator key triggers Send in all <application>GnomeICU</application> dialogs. -->
     </para>
    </tip>

   </para>

<!-- new screenshot taken, 
     it's a little big using the default window size, so I shrunk
     the window down in the X direction.  CN -->

<figure id="fig_message">
   <title>Send Message Dialog</title>
   <screenshot>
     <mediaobject>
       <imageobject>
         <imagedata fileref="figures/messagedialog.png" format="PNG" srccredit="Christopher Ness"/>
       </imageobject>
       <textobject>
         <phrase>The Send Message Dialog in <application>GnomeICU</application> 
                 allows you to communicate with contacts in a chat-like fashion.                 </phrase>
       </textobject>
     </mediaobject>
   </screenshot>
 </figure>


  </sect2>
   
  <sect2 id="file">
   <title>Sending a File</title>

   <para>
    To send a file over ICQ, right-click on a contact and select 
    <guimenuitem>File Request...</guimenuitem>. The 
    <interface>Send File dialog</interface>
    shown in <xref linkend="fig_sendfile"/> appears. 
    <guibutton>Add Files...</guibutton>
    to add each file you wish to send to the contact.
    To remove files from the list, select the files you do not wish to send
    and click on <guibutton>Remove files</guibutton>.
    Finally, if necessary, enter a reason for sending the file.
   </para>
   <para>
    Click the <guibutton>Send</guibutton> button to send the files.
    The files are sent in the order of their appearance in the list,
    and the <interface>File Transfer</interface> dialog box displays
    the progress of the transfer.
   </para>

<!-- Screenshot -->
<figure id="fig_sendfile">
   <title>Send File Dialog</title>
   <screenshot>
     <mediaobject>
       <imageobject>
         <imagedata fileref="figures/sendfile.png" format="PNG" srccredit="Christopher Ness"/>
       </imageobject>
       <textobject>
         <phrase>The Send File dialog in <application>&app;</application>
                 allows you to transfer files with contacts.
         </phrase>
       </textobject>
     </mediaobject>
   </screenshot>
 </figure>

  </sect2>

  <sect2 id="URL">
   <title>Sending a URL</title>

   <para>
    You can use this functionality to send an <acronym>URL</acronym> 
    (Universal Resource Locator - another name for a web site address) 
    to other users. It's the preferred way of sending URLs,
    since the receiving user could easily see the URL in one click 
    (in most ICQ applications).
   </para>

   <para>
    To send a URL, right-click on a contact and select <guimenuitem>URL...</guimenuitem>.
    The <interface>Send URL dialog</interface> shown in <xref linkend="fig_sendurl"/>
    appears. Type in or paste the URL, and if necessary add a description. Click 
    the <guibutton>Send</guibutton> button to send the URL.
     
<!-- I couldn't get this "Feature" to work.  August 3, 2003  CN

     <tip>
        <title>Dragging a Link</title>
        <para>
         You can drag a link from your web browser to the contact in the <application>GnomeICU</application>
         to open a <interface>Send URL dialog</interface> with the URL of the link already typed in.
        </para>
     </tip> -->
   </para>

<!-- New Screenshot -->
<figure id="fig_sendurl">
   <title>Send URL Dialog</title>
   <screenshot>
     <mediaobject>
       <imageobject>
         <imagedata fileref="figures/sendurl.png" format="PNG" srccredit="Christopher Ness"/>
       </imageobject>
       <textobject>
         <phrase>The Send URL Dialog in <application>GnomeICU</application>
                 allows you to send links and a description to your contacts.
         </phrase>
       </textobject>
     </mediaobject>
   </screenshot>
 </figure>


  </sect2>
 
<!-- I didn't even know this existed...  CN

  <sect2 id="chat">
   <title>Chatting</title>
   <para>
    To chat with someone on your ICQ list, right-click on a contact and select 
    <guimenuitem>Chat Request</guimenuitem>. The <interface>Chat 
    Request dialog</interface>, shown in appears.
   </para>
-->
<!-- deleted a screenshot -->
<!--
   <para> 
    Type a reason for the chat and press the <guibutton>Send</guibutton> button
    to send the chat request. If the other user accepts the chat, the 
    <interface>Chat dialog</interface>, shown in appears.
    Otherwise, their reason for not accepting the chat request would appear.
   </para>
-->
<!-- deleted a screenshot -->
<!--  </sect2>
-->

  <sect2 id="sendcontactlist">
   <title>Sending a Contact List</title>
                                                                                                                                                             
   <para>
    To share members of <emphasis>your</emphasis> contact list with another
    member of your list, right-click on a contact and select
    <guimenuitem>Contact List...</guimenuitem>. The
    <interface>Send Contact List dialog</interface>
    shown in <xref linkend="fig_sendcontactlist"/> appears.
    To add a contact to this list drag them from your 
    <interface>Main Contact Window</interface> to the 
    <interface>Send Contact List dialog</interface>.
   </para>
   <para>
    <guibutton>Remove User...</guibutton>
    will remove the selected contact from the list.
    <guibutton>User's Info</guibutton> will display the highlighted users
    detailed information.
   </para>
   <para>
    Click the <guibutton>Send</guibutton> button to send the show contacts.
    The <guibutton>Close</guibutton> button will cancel this message.
   </para>
                                                                                                                                                             
<!-- Screenshot -->
<figure id="fig_sendcontactlist">
   <title>Send Contact List Dialog</title>
   <screenshot>
     <mediaobject>
       <imageobject>
         <imagedata fileref="figures/sendcontactlist.png" format="PNG" srccredit="Christopher Ness"/>
       </imageobject>
       <textobject>
         <phrase>The Send Contact List dialog in 
                 <application>&app;</application>
                 allows you to share contacts among friends.
         </phrase>
       </textobject>
     </mediaobject>
   </screenshot>
 </figure>

  </sect2>
 
 </sect1>

 <sect1 id="contact">
  <title>Adding a Contact</title>
  <para>
   To add a contact to your contact list, select
   <guimenuitem>Add Contact</guimenuitem> from the
   <guimenu>Account</guimenu> menu. The
   <interface>Add A Contact</interface> dialog, shown in 
     <xref linkend="fig_addcontactdruid"/> appears.
  </para>

<!-- Screenshot -->
<figure id="fig_addcontactdruid">
   <title>Add Contact Dialog</title>
   <screenshot>
     <mediaobject>
       <imageobject>
         <imagedata fileref="figures/addcontactdruid.png" format="PNG" srccredit="Christopher Ness"/>
       </imageobject>
       <textobject>
         <phrase>The Add Contact Dialog in
                 <application>&app;</application>
                 allows you to search the ICQ system for friends.
         </phrase>
       </textobject>
     </mediaobject>
   </screenshot>
 </figure>

  <para>
    To add a contact, enter information about the user in 
    <emphasis>at least</emphasis> one field
    (e.g. the UIN). After entering this information, click the 
    <guibutton>Find</guibutton> button. A list of all the contacts which fit 
    your search criteria are shown. Select the contact which you want to add 
    to your list. Click the <guibutton>Add</guibutton> button to add the 
    contact to your list. 
    
    <tip>
     <title>Narrowing Down Your Search</title>
     <para>
      The best way to locate an ICQ user is by his/her UIN. The UIN is unique
      and is guaranteed to return only one search result.
      Alternatively, you may give as many details as you know to narrow 
      down the search
      (it is likely you'll get many results for common names).
     </para>
    </tip>
  </para>
 </sect1>


 <!-- ============= Customization ============================= -->
 <!-- This is messy, I'm splitting up the customization into smaller -->
 <!-- chapters for each tab.                                         -->

 <sect1 id="preferences">
  <title>Customizing GnomeICU</title>

  <para>
   To access the <interface>Preferences dialog</interface>, select
   <guimenuitem>Preferences</guimenuitem> from the
   <guimenu>Tools</guimenu> menu. The
   <interface>Preferences dialog</interface>, shown in appears.
  </para>

<!-- Screenshot -->
<figure id="fig_prefdialog">
   <title>Add Contact Dialog</title>
   <screenshot>
     <mediaobject>
       <imageobject>
         <imagedata fileref="figures/prefdialog.png" format="PNG" srccredit="Christopher Ness"/>
       </imageobject>
       <textobject>
         <phrase>The <application>&app;</application> Preferences Dialog 
                 allows you to customize <application>&app;</application>.
         </phrase>
       </textobject>
     </mediaobject>
   </screenshot>
 </figure>

  <para>
   The GnomeICU Preferences Dialog has been split so that multiple
   IM services can be configured.  In the screen shot above, the user
   is modifying the global behaviour of <application>&app;</application>.
  </para>
  <para>
   To modify the options for ICQ simply click on the ICQ logo icon and you
   will be presented with a new set of tabs.  As new IM services are added
   new icons will become available to customize in the left pane.
  </para>

  <sect2 id="pref_GnomeICU_Prefs">
   <title><application>&app;</application> Global Preferences</title>
  
   <para>
     The tabs in the <application>&app;</application> Global Preferences
     are explained in this section.
     <itemizedlist>
      <listitem>
       <para>Connections</para>
      </listitem>
      <listitem>
       <para>Sounds/Events</para>
      </listitem>
      <listitem>
       <para>Status</para>
      </listitem>
      <listitem>
       <para>User Interface</para>
      </listitem>
      <listitem>
       <para>Themes</para>
      </listitem>
     </itemizedlist>
   </para>

    <sect3 id="Pref_Gicu_Connections">
     <title>Connections</title>
    
     <para>
      <itemizedlist>
       <listitem>
        <para>
         <guilabel>Connect to server on startup</guilabel> - When checked
         <application>&app;</application> will attempt to go online as soon 
         as the program is started without any user input.
        </para>
       </listitem>

       <listitem>
        <para>
         <guilabel>Automatically reconnect on forced disconnection</guilabel> -
         When checked <application>&app;</application> will try to reconnect
         to the server if it is disconnected.
        </para>
       </listitem>
     
       <listitem>
        <para>
         <guilabel>Automatically accept file transfers</guilabel> - When
         checked <application>&app;</application> will accept files from 
         contacts without any user prompting.
         <warning>
          <title>Automatically accept file transfers</title>
          <para>
       Be very careful when setting this option as you will receive all
       files from users automatically.  This can lead to security problems.
          </para>
         </warning>

        </para>
       </listitem>
      </itemizedlist>
     </para>
    </sect3>

    <sect3 id="Pref_Gicu_SoundsEvents">
    <title>Sounds/Events</title>
    
     <para>
      <itemizedlist>
     
       <listitem>
        <para>
         <guilabel>Enable Sounds</guilabel> - When checked 
         <application>&app;</application> will use sounds to alert you to new
         events.
        </para>
       </listitem>

       <listitem>
        <para>
         <guilabel>Enable sounds only when online</guilabel> - When checked
         this allows you to disable sounds notification when not in the 
         "Online" status (e.g. Occupied status).  This prevents sounds from 
         disturbing you or others when you're not available to receive messages.
        </para>
       </listitem>

       <listitem>
        <para>
         <guilabel>Enable beeps</guilabel> - When checked
         this makes <application>&app;</application> produce short beeps from 
         the built-in speaker of your computer. This might be useful on 
         computers without a real sound device, or if you do not wish to
         disturb others with sounds.
        </para>
       </listitem>

       <listitem>
        <para>
         <guilabel>Go To GNOME Sound Preferences</guilabel> - This button
         allows you to configure the sounds played for each event in 
         <application>&app;</application>.
        </para>
       </listitem>

       <listitem>
        <para>
         <guilabel>Run Program on Events</guilabel> - 
       This allows you to run an external program upon receiving various events,       such as receiving a message.
        </para>
       </listitem>
      </itemizedlist>

     </para>
    </sect3>

    <sect3 id="Pref_Gicu_Status">
    <title>Status</title>
     <para>
      <itemizedlist>
       <listitem>
        <para>
         <guilabel>Auto Away</guilabel> - When checked 
         <application>&app;</application> automatically sets your status to
         "Away" after the specified number of minutes.
        </para>
       </listitem>

       <listitem>
        <para>
         <guilabel>Away Message</guilabel> - You are able to specify eight
         default messages that are selectable when you change status.  The
         first seven messages are filled with common away messages but you 
         are able to change all of them as you wish.
        </para>
       </listitem>
      </itemizedlist>

     </para>
    </sect3>

    <sect3 id="Pref_Gicu_UserInterface">
    <title>User Interface</title>

     <para>
      <itemizedlist>
       <listitem>
        <para>
         <guilabel>Automatically popup message windows</guilabel> - 
         When checked this makes incoming message windows appear and take 
         focus right when the message is received. Otherwise, the message 
         window will only popup when you click the blinking icon in the 
         notification area or in the contact list.
        </para>
       </listitem>

       <listitem>
        <para>
         <guilabel>Do not close message window when sending a message</guilabel>
         - When checked this makes <application>&app;</application> leave 
         message windows on the screen.  This is helpful if you are having
         a very fast conversation with someone that has many messages.  
         You can toggle this option in a message window.
        </para>
       </listitem>

       <listitem>
        <para>
         <guilabel>Character set to use when there is no encoding info</guilabel>
         - This allows you to decide which Character set to use if the message
         does not suggest which one to use.  Set this to your local setting.
         The default should be fine for most users.
        </para>
       </listitem>

      </itemizedlist>
     </para>
    </sect3>

    <sect3 id="Pref_Gicu_Themes">
    <title>Themes</title>
                                                                                
     <para>
      <itemizedlist>
       <listitem>
        <para>
         <guilabel>&app; Icon Themes</guilabel> -
         This selection box allows you to select the icon theme you wish
         to use with <application>&app;</application>.

         <tip>
          <title>Getting New Icon Themes</title>
          <para>
           You can find a rich set of icon themes at 
           <application>&app;'s</application> website.  This is pure eye candy.
          </para>
         </tip>
        </para>
       </listitem>

       <listitem>
        <para>
         <guilabel>&app; Emoticon Themes</guilabel> -
         This selection box allows you to select the style of emoticon's you 
         wish to use in <application>&app;'s</application>.  To turn off
         emoticons select the "None" option.
        </para>
       </listitem>
      </itemizedlist>
     </para>
    </sect3>
   </sect2>

   <sect2 id="Pref_ICQ">
    <title>ICQ Preferences</title>

    <para>
     In the ICQ Preferences there is currently only one tab for User Interface
     which allows you to select the text colours for different states.  This
     helps you to quickly identify what state that a contact on your list is in.
    </para>
   </sect2>

  <para>
    Click on the <guibutton>Close</guibutton> button to  
    close the dialog.  Any changes you made are saved automatically. 
  </para>

 </sect1>

 <sect1 id="userinfo">
  <title>My Information</title>
  <para>
   To change your details in the ICQ user directory, select
   <guimenuitem>Change Account Info...</guimenuitem> from the
   <guimenu>Account</guimenu> menu. The
   <interface>My Information</interface> dialog, shown in 
   <xref linkend="fig_userinfo"/> appears
  </para>

<!-- Screenshot -->
<figure id="fig_userinfo">
   <title>Userinfo Dialog</title>
   <screenshot>
     <mediaobject>
       <imageobject>
         <imagedata fileref="figures/userinfo.png" format="PNG" srccredit="Christopher Ness"/>
       </imageobject>
       <textobject>
         <phrase>The User Info Dialog in
                 <application>&app;</application>
                 allows you to change your public information.
         </phrase>
       </textobject>
     </mediaobject>
   </screenshot>
 </figure>

  <para>
   This dialog allows you to tell other users more about yourself.
   Keep in mind those personal details are publicly available from the ICQ user directory,
   and therefore anyone could read them prior to contacting you.
  </para>

  <para>
   The properties in the <guilabel>General</guilabel> tab are:
   <itemizedlist>

    <listitem>
     <para>
      <guilabel>ICQ Number</guilabel>
       Displays the user's UIN. Not editable.
 
<!--      <note>
       <para>
        To login as another user with a different UIN, see the <guilabel>Miscellaneous</guilabel> tab
        in the <interface>Preferences dialog</interface> (see <xref linkend="preferences"/>).
       </para>
      </note>  -->
     </para>
    </listitem>
    
    <listitem>
     <para>
      <guilabel>Nickname</guilabel>
       This field allows you to change your nickname on ICQ. 
     </para>
    </listitem>
    
    <listitem>
     <para>
      <guilabel>First Name</guilabel>
       This field allows you to specify your first name.
     </para>
    </listitem>

    <listitem>
     <para>
      <guilabel>Last Name</guilabel>
       This field allows you to specify your last name.
     </para>
    </listitem>
    
    <listitem>
     <para>
      <guilabel>Gender</guilabel>
       This field allows you to specify your gender.
     </para>
    </listitem>

    <listitem>
     <para>
      <guilabel>Age</guilabel>
       This field allows you to specify your age.
     </para>
    </listitem>
    
    <listitem>
     <para>
      <guilabel>Require Auth</guilabel>
      This checkbox allows you to decide 
      whether other people need your authorization to add you to their ICQ contact lists.

      <note>
       <para>
        The demand of authorization depends on the ICQ client the other person uses.
        Some clients don't implement the feature and can add users regardless of 'Require Auth'.
       </para>
      </note>

     </para>
    </listitem>
    
    <listitem>
     <para>
      <guilabel>Birthday</guilabel>
      This field allows you to specify your birth date.
     </para>
    </listitem>
    
   </itemizedlist>
  </para>

  <para>
   The properties in the <guilabel>Internet</guilabel> tab are:
   <itemizedlist>

    <listitem>
     <para>
      <guilabel>IP</guilabel>  
      Displays the user's IP address. Not editable.
     </para>
    </listitem>

    <listitem>
     <para>
      <guilabel>Port</guilabel>  
      Displays the TCP port being used. Not editable.
     </para>
    </listitem>

    <listitem>
     <para>
      <guilabel>Email</guilabel>, <guilabel>Other Email</guilabel>, <guilabel>Old Email:</guilabel>  
      This field allows you to enter various e-mail addresses you have.
     </para>
    </listitem>
 
    <listitem>
     <para>
      <guilabel>Hide Email</guilabel> 
      This checkbox specifies whether the e-mail addresses are visible to other people.
     </para>
    </listitem>
   </itemizedlist>
  </para>

  <para>
   The <guilabel>Location</guilabel> tab allows you to edit various details relating
   to your location, such as your phone number, country and timezone.
  </para>

  <caution>
   <para>
    Apply reasonable caution when revealing private details such
    as addresses and phone numbers.
   </para>
  </caution>
  
  <para>
   The properties in the <guilabel>About</guilabel> tab are:
   <itemizedlist>

    <listitem>
     <para>
      <guilabel>Home Page</guilabel>  
      This field allows to to specify your home page URL.
     </para>
    </listitem>

    <listitem>
     <para>
      <guilabel>About</guilabel>  
      This field allows you to add additional information about yourself.
      It may span many lines.
     </para>
    </listitem>
   </itemizedlist>
  </para>

  <para>
    Click on the <guibutton>Save</guibutton> button to apply the changes 
    and close the dialog. Click on the <guibutton>Refresh</guibutton> 
    button to fetch your information from the server. Click the <guibutton>Cancel</guibutton>
    button to close the dialog without applying the changes
    you have made.
  </para>
 </sect1>   



<!--// work needed here! To close the
    <interface>Properties</interface> dialog, click on 
    <guibutton>OK</guibutton>. To cancel the changes
    and return to previous values, click the
    <guibutton>Cancel</guibutton> button.
  </para> -->
 <!-- ============= Various Sections ============================= -->
 <!-- Here you should add, if necessary, several more sect1's,
 describing other windows (besides the main one), file formats,
 preferences dialogs,  etc. as appropriate. Try not to make any of
 these sections too long. -->


 <!-- ============= Bugs ================================== -->
 <!-- This section should describe known bugs and limitations of
      the program if there are any - please be frank and list all
      problems you know of -->
 <sect1 id="bugs">
  <title>Known Bugs and Limitations</title>
  <para>
   <itemizedlist>

    <listitem>
     <para>
      No multi-party chat. You cannot participate in chats with more than two users.
     </para>
    </listitem>
    <listitem>
     <para>
      File transfer is buggy.
     </para>
    </listitem>
    <listitem>
     <para>
      Impossible to change "Work" details in the user information.
     </para>
    </listitem>
    <listitem>
     <para>
      Impossible to view another user's birthday details.
     </para>
    </listitem>
    <listitem>
     <para>
      Cannot send files/chat requests when behind a NAT (many users who are behind a "firewall").
     </para>
    </listitem>
   </itemizedlist>
   
   <tip>
    <title>Where did all the settings go?</title>
    <para>
     If you are looking for a more advanced setting that used to be in
     <application>&app;</application> then chances are that it has been
     moved to a Gconf key.  Your distribution should have a Gconf2 editor
     GUI that you can use to modify the keys.  They should be found under:
     <emphasis>/apps/gnomeicu/</emphasis>.
    </para>
   </tip>

  </para>
 </sect1>


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

 <sect1 id="authors">
  <title>Authors</title>
  <para>
   <application>GnomeICU</application> was written by Jeremy Wise 
   (<email>jwise@pathwaynet.com</email>), David Tabachnikov
   (<email>captain@isdn.net.il</email>) and countless other volunteers.
  </para>
  
  <para>
   To find more information about <application>GnomeICU</application>,
   please visit the <ulink url="http://gnomeicu.sourceforge.net" type="http">GnomeICU web
   site</ulink>.
  </para>
 
  <para>
   Please send all comments, suggestions, and bug
   reports to the <ulink url="http://bugs.gnome.org" type="http">GNOME
   bug tracking database</ulink>. (Instructions for submitting bug
   reports can be found <ulink
   url="http://bugs.gnome.org/Reporting.html" type="http">
   on-line</ulink>.) If you are using
   GNOME 1.2 or later, you can also use <application>Bug Report
   Tool</application> (<command>bug-buddy</command>), available in the
   <guisubmenu>Utilities</guisubmenu> submenu of <guimenu>Main
   Menu</guimenu>, for submitting bug reports.
  </para>

  <para>
   This manual was written by Thomas Canty
   <email>tommydal@ihug.com.au</email> and Ilya Konstantinov <email>gnomeicu-docs@future.galanet.net</email>.
   Bringing the documentation up to the Gnome 2.x level was Christopher
   Ness <email>nesscg@mcmaster.ca</email>.
  </para>
  <para>
   Please send all comments and suggestions regarding this manual to the <ulink type="http"
   url="http://www.gnome.org/gdp">GNOME Documentation Project</ulink> 
   by sending an email to <email>docs@gnome.org</email>. You can also
   add your comments online by using the <ulink type="http"
   url="http://www.gnome.org/gdp/doctable/">GNOME Documentation Status
   Table</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 <citetitle>GNU General Public
   License</citetitle> 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>
   A copy of the <citetitle>GNU General Public License</citetitle> is
   included as an appendix to the <citetitle>GNOME Users
   Guide</citetitle>.  You may also 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>59 Temple Place</street> - Suite 330
    <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
    <country>USA</country>
   </address>
  </para>
 </sect1>
</article>

