<!DOCTYPE Article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[
 <!ENTITY version "0.94">
 <!ENTITY manual-version "0.2">
]>

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

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

 <artheader>
  <title>GnomeICU</title>
  <copyright>
   <year>2000</year>
   <holder>Thomas Canty, Ilya Konstantinov</holder>
  </copyright>

  <revhistory>
   <revision>
    <revnumber>0.2</revnumber>
    <date>07 Oct 2000</date>
    <authorinitials>ik</authorinitials>
    <revremark>Style corrections, tips and changes to accomodate new developments</revremark>
   </revision>   
  </revhistory>
    
  <!-- translators: uncomment this:

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

   -->

  <!-- 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>

  <releaseinfo>
  This is version $manual-version of GnomeICU manual.
  </releaseinfo>

 </artheader>

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

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

  <para>
   <application>GnomeICU</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>GnomeICU</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
   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
   (which is somehow similar to the traditional "pager" device).

   <application>GnomeICU</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>GnomeICU</application>, select
   <guimenuitem>GnomeICU</guimenuitem> from the
   <guisubmenu>Internet</guisubmenu> submenu of the <guimenu>Main
   Menu</guimenu>, or type <command>gnomeicu</command> on the
   command line. To start <application>GnomeICU</application> without
   the panel applet, type <command>gnomeicu -a</command> on the command line.
  </para>

  <para>
   This document describes version
   &version; of <application>GnomeICU</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 him/her only,
   and used to identify him/her in addition to other information, such as nickname and e-mail
   address. To communicate with other ICQ users, you need to register and receive an ICQ UIN too.
  </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 to the ICQ service, open the <guimenu>ICQ</guimenu> and select <guisubmenu>(TODO)</guisubmenu>.
   
   TODO
  </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>

  <para>
   Starting <application>GnomeICU</application> opens 
   the <interface>Main window</interface>, shown in <xref
   linkend="mainwindow-fig">.

   <figure id="mainwindow-fig">
    <title>GnomeICU Main Window</title>
     <screenshot>
     <screeninfo>GnomeICU Main Window</screeninfo>
     <graphic fileref="images/mainwindow.png" format="png"
      srccredit="Ilya Konstantinov">
     </graphic>
    </screenshot>
   </figure>
  </para>
   
  <sect2 id="icq-basics">
   <title>Glossary</title>
   
   <para>   
    <itemizedlist>

     <listitem>
      <para>
       <emphasis>Contact List</emphasis>
       &mdash;
       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 (also called 'buddy
       list' in similar instant messaging applications).
      </para>
     </listitem>

     <listitem>
      <para>
       <emphasis>Status</emphasis>
       &mdash;
       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:
       <emphasis>Online</emphasis>
       (which means you may contact the user),
       <emphasis>Free For Chat</emphasis>,
       <emphasis>Away</emphasis>
       (which means the user is currently away from the computer),
       <emphasis>Not Available</emphasis>
       (which means the user is about to be away from the computer for a long time),
       <emphasis>Occupied</emphasis>,
       <emphasis>Do Not Disturb</emphasis>
       and <emphasis>Invisible</emphasis>.
      </para>
      
      <para>
       The icons besides each name show the person's status.
       The Contact List contains an <interface>Online</interface> tab, which
       contains only online contacts, an <interface>Offline</interface> tab which
       contains only offline contacts and an optional <interface>Not In List</interface>
       tab, which contains users which sent you messages and are not in your contact list.
      </para>
     </listitem>

     <listitem>
      <para>
       <emphasis>Invisible user</emphasis>
       &mdash;
       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>
  
  <sect2>
   <title>Performing ICQ operations</title>
   <para>
    Most ICQ operations can be performed by right-clicking a contact and picking
    an item from the popup menu, shown in <xref linkend="popup-menu-fig">.

    <figure id="popup-menu-fig">
     <title>Contact Popup Menu</title>
     <screenshot>
      <screeninfo>Contact Popup Menu</screeninfo>
      <graphic fileref="images/popup-menu.png" format="png"
       srccredit="Ilya Konstantinov">
      </graphic>
     </screenshot>
    </figure>
    
    <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="panel-applet">
   <title>The Panel Applet</title>
   <para> 
    <application>GnomeICU</application> comes with a panel applet, shown in 
    <xref linkend="panel-fig">. This panel applet shows your current status 
    and the number of users currently online in your contact list.
    Clicking this panel applet brings up the main window if it is hidden,
    or hides if it is visible.
   </para>

   <figure id="panel-fig">
    <title>GnomeICU Panel Applet</title>
    <screenshot>
     <screeninfo>GnomeICU Panel Applet</screeninfo>
     <graphic fileref="images/panel.png" format="png"
       srccredit="Ilya Konstantinov">
     </graphic>
    </screenshot>
   </figure>

   <para>
    When a message is received, the panel applet's icon changes from the regular
    status icon to an icon representing the type of message received
    (see <xref linkend="panel-mesg-fig">). The number besides it now
    shows how many messages are unread.
   </para>
 
   <figure id="panel-mesg-fig">
    <title>GnomeICU Panel Applet - Message Received</title>
    <screenshot>
     <screeninfo>GnomeICU Panel Applet - Message Received</screeninfo>
     <graphic fileref="images/panel-message.png" format="png"
       srccredit="Ilya Konstantinov">
     </graphic>
    </screenshot>
   </figure>
   
   <tip>
    <title>Applet tooltips</title>
    <para>
     Try moving your mouse cursor over the <application>GnomeICU</application> panel applet for 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.
     In regular mode, you could see the list of people in your contact list which are currently online.
    </para>
   </tip>
  </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>ICQ</guimenu></term>
      <listitem>
       <para>
	This menu contains:
	<itemizedlist>
	 <listitem>
	  <para>
	   <guimenuitem>Add Contact</guimenuitem>
	   &mdash; this command brings up the <interface><link linkend="contact">Add Contact</link></interface> dialog, which 
           allows a user to add a contact to their contact list.
	  </para>
         </listitem>
	 <listitem>
	  <para>
           <guimenuitem>Connection History</guimenuitem>
	   &mdash; this command brings up the <interface>Connection History</interface> dialog,
           showing a list of network transactions which occured during the ICQ session. It is not the regular Message History
           and contains information which is not useful to the average user.
	  </para>
	 </listitem>
         <listitem>
          <para>
           <guimenuitem>Preferences...</guimenuitem>
           &mdash; this command brings up the <interface><link linkend="preferences">Preferences</link></interface> dialog,
           which allows you to configure <application>GnomeICU</application>.
          </para>
         </listitem>
         <listitem>
          <para>
           <guimenuitem>Change User Info</guimenuitem>
           &mdash; this command brings up the <interface><link linkend="userinfo">User Information</link></interface> dialog,
           which allows you to add and change your personal information in the ICQ user directory.
          </para>
         </listitem>
         <listitem>
          <para>
           <guimenuitem>Hide Main Window</guimenuitem>
           &mdash; this command hides the main window. Clicking the 
           panel applet brings the main window back again.
          </para>
         </listitem>
         <listitem>
           <para>
            <guimenuitem>Exit</guimenuitem>
            &mdash; this command exits the program and removes the <application>GnomeICU</application>
            applet from the GNOME panel.
           </para>
         </listitem>
        </itemizedlist> 
       </para>
      </listitem>
     </varlistentry>

    <varlistentry>
     <term><guimenu>Lists</guimenu></term>
     <listitem>
      <para>
       This menu contains:
       <itemizedlist>
        <listitem>
         <para>
          <guimenuitem>Ignore List</guimenuitem>
           &mdash; this command brings up the ignore list dialog, which 
           allows users to add contacts to their ignore list.
         </para>
        </listitem>
        <listitem>
         <para>
          <guimenuitem>Visible List</guimenuitem>
          &mdash; this command brings up the visible list dialog, which 
          allows users to add contacts to their visible list.
         </para>
        </listitem>
	<listitem>
	 <para>
	  <guimenuitem>Invisible List</guimenuitem>
	  &mdash; this command brings up the invisible list dialog, which 
          allows users to add contacts to their invisible list.
         </para>
        </listitem>
	<listitem>
	 <para>
	  <guimenuitem>Online Notify List</guimenuitem>
          &mdash; this command brings up the online notify list dialog, which 
          allows users to add contacts to their online notify list.
	 </para>
	</listitem>
       </itemizedlist>
      </para>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term><guimenu>Help</guimenu></term>
     <listitem>
      <para>
       This menu contains:
       <itemizedlist>
        <listitem>
         <para>
          <guimenuitem>GnomeICU Documentation</guimenuitem>
          &mdash; shows this manual.
         </para>
        </listitem>

        <listitem>
         <para>
          <guimenuitem>About</guimenuitem>
          &mdash; shows general information about
          <application>GnomeICU</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="message-fig"> 
    appears. Type a message and click the <guibutton>Send</guibutton> 
    button to send the message.

    <tip>
     <para>
      You can press <keycombo><keycap>Ctrl</keycap><keycap>Enter</keycap></keycombo> to quickly send the message.
      This accelerator key triggers Send in all <application>GnomeICU</application> dialogs.
     </para>
    </tip>

   </para>

   <figure id="message-fig">
    <title>Message Dialog</title>
    <screenshot>
     <screeninfo>Message Dialog</screeninfo>
     <graphic fileref="images/message.png" format="png"
      srccredit="Ilya Konstantinov">
     </graphic>
    </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="file-fig"> appears. <guibutton>Add Files...</guibutton>
    to add each file you wish to send to the list.
    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.
    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>
 
   <figure id="file-fig">
    <title>Send File Dialog</title>
    <screenshot>
     <screeninfo>Send File Dialog</screeninfo>
     <graphic fileref="images/file.png" format="png"
      srccredit="Ilya Konstantinov">
     </graphic>
    </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 over ICQ, right-click on a contact and select <guimenuitem>URL...</guimenuitem>.
    The <interface>Send URL dialog</interface> shown in <xref linkend="url-fig"> 
    appears. Type in or paste the URL, and if necessary add a description. Click 
    the <guibutton>Send</guibutton> button to send the URL.
     
     <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>
 
   <figure id="url-fig">
    <title>Send URL Dialog</title>
    <screenshot>
     <screeninfo>Send URL Dialog</screeninfo>
     <graphic fileref="images/URL.png" format="png"
      srccredit="Ilya Konstantinov">
     </graphic>
    </screenshot>
   </figure>
  </sect2>

  <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 <xref linkend="chatrequest-fig"> appears.
   </para>

   <figure id="chatrequest-fig">
    <title>Chat Request Dialog</title>
    <screenshot>
     <screeninfo>Chat Request dialog</screeninfo>
      <graphic fileref="images/chatrequest.png" format="png"
       srccredit="Ilya Konstantinov">
      </graphic>
    </screenshot>
   </figure>

   <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 <xref linkend="chat-fig"> appears.
    Otherwise, their reason for not accepting the chat request would appear.
   </para>

   <figure id="chat-fig">
    <title>Chat Dialog</title>
    <screenshot>
     <screeninfo>Chat Dialog</screeninfo>
     <graphic fileref="images/chat.png" format="png"
      srccredit="Ilya Konstantinov">
     </graphic>
    </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>ICQ</guimenu> menu. The
   <interface>Add A Contact</interface> druid, shown in <xref
   linkend="contact-fig"> appears.
  </para>

  <figure id="contact-fig">
   <title>Add A Contact Druid</title>
   <screenshot>
    <screeninfo>Add A Contact Druid</screeninfo>
    <graphic fileref="images/addcontact.png" format="png"
     srccredit="Ilya Konstantinov">
    </graphic>
   </screenshot>
  </figure>

  <para>
    To add a contact, enter information about the user in at least one field
    (e.g. the UIN). After entering this information, click the 
    <guibutton>Next</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>Next</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 use the <guilabel>Contact Info</guilabel> tab
      and give as much 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 ============================= -->
 <sect1 id="preferences">
  <title>Customizing GnomeICU</title>

  <para>
   To access the <interface>Preferences dialog</interface>, select
   <guimenuitem>Preferences...</guimenuitem> from the
   <guimenu>ICQ</guimenu> menu. The
   <interface>Preferences dialog</interface>, shown in <xref
   linkend="preferences-fig"> appears.
  </para>

  <figure id="preferences-fig">
   <title>Preferences Dialog</title>
   <screenshot>
    <screeninfo>Preferences Dialog</screeninfo>
    <graphic fileref="images/preferences.png" format="png"
     srccredit="Ilya Konstantinov">
    </graphic>
   </screenshot>
  </figure>

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

    <listitem>
     <para>
      <guilabel>Colors</guilabel>
      This section allows you to change the colors
      used in the contact list for users in different states.
     </para>
    </listitem>
    
    <listitem>
     <para>
      <guilabel>Enable sounds</guilabel>
      &mdash; This allows you to enable and disable sounds.
      <note>
       <title>Customizing sounds</title>
       <para>
        To change the default sounds and configure different sounds for different
        events, use the <application>GNOME Control Center</application>'s
        <interface><guilabel>Multimedia</guilabel> -> <guilabel>Sound</guilabel></interface> applet.
       </para>
      </note>
     </para>
    </listitem>
    
    <listitem>
     <para>
      <guilabel>Enable sounds only when online</guilabel>
      &mdash; This allows you to disable sounds notification when not in Online status (e.g. Occupied status),
      to prevent them from disturbing you or others when you're not available to receive messages.
     </para>
    </listitem>
    
    <listitem>
     <para>
      <guilabel>Enable beeps</guilabel>
      &mdash; This makes <application>GnomeICU</application> produce short beeps from the built-in
      speaker of your computer. This might be useful on computers without a real sound device.
     </para>
    </listitem>

    <listitem>
     <para>
      <guilabel>Show Main Window on Startup</guilabel>
      &mdash; This makes the main window display when <application>GnomeICU</application> start.
     </para>
    </listitem>

    <listitem>
     <para>
      <guilabel>Automatically Show Entire Reply Dialog</guilabel>
      &mdash; When a new message is received, this will make the incoming message window
      contain the reply text box right away, without having to click <guibutton>Reply</guibutton>.
     </para>
    </listitem>

    <listitem>
     <para>
      <guilabel>Automatically Popup Message Windows</guilabel>
      &mdash; 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 panel applet or in the contact list.
     </para>
    </listitem>

    <listitem>
     <para>
      <guilabel>Online Notify Includes Returning from Away and Not Available</guilabel>
      &mdash; This makes <application>GnomeICU</application> notify you when contacts in
      your <interface>Notify List</interface> return from Away and Not Available status (besides
      the regular behavior of notifying you when the contact goes Online from Offline
      status).
     </para>
    </listitem>
    
    <listitem>
     <para>
      <guilabel>Hide tool-tips</guilabel>
      &mdash; Hides the tool-tips which you receive by moving your mouse cursor over the panel applet for few seconds.
     </para>
    </listitem>
   </itemizedlist>
  </para>

   <para>
   The properties in the <guilabel>Networking</guilabel> tab are:
   <itemizedlist>
    <listitem>
     <para>
      <guilabel>Russian Win1251<->Koi8-r translation</guilabel>
      &mdash;  This allows you to communicate with ICQ users on Microsoft Windows platforms
      in Cyrillic languages. This makes <application>GnomeICU</application> convert
      incoming messages from Win1251 encoding (also known as 'cp1251',
      the standard encoding in <application>Microsoft Windows</application>) to Koi8-R
      (a popular encoding in UNIX) and vice versa for outgoing messages.
      
      <warning>
       <title>Do not use this feature if communicating in other languages</title>
       <para>
        This feature is likely to interfere with other languages encodings
        and place wrong letters in both incoming and outgoing messages.
        Use only for Cyrillic (Russian).
       </para>
      </warning>

     </para>       
    </listitem>
    
    <listitem>
     <para>
      <guilabel>Kanji EUC<->SJIS translation</guilabel>
      &mdash; This makes <application>GnomeICU</application> convert between
      different Japanese encodings.
     </para>
    </listitem>
    
    <listitem>
     <para>
      <guilabel>Dump UDP packets</guilabel>
      &mdash; This dumps contents of all incoming and outgoing UDP packets to standard output (stdout).
      This option is intended for developers and has no use to regular users.
     </para>
    </listitem>

    <listitem>
     <para>
      <guilabel>Dump TCP packets</guilabel>
      &mdash; This dumps contents of all incoming and outgoing TCP packets to standard output (stdout).
      This option is intended for developers and has no use to regular users.
     </para>
    </listitem>

    <listitem>
     <para>
      <guilabel>Server</guilabel>
      &mdash; This allows you to configure which ICQ server you wish 
      <application>GnomeICU</application> to use.

      <warning>
       <para>
        For the <guilabel>Server</guilabel> and <guilabel>Port</guilabel> settings, the default should be correct for most users.
        Changing those settings might cause <application>GnomeICU</application> to be unable to connect to the ICQ service.
       </para>
      </warning>
   
     </para>
    </listitem>

    <listitem>
     <para>
      <guilabel>TCP Port Range</guilabel>
      &mdash; This allows you to specify the TCP port range you want
      <application>GnomeICU</application> to listen to for incoming
      connections. This is necessary for peer-to-peer messages (instant
      messages which are not "sent through server"), chats and file transfers.
      The default should be fine for most users.
     </para>
    </listitem>

   </itemizedlist>
  </para>

  <para>
   The properties in the <guilabel>External Programs</guilabel> tab are:
   <variablelist>

    <varlistentry>
     <term><guilabel>Run Program On Event</guilabel></term>
     <listitem>
      <para>
       This allows you to run an external program upon receiving various events,
       such as receiving a message.
      </para>
     </listitem>
    </varlistentry>

   </variablelist>
  </para>

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

    <listitem>
     <para>
      <guilabel>Away Message 1..10</guilabel>
      &mdash; This allows you to prepare "Away Messages for later use.
      When you change status from 'Online' to 'Away', 'Not Available',
      'Occupied' or 'Do Not Disturb', <application>GnomeICU</application>
      asks you for a small note to be displayed for users trying to send you messages.
      You could then enter a new message or use one of those 10 predefined ones.
     </para>
    </listitem>
    
    <listitem>
     <para>
      <guilabel>Auto away time out is</guilabel>...
      &mdash; This allows you to define how many minutes of inactivity (not using the input
      devices, e.g. mouse or keyboard) it takes before <application>GnomeICU</application>
      switches status to <guilabel>Away</guilabel>.
     </para>
    </listitem>
    
    <listitem>
     <para>
      <guilabel>Auto Not Available time out is</guilabel>...
      &mdash; Similar to the previous option, but switches status to <guilabel>Not Available</guilabel>
      (and hints other users that you walked away for more than a cup of coffee and might not be available
      in the near time).
     </para>
    </listitem>

   </itemizedlist>
  </para>

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

    <listitem>
     <para>
      <guilabel>Allow others to see me on websites</guilabel>
      &mdash; This allows or disallows other people to see your details on the ICQ website.
     </para>
    </listitem>

    <listitem>
     <para>
      <guilabel>Automatically hide main window after</guilabel>...
      &mdash; This allows you to hide the main window after a specified number of seconds.
     </para>
    </listitem>

    <listitem>
     <para>
      <guilabel>User Information</guilabel>
      Basic user information can be changed in this section.
     </para>
    </listitem>

   </itemizedlist>
  </para>

  <para>
    Click on the <guibutton>Apply</guibutton> button to apply the changes 
    without closing the dialog. Click on the <guibutton>OK</guibutton> 
    button to apply the changes and close the dialog. Click the <guibutton>Cancel</guibutton>
    button to close the dialog without applying the changes you have made.
  </para>
 </sect1>

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

  <figure id="user-fig">
   <title>User Information Dialog</title>
   <screenshot>
    <screeninfo>User Infomation Dialog</screeninfo>
    <graphic fileref="images/userprefs.png" format="png"
     srccredit="Ilya Konstantinov">
    </graphic>
   </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>UIN</guilabel>
      &mdash; 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>Nick</guilabel>
      &mdash; This field allows you to change your nickname on ICQ. 
     </para>
    </listitem>
    
    <listitem>
     <para>
      <guilabel>F. Name</guilabel>
      &mdash; This field allows you to specify your first name.
     </para>
    </listitem>

    <listitem>
     <para>
      <guilabel>L. Name</guilabel>
      &mdash; This field allows you to specify your last name.
     </para>
    </listitem>
    
    <listitem>
     <para>
      <guilabel>Sex</guilabel>
      &mdash; This field allows you to specify your gender.
     </para>
    </listitem>

    <listitem>
     <para>
      <guilabel>Age</guilabel>
      &mdash; 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> &mdash; 
      Displays the user's IP address. Not editable.
     </para>
    </listitem>

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

    <listitem>
     <para>
      <guilabel>Email</guilabel>, <guilabel>Other Email</guilabel>, <guilabel>Old Email:</guilabel> &mdash; 
      This field allows you to enter various e-mail addresses you have.
     </para>
    </listitem>
 
    <listitem>
     <para>
      <guilabel>Hide Email</guilabel> &mdash;
      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> &mdash; 
      This field allows to to specify your home page URL.
     </para>
    </listitem>

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

  <para>
    Click on the <guibutton>Apply</guibutton> button to apply the changes 
    without closing the dialog. Click on the <guibutton>OK</guibutton> 
    button to apply the changes and close the dialog. 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>
   
  </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>).
   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>

