help/C/xchat-gnome.xml

   1 <?xml version="1.0"?>
   2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
   3   <!ENTITY legal SYSTEM "legal.xml">
   4   <!ENTITY appversion "0.16">
   5   <!ENTITY manrevision "2.1">
   6   <!ENTITY date "December 2006">
   7   <!ENTITY app "XChat-GNOME">
   8   <!-- Information about the entities
   9        The legal.xml file contains legal information, there is no need to edit the file.
  10        Use the appversion entity to specify the version of the application.
  11        Use the manrevision entity to specify the revision number of this manual.
  12        Use the date entity to specify the release date of this manual.
  13        Use the app entity to specify the name of the application. -->
  14 ]>
  15
  16 <!--
  17       (Do not remove this comment block.)
  18   Maintained by the GNOME Documentation Project
  19   http://developer.gnome.org/projects/gdp
  20   Template version: 2.0 beta
  21   Template last modified Apr 11, 2002
  22 -->
  23 <!-- =============Document Header ============================= -->
  24 <article id="index" lang="en">
  25 <!-- please do not change the id; for translations, change lang to -->
  26 <!-- appropriate code -->
  27   <articleinfo>
  28     <title><application>&app;</application> Manual</title>
  29
  30     <copyright>
  31       <year>2005-2006</year>
  32       <holder>Brian Pepple</holder>
  33     </copyright>
  34     <copyright>
  35       <year>2006</year>
  36       <holder>Joachim Noreiko</holder>
  37     </copyright>
  38 <!-- translators: uncomment this:
  39
  40   <copyright>
  41    <year>2002</year>
  42    <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  43   </copyright>
  44
  45    -->
  46 <!-- An address can be added to the publisher information.  If a role is
  47      not specified, the publisher/author is the same for all versions of the
  48      document.  -->
  49     <publisher>
  50       <publishername>Brian Pepple</publishername>
  51     </publisher>
  52
  53    &legal;
  54    <!-- This file  contains link to license for the documentation (GNU FDL), and
  55         other legal stuff such as "NO WARRANTY" statement. Please do not change
  56         any of this. -->
  57
  58     <authorgroup>
  59       <author role="maintainer">
  60         <firstname>Brian</firstname>
  61         <surname>Pepple</surname>
  62         <affiliation>
  63           <orgname>Fedora Project</orgname>
  64           <address> <email>bpepple@fedoraproject.org</email> </address>
  65         </affiliation>
  66       </author>
  67       <author>
  68         <firstname>Joachim</firstname>
  69         <surname>Noreiko</surname>
  70         <affiliation>
  71           <orgname>GNOME Documentation Project</orgname>
  72           <address> <email>jnoreiko@yahoo.com</email> </address>
  73         </affiliation>
  74       </author>
  75
  76 <!-- This is appropriate place for other contributors: translators,
  77      maintainers,  etc. Commented out by default.
  78
  79       <othercredit role="translator">
  80                 <firstname>Latin</firstname>
  81                 <surname>Translator 1</surname>
  82                 <affiliation>
  83                         <orgname>Latin Translation Team</orgname>
  84                         <address> <email>translator@gnome.org</email> </address>
  85                 </affiliation>
  86                 <contrib>Latin translation</contrib>
  87       </othercredit>
  88 -->
  89     </authorgroup>
  90
  91
  92 <!-- According to GNU FDL, revision history is mandatory if you are -->
  93 <!-- modifying/reusing someone else's document.  If not, you can omit it. -->
  94 <!-- Remember to remove the &manrevision; entity from the revision entries other
  95 -->
  96 <!-- than the current revision. -->
  97 <!-- The revision numbering system for GNOME manuals is as follows: -->
  98 <!-- * the revision number consists of two components -->
  99 <!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
 100 <!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
 101 <!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
 102 <!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
 103 <!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
 104 <!-- to V3.0, and so on. -->
 105     <revhistory>
 106       <revision>
 107         <revnumber>&app; Manual &manrevision;</revnumber>
 108         <date>&date;</date>
 109         <revdescription>
 110           <para role="author">Joachim Noreiko
 111             <email>jnoreiko@yahoo.com</email>
 112           </para>
 113           <para role="publisher">GNOME Documentation Project</para>
 114           </revdescription>
 115       </revision>
 116       <revision>
 117         <revnumber>XChat-GNOME Manual V2.0</revnumber>
 118         <date>November 2005</date>
 119         <revdescription>
 120           <para role="author">Brian Pepple
 121             <email>bpepple@fedoraproject.org</email>
 122           </para>
 123           <para role="publisher">GNOME Documentation Project</para>
 124         </revdescription>
 125       </revision>
 126     </revhistory>
 127
 128     <releaseinfo>This manual describes version &appversion; of XChat-GNOME.</releaseinfo>
 129     <legalnotice>
 130       <title>Feedback</title>
 131       <para>To report a bug or make a suggestion regarding the <application>&app;</application>
 132         application or this manual, follow the directions in the Feedback section of the
 133       <ulink url="ghelp:user-guide?feedback-bugs" type="help">GNOME User Guide</ulink>.
 134       </para>
 135 <!-- Translators may also add here feedback address for translations -->
 136     </legalnotice>
 137
 138     <abstract role="description">
 139       <para>A user manual which describes the use of the XChat-GNOME IRC client.</para>
 140     </abstract>
 141   </articleinfo>
 142
 143   <indexterm zone="index">
 144     <primary>&app;</primary>
 145   </indexterm>
 146   <indexterm zone="index">
 147     <primary>xchat-gnome</primary>
 148   </indexterm>
 149
 150 <!-- ============= Document Body ============================= -->
 151 <!-- ============= Introduction ============================== -->
 152 <!-- Use the Introduction section to give a brief overview of what
 153      the application is and what it does. -->
 154   <sect1 id="xchat-gnome-introduction">
 155     <title>Introduction</title>
 156     <para>The <application>&app;</application> application is an Internet Relay Chat (IRC) program for
 157       the GNOME desktop.
 158     </para>
 159     <para><application>&app;</application> provides the following features:</para>
 160     <itemizedlist>
 161       <listitem>
 162         <para>Notification Area Icon Plugin</para>
 163       </listitem>
 164       <listitem>
 165         <para>Direct Client-To-Client (DCC) Transfers</para>
 166       </listitem>
 167       <listitem>
 168         <para>Direct Client-To-Client (DCC) Chats</para>
 169       </listitem>
 170       <listitem>
 171         <para>Adherence to GNOME Human Interface Guidelines (HIG)</para>
 172       </listitem>
 173     </itemizedlist>
 174   </sect1>
 175
 176 <!-- =========== Getting Started ============================== -->
 177 <!-- Use the Getting Started section to describe the steps required
 178      to start the application and to describe the user interface components
 179      of the application. If there is other information that it is important
 180      for readers to know before they start using the application, you should
 181      also include this information here.
 182      If the information about how to get started is very short, you can
 183      include it in the Introduction and omit this section. -->
 184
 185   <sect1 id="xchat-gnome-getting-started">
 186     <title>Getting Started</title>
 187     <sect2 id="xchat-gnome-start">
 188     <title>Starting <application>&app;</application></title>
 189     <para>You can start <application>&app;</application> in the following ways:
 190     </para>
 191     <variablelist>
 192         <varlistentry>
 193           <term><guimenu>Applications</guimenu> menu</term>
 194           <listitem>
 195             <para>Choose
 196                <menuchoice>
 197                 <guisubmenu>Internet</guisubmenu>
 198                 <guimenuitem>XChat-GNOME IRC Chat</guimenuitem>
 199                </menuchoice>.
 200             </para>
 201           </listitem>
 202         </varlistentry>
 203         <varlistentry>
 204           <term>Command line</term>
 205           <listitem>
 206             <para>To start <application>&app;</application> from a command line,
 207               type <command>xchat-gnome</command>, then press <keycap>Return</keycap>:
 208             </para>
 209             <tip>
 210               <para>To view other command line options that are available,
 211                 type <command>xchat-gnome --help</command>, then press <keycap>Return</keycap>
 212               </para>
 213             </tip>
 214           </listitem>
 215         </varlistentry>
 216     </variablelist>
 217     </sect2>
 218
 219     <sect2 id="xchat-gnome-when-start">
 220     <title>When You Start <application>&app;</application></title>
 221     <para>When you start <application>&app;</application>, the following window is displayed.</para>
 222
 223     <!-- ==== Figure ==== -->
 224       <figure id="xchat-gnome-fig">
 225         <title><application>&app;</application> Main Window</title>
 226         <screenshot>
 227           <mediaobject>
 228             <imageobject><imagedata fileref="figures/xchat-gnome_main_window.png" format="PNG"/>
 229             </imageobject>
 230             <textobject>
 231               <phrase>Shows <application>&app;</application> main window. Contains titlebar,
 232                 menubar, display area, and scrollbars. Menubar contains IRC, Edit, Network,
 233                 Discussion, Go, and Help menus.
 234               </phrase>
 235             </textobject>
 236           </mediaobject>
 237         </screenshot>
 238       </figure>
 239     <!-- ==== End of Figure ==== -->
 240
 241     <!-- Include any descriptions of the GUI immediately after the screenshot of the main UI, -->
 242     <!-- for example, the items on the menubar and on the toolbar. This section is optional. -->
 243
 244     <para>The <application>&app;</application> window contains the following elements:
 245     </para>
 246       <variablelist>
 247         <varlistentry>
 248           <term>Menubar</term>
 249           <listitem>
 250             <para>The menus on the menubar contain all of the commands you need to use in
 251                <application>&app;</application>.</para>
 252           </listitem>
 253         </varlistentry>
 254         <varlistentry>
 255           <term>Server Pane</term>
 256           <listitem>
 257             <para>The Server Pane shows the Servers and Channels currently connected.</para>
 258           </listitem>
 259         </varlistentry>
 260         <varlistentry>
 261           <term>User Button</term>
 262           <listitem>
 263             <para>The User Button shows the number of users present in the selected Channel. Click the User Button to show a list of users.</para>
 264           </listitem>
 265         </varlistentry>
 266         <varlistentry>
 267           <term>Discussion Area</term>
 268           <listitem>
 269             <para>The Discussion Area presents the discussion occurring in the
 270               selected Channel.</para>
 271       <para>Type into the message input line at the bottom of the discussion area to chat in the selected Channel.</para>
 272           </listitem>
 273         </varlistentry>
 274       </variablelist>
 275     </sect2>
 276   </sect1>
 277 <!-- ================ Usage ================================ -->
 278 <!-- Use this section to describe how to use the application to perform the tasks for
 279   which the application is designed. -->
 280   <sect1 id="xchat-gnome-usage">
 281     <title>Usage</title>
 282
 283     <!-- ================ Usage Subsection ================================ -->
 284     <sect2 id="xchat-gnome-connect">
 285       <title>Connecting to an Internet Relay Chat (IRC) Server</title>
 286       <para>To connect to an Internet Relay Chat (IRC) Server, choose
 287         <menuchoice>
 288           <guimenu>IRC</guimenu>
 289           <guimenuitem>Connect</guimenuitem>
 290         </menuchoice>. The
 291         <guilabel>Connect</guilabel> dialog is displayed. Select the Server
 292         that you wish to connect to, then click
 293         <guibutton>Connect</guibutton>.
 294       </para>
 295     </sect2>
 296     <!-- ================ Usage Subsection ================================ -->
 297     <sect2 id="xchat-gnome-transfers">
 298       <title>Viewing Direct Client-To-Client (DCC) File Transfers Information</title>
 299       <para>To view Direct Client-To-Client (DCC) file transfer information, choose
 300         <menuchoice>
 301           <guimenu>IRC</guimenu>
 302           <guimenuitem>File Transfers</guimenuitem>
 303         </menuchoice>.
 304       </para>
 305     </sect2>
 306     <!-- ================ Usage Subsection ================================ -->
 307     <sect2 id="xchat-gnome-edit-text">
 308       <title>Editing Text</title>
 309       <para>You can edit text in the following ways:</para>
 310       <itemizedlist>
 311         <listitem>
 312           <para>To delete the selected text from the file and move the selected text to a buffer,
 313             choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Cut</guimenuitem> </menuchoice>.
 314           </para>
 315         </listitem>
 316         <listitem>
 317           <para>To copy the selected text to a buffer, choose <menuchoice><guimenu>Edit</guimenu>
 318               <guimenuitem>Copy</guimenuitem> </menuchoice>.
 319           </para>
 320         </listitem>
 321         <listitem>
 322           <para>To insert the contents of the buffer at the cursor position, choose
 323             <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Paste</guimenuitem> </menuchoice>.
 324             You must cut or copy text before you can paste text into the file.
 325           </para>
 326         </listitem>
 327         <listitem>
 328           <para>To clear all text from the Discussion Area for the currently selected
 329             Channel, choose <menuchoice><guimenu>Edit</guimenu>
 330             <guimenuitem>Clear</guimenuitem></menuchoice>.
 331           </para>
 332         </listitem>
 333       </itemizedlist>
 334     </sect2>
 335     <!-- ================ Usage Subsection ================================ -->
 336     <sect2 id="xchat-gnome-network-reconnect">
 337       <title>Reconnecting to a Server</title>
 338       <para>To reconnect <application>&app;</application> to an Internet Relay Chat (IRC)
 339         server, choose
 340         <menuchoice>
 341           <guimenu>Network</guimenu>
 342           <guimenuitem>Reconnect</guimenuitem>
 343         </menuchoice>.
 344       </para>
 345     </sect2>
 346     <!-- ================ Usage Subsection ================================ -->
 347     <sect2 id="xchat-gnome-network-disconnect">
 348       <title>Disconnecting from a Server</title>
 349       <para>To disconnect <application>&app;</application> from an Internet Relay Chat (IRC)
 350         server, choose
 351         <menuchoice>
 352           <guimenu>Network</guimenu>
 353           <guimenuitem>Disconnect</guimenuitem>
 354         </menuchoice>.
 355       </para>
 356     </sect2>
 357     <!-- ================ Usage Subsection ================================ -->
 358     <sect2 id="xchat-gnome-discussion-save">
 359       <title>Saving a Channel Transcript</title>
 360       <para>To save a transcript of a Channel, choose
 361         <menuchoice>
 362           <shortcut>
 363             <keycombo>
 364               <keycap>Ctrl</keycap>
 365               <keycap>S</keycap>
 366             </keycombo>
 367           </shortcut>
 368           <guimenu>Discussion</guimenu>
 369           <guimenuitem>Save Transcript</guimenuitem>
 370         </menuchoice>.
 371       </para>
 372     </sect2>
 373     <!-- ================ Usage Subsection ================================ -->
 374     <sect2 id="xchat-gnome-discussion-leave">
 375       <title>Leaving a Channel</title>
 376       <para>When you leave a channel, you are removed from the participants and can no longer chat in it, but the discussion up to that point remains in the Server Pane.</para>
 377       <para>To leave a Channel, choose
 378         <menuchoice>
 379           <shortcut>
 380             <keycombo>
 381               <keycap>Ctrl</keycap>
 382               <keycap>Q</keycap>
 383             </keycombo>
 384           </shortcut>
 385           <guimenu>Discussion</guimenu>
 386           <guimenuitem>Leave</guimenuitem>
 387         </menuchoice>.
 388       </para>
 389     </sect2>
 390     <!-- ================ Usage Subsection ================================ -->
 391     <sect2 id="xchat-gnome-discussion-close">
 392       <title>Closing a Channel</title>
 393       <para>When you close a channel, the channel is removed from the list in the Server Pane.</para>
 394       <para>To close a Channel, choose
 395         <menuchoice>
 396           <shortcut>
 397             <keycombo>
 398               <keycap>Ctrl</keycap>
 399               <keycap>W</keycap>
 400             </keycombo>
 401           </shortcut>
 402           <guimenu>Discussion</guimenu>
 403           <guimenuitem>Close</guimenuitem>
 404         </menuchoice>.
 405       </para>
 406     </sect2>
 407     <!-- ================ Usage Subsection ================================ -->
 408     <sect2 id="xchat-gnome-discussion-navigate">
 409       <title>Navigating through Channels</title>
 410       <itemizedlist>
 411         <listitem>
 412           <para>To view previous channel, choose
 413             <menuchoice>
 414               <shortcut>
 415                 <keycombo>
 416                   <keycap>Alt</keycap>
 417                   <keycap>Up</keycap>
 418                 </keycombo>
 419               </shortcut>
 420               <guimenu>Go</guimenu>
 421               <guimenuitem>Previous Discussion</guimenuitem>
 422             </menuchoice>
 423           </para>
 424         </listitem>
 425         <listitem>
 426           <para>To view next channel, choose
 427             <menuchoice>
 428               <shortcut>
 429                 <keycombo>
 430                   <keycap>Alt</keycap>
 431                   <keycap>Down</keycap>
 432                 </keycombo>
 433               </shortcut>
 434               <guimenu>Go</guimenu>
 435               <guimenuitem>Next Discussion</guimenuitem>
 436             </menuchoice>
 437           </para>
 438         </listitem>
 439       </itemizedlist>
 440     </sect2>
 441     <!-- ================ Usage Subsection ================================ -->
 442     <sect2 id="xchat-gnome-network-navigate">
 443       <title>Navigating Through Servers</title>
 444       <itemizedlist>
 445         <listitem>
 446           <para>To view previous server, choose
 447             <menuchoice>
 448               <shortcut>
 449                 <keycombo>
 450                   <keycap>Ctrl</keycap>
 451                   <keycap>Up</keycap>
 452                 </keycombo>
 453               </shortcut>
 454               <guimenu>Go</guimenu>
 455               <guimenuitem>Previous Network</guimenuitem>
 456             </menuchoice>
 457           </para>
 458         </listitem>
 459         <listitem>
 460           <para>To view next server, choose
 461             <menuchoice>
 462               <shortcut>
 463                 <keycombo>
 464                   <keycap>Ctrl</keycap>
 465                   <keycap>Down</keycap>
 466                 </keycombo>
 467               </shortcut>
 468               <guimenu>Go</guimenu>
 469               <guimenuitem>Next Network</guimenuitem>
 470             </menuchoice>
 471           </para>
 472         </listitem>
 473       </itemizedlist>
 474     </sect2>
 475     <!-- ================ Usage Subsection ================================ -->
 476     <sect2 id="xchat-gnome-quit">
 477       <title>Quitting &app;</title>
 478       <para>To quit <application>&app;</application>, choose
 479         <menuchoice>
 480           <shortcut>
 481             <keycombo>
 482               <keycap>Ctrl</keycap>
 483               <keycap>Q</keycap>
 484             </keycombo>
 485           </shortcut>
 486           <guimenu>IRC</guimenu>
 487           <guimenuitem>Quit</guimenuitem>
 488         </menuchoice>.
 489       </para>
 490     </sect2>
 491   </sect1>
 492   <!-- ============= Customization ============================= -->
 493   <!-- Use this section to describe how to customize the application. -->
 494   <sect1 id="xchat-gnome-prefs">
 495     <title>Preferences</title>
 496     <para>To modify the preferences of <application>&app;</application>, choose
 497       <menuchoice>
 498         <guimenu>Edit</guimenu>
 499         <guimenuitem>Preferences</guimenuitem>
 500       </menuchoice>. The
 501       <guilabel>Preferences</guilabel> dialog contains the following sections:</para>
 502     <itemizedlist>
 503       <listitem><para><xref linkend="xchat-gnome-prefs-general"/></para></listitem>
 504       <listitem><para><xref linkend="xchat-gnome-prefs-colors"/></para></listitem>
 505       <listitem><para><xref linkend="xchat-gnome-prefs-transfers"/></para></listitem>
 506       <listitem><para><xref linkend="xchat-gnome-prefs-networks"/></para></listitem>
 507       <listitem><para><xref linkend="xchat-gnome-prefs-plugins"/></para></listitem>
 508     </itemizedlist>
 509 <!-- =============== Customization Subsection ================ -->
 510 <!-- Use a new section to describe different tabbed sections on the Settings or Preferences
 511              dialog. -->
 512     <sect2 id="xchat-gnome-prefs-general">
 513       <title>IRC Preferences</title>
 514       <variablelist>
 515         <varlistentry>
 516           <term><guilabel>General</guilabel></term>
 517           <listitem>
 518             <para>Enter the <guilabel>Nickname</guilabel> you wish to use in the Internet Relay Chat
 519               (IRC) channel.</para>
 520             <para>Enter your <guilabel>Real Name</guilabel>, which is displayed on
 521               <command>/whois</command> requests.</para>
 522             <para>Enter the <guilabel>Quit Message</guilabel> you wish to be shown to other users when you leave an Internet Relay Chat (IRC) network.</para>
 523             <para>Enter the <guilabel>Part Message</guilabel> you wish to be shown to other users when you leave an Internet Relay Chat (IRC) channel but remain connected to that channel's network.</para>
 524             <para>Enter the <guilabel>Away Message</guilabel> you wish to be shown to people who try to contact you when you are away.</para>
 525           </listitem>
 526         </varlistentry>
 527         <varlistentry>
 528           <term><guilabel>Highlighting</guilabel></term>
 529           <listitem>
 530             <para>Specify words or phrases that should be highlighted in a different text colour when another chat user says them. This is in addition to your nickname, which is always highlighted.</para>
 531           </listitem>
 532         </varlistentry>
 533         <varlistentry>
 534           <term><guilabel>Use Interface</guilabel></term>
 535           <listitem>
 536             <para>Select the <guilabel>Use System Terminal Font</guilabel> option to use the same
 537               fonts as your system terminal.</para>
 538             <para>Select the <guilabel>Use this font</guilabel> option to open the Font Selection
 539               dialog box.</para>
 540             <para>Select the <guilabel>Show colors</guilabel> option to enable color nicknames in
 541               discussion area.</para>
 542             <para>Select the <guilabel>Show timestamps</guilabel> option to show timestamps of
 543               discussion.</para>
 544           </listitem>
 545         </varlistentry>
 546       </variablelist>
 547     </sect2>
 548     <sect2 id="xchat-gnome-prefs-colors">
 549       <title>Colors</title>
 550       <variablelist>
 551         <varlistentry>
 552           <term><guilabel>Text Colors</guilabel></term>
 553           <listitem>
 554             <para>Use the <guilabel>Built-in schemes</guilabel> drop-down box to specify how
 555               <application>&app;</application> should display the text and backgroud color.
 556               Select one of the following options:</para>
 557             <itemizedlist>
 558               <listitem>
 559                 <para>Use the <guilabel>Black on White</guilabel> option to provide black text
 560                   on a white background.</para>
 561               </listitem>
 562               <listitem>
 563                 <para>Use the <guilabel>White on Black</guilabel> option to provide white text
 564                   on a black background.</para>
 565               </listitem>
 566               <listitem>
 567                 <para>Use the <guilabel>Custom</guilabel> option to create a custom color
 568                   scheme.</para>
 569               </listitem>
 570             </itemizedlist>
 571             <note>
 572               <para>The following options are only able to be changed if
 573                 <guilabel>Built-in schemes</guilabel> is
 574                 set to <guilabel>Custom</guilabel>.</para>
 575             </note>
 576             <para>Click on the <guilabel>Foreground color</guilabel> button to display the color
 577               selector dialog.  Select a foreground color for the <application>&app;</application>
 578               discussion area.</para>
 579             <para>Click on the <guilabel>Background color</guilabel> button to display the color
 580               selector dialog.  Select the background color for the <application>&app;</application>
 581               discussion area.</para>
 582             <para>Click on the <guilabel>Foreground mark</guilabel> button to display the color
 583               selector dialog.  Select the forground mark color for the
 584               <application>&app;</application> discussion area.</para>
 585             <para>Click on the <guilabel>Background mark</guilabel> button to display the color
 586               selector dialog.  Select the background mark color for the
 587               <application>&app;</application> discussion area.</para>
 588           </listitem>
 589         </varlistentry>
 590         <varlistentry>
 591           <term><guilabel>mIRC Colors</guilabel></term>
 592           <listitem>
 593             <para>Select the buttons of the colors that you wish to change, to display the color
 594               selector dialog.</para>
 595             <note>
 596               <para>The colors are only able to be changed if <guilabel>Built-in schemes</guilabel>
 597                 is set to <guilabel>Custom</guilabel>.</para>
 598             </note>
 599           </listitem>
 600         </varlistentry>
 601         <varlistentry>
 602           <term><guilabel>Extra Colors</guilabel></term>
 603           <listitem>
 604             <para>Selct the buttons of the colors that you wish to change, to display the color
 605               selector dialog.</para>
 606             <note>
 607               <para>The colors are only able to be changed if <guilabel>Built-in
 608                 schemes</guilabel> is set to <guilabel>Custom</guilabel>.</para>
 609             </note>
 610           </listitem>
 611         </varlistentry>
 612       </variablelist>
 613     </sect2>
 614     <sect2 id="xchat-gnome-prefs-transfers">
 615       <title>File Transfers &amp; DCC</title>
 616       <variablelist>
 617         <varlistentry>
 618           <term><guilabel>File Transfers</guilabel></term>
 619           <listitem>
 620             <para>Use the <guilabel>Download file to</guilabel> button to select the folder
 621               where you wish to download file.</para>
 622             <para>Use the <guilabel>Move completed files to</guilabel> button to select the
 623               folder where you wish for completed downloads to be moved.</para>
 624             <para>Select <guilabel>Convert spaces to underscore in filenames</guilabel> if you
 625               wish to have spaces converted to underscores in the filename.</para>
 626             <para>Select <guilabel>Save senders nickname in filenames</guilabel> to add the
 627                senders nickname to the downloaded file name.</para>
 628           </listitem>
 629         </varlistentry>
 630         <varlistentry>
 631           <term><guilabel>DCC Settings</guilabel></term>
 632           <listitem>
 633             <para>Select the <guilabel>Auto-accept DCC Chat</guilabel> option to automatically
 634                accept Direct Client-to-Client (DCC) chats.</para>
 635             <para>Select the <guilabel>Auto-accept DCC File Transfers</guilabel> option to
 636                automatically accept Direct Client-to-Client (DCC) file transfers.</para>
 637             <para>Select the <guilabel>Get IP Address From Server</guilabel> option to use your
 638                providers DNS to resolve an IP address.</para>
 639             <para>Select the <guilabel>Use This IP Address</guilabel> option and enter your IP
 640                address, to use a static IP address.</para>
 641           </listitem>
 642         </varlistentry>
 643         <varlistentry>
 644           <term><guilabel>Throttling</guilabel></term>
 645           <listitem>
 646             <para>Use the <guilabel>Individual send KB/s</guilabel> spin box to set your
 647               individual maximum upload speed.</para>
 648             <para>Use the <guilabel>Global send KB/s</guilabel> spin box to set your global
 649               maximum upload speed.</para>
 650             <para>Use the <guilabel>Individual receive KB/s</guilabel> spin box to set your
 651               individual maximum download speed.</para>
 652             <para>Use the <guilabel>Global receive KB/s</guilabel> spin box to set your global
 653               maximum download speed.</para>
 654           </listitem>
 655         </varlistentry>
 656       </variablelist>
 657     </sect2>
 658     <sect2 id="xchat-gnome-prefs-networks">
 659       <title>Networks</title>
 660       <variablelist>
 661         <varlistentry>
 662           <term>Internet Relay Chat (IRC) Servers</term>
 663           <listitem>
 664             <para>To add an Internet Relay Chat (IRC) server, click the <guibutton>Add</guibutton>
 665               button to open the <guilabel>Network Properties</guilabel> dialog.
 666               <xref linkend="xchat-gnome-network-properties"/></para>
 667             <para>To edit an Internet Relay Chat (IRC) server, click the <guibutton>Edit</guibutton>
 668               button to open the <guilabel>Network Properties</guilabel> dialog.
 669               <xref linkend="xchat-gnome-network-properties"/></para>
 670             <para>To remove an Internet Relay Chat (IRC) server, click the <guibutton>Remove</guibutton>
 671               button.  <xref linkend="xchat-gnome-network-properties"/></para>
 672           </listitem>
 673         </varlistentry>
 674       </variablelist>
 675     </sect2>
 676     <sect2 id="xchat-gnome-prefs-plugins">
 677       <title>Scripts and Plugins</title>
 678       <variablelist>
 679         <varlistentry>
 680           <term>Script and Plugins</term>
 681           <listitem>
 682             <para>To enable or disable a plugin or script, select the <guilabel>Enable</guilabel> option next
 683               to the appropriate item.</para>
 684             <para>To add a new plugin or script, click the <guibutton>Open</guibutton> button to open the file
 685               open dialog.</para>
 686             <para>To remove a plugin or script, select the appropriate item and click on the
 687               <guibutton>Remove</guibutton> buton .</para>
 688           </listitem>
 689         </varlistentry>
 690       </variablelist>
 691     </sect2>
 692   </sect1>
 693
 694   <sect1 id="xchat-gnome-network-properties">
 695     <title>Network Properties</title>
 696     <para>The <guilabel>Network Properties</guilabel> dialog for
 697       <application>&app;</application>, allows you to set the properties for
 698        an Internet Relay Chat (IRC) server, and contains the following tabs:</para>
 699     <itemizedlist>
 700       <listitem><para><xref linkend="xchat-gnome-network-settings"/></para></listitem>
 701       <listitem><para><xref linkend="xchat-gnome-network-users"/></para></listitem>
 702       <listitem><para><xref linkend="xchat-gnome-network-servers"/></para></listitem>
 703     </itemizedlist>
 704     <sect2 id="xchat-gnome-network-settings">
 705       <title>Network Settings</title>
 706         <variablelist>
 707           <varlistentry>
 708             <term><guilabel>General</guilabel></term>
 709             <listitem>
 710               <para>Enter the <guilabel>Name</guilabel> for the Internet Relay Chat (IRC) server.</para>
 711               <para>Select the <guilabel>Automatically connect to network</guilabel> option to connect
 712                 to a network when starting <application>&app;</application>.</para>
 713               <para>Select the <guilabel>Use secure connection (SSL)</guilabel> option to connect with Secure
 714                 Socket Layer (SSL).</para>
 715               <para>Select the <guilabel>Cycle until connected</guilabel> option to continue attempts to
 716                 connect to network, until successful.</para>
 717               <para>Use the <guilabel>Character encoding</guilabel> drop-down box to specify which character
 718                 encoding <application>&app;</application> should use.</para>
 719               <para>Enter the <guilabel>Server Password</guilabel>, if the Internet Relay Chat (IRC)
 720                 server requires it.</para>
 721             </listitem>
 722           </varlistentry>
 723         </variablelist>
 724     </sect2>
 725     <sect2 id="xchat-gnome-network-users">
 726       <title>Users and Channels</title>
 727         <variablelist>
 728           <varlistentry>
 729             <term><guilabel>Users Info</guilabel></term>
 730             <listitem>
 731               <para>Select the <guilabel>Use global user settings</guilabel> option to use the global settings
 732                 used in the <guilabel>General</guilabel> section of <xref linkend="xchat-gnome-prefs-general"/>.
 733               </para>
 734               <para>Select the <guilabel>Use the user settings</guilabel> option to set the <guilabel>Nick
 735                 name</guilabel> and <guilabel>Real Name</guilabel> specific to this Internet Relay Chat (IRC)
 736                 server.</para>
 737             </listitem>
 738           </varlistentry>
 739           <varlistentry>
 740             <term><guilabel>Automatically Join Channels</guilabel></term>
 741             <listitem>
 742               <para>Click the <guibutton>Add</guibutton> button to add a new channel.</para>
 743               <para>Click the <guibutton>Edit</guibutton> button to edit the selected channel.</para>
 744               <para>Click the <guibutton>Remove</guibutton> button to remove the selected channel.</para>
 745               <note><para>The channel name should begin with a pound sign (#).</para></note>
 746             </listitem>
 747          </varlistentry>
 748         </variablelist>
 749       </sect2>
 750       <sect2 id="xchat-gnome-network-servers">
 751         <title>Servers</title>
 752           <variablelist>
 753             <varlistentry>
 754               <term>Servers</term>
 755               <listitem>
 756                 <para>Click the <guibutton>Add</guibutton> button to add a new Internet Relay Chat (IRC)
 757                   server.</para>
 758                 <para>Click the <guibutton>Edit</guibutton> button to edit the selected Internet Relay Chat (IRC)
 759                   server.</para>
 760                 <para>Click the <guibutton>Remove</guibutton> button to remove the selected Internet Relay
 761                   Chat (IRC) server.</para>
 762               </listitem>
 763             </varlistentry>
 764         </variablelist>
 765       </sect2>
 766     </sect1>
 767
 768 <!-- ============= About ================================== -->
 769 <!-- This section contains info about the program (not docs), such as
 770       author's name(s), web page, license, feedback address. This
 771       section is optional: primary place for this info is "About.." box of
 772       the program. However, if you do wish to include this info in the
 773       manual, this is the place to put it. Alternatively, you can put this information in the title page.-->
 774   <sect1 id="xchat-gnome-about">
 775     <title>About <application>&app;</application></title>
 776     <para>To find more information about
 777       <application>&app;</application>, please visit the
 778       <ulink url="http://xchat-gnome.navi.cx/" type="http">&app; Web
 779         page</ulink>. </para>
 780     <para>
 781       To report a bug or make a suggestion regarding this application or
 782       this manual, see the Feedback section of the
 783       <ulink url="ghelp:user-guide?feedback-bugs" type="help">GNOME User Guide</ulink>.
 784     </para>
 785
 786     <para> This program is distributed under the terms of the GNU
 787       General Public license as published by the Free Software
 788       Foundation; either version 2 of the License, or (at your option)
 789       any later version. A copy of this license can be found at this
 790       <ulink url="ghelp:gpl" type="help">link</ulink>, or in the file
 791       COPYING included with the source code of this program. </para>
 792
 793   </sect1>
 794 </article>