← Back to branch summary

~ubuntu-branches/ubuntu/trusty/xchat-gnome/trusty-updates

« back to all changes in this revision

Viewing changes to help/sl/xchat-gnome.xml

  • Committer: Bazaar Package Importer
  • Author(s): Mathieu Trudel-Lapierre
  • Date: 2011-07-05 12:27:58 UTC
  • mfrom: (1.1.19 upstream) (2.1.6 sid)
  • Revision ID: james.westby@ubuntu.com-20110705122758-bkl6xii0ebfddtmh
Tags: 1:0.30.0~git20100421.29cc76-1ubuntu1
https://launchpad.net/bugs/773847
https://launchpad.net/bugs/374686
* Merge with Debian unstable, remaining changes: (LP: #773847)
  - debian/control:
    - add Build-Depends on liblaunchpad-integration-dev.
    - xchat-gnome Suggests: xchat-gnome-indicator.
  - debian/patches/02_lpi.patch: add Launchpad integration items to the help
    menu
  - debian/patches/10_xchat-gnome-close-event.patch: add events for window
    close.
  - debian/patches/04_autojoin_ubuntu_chan.patch: add the Ubuntu network
    as default selection and default to autojoining #ubuntu.
  - debian/patches/20_add_gui_focus.patch: implement GUI focus from XChat.
  - debian/patches/51_freenode_default_port_8001.patch: Drop ports 666x
    for FreeNode to workaround a possible DCC exploit.
  - debian/patches/95_apturl-support.patch: support apt://-urls.
  - debian/watch: also look for unstable versions
  - debian/xchat-gnome.gconf-defaults: Set the default enabled plugins,
    indicator, netmonitor, and notifyosd.
* debian/patches/52_no_zero_width_pixmaps.patch: dropped, applied upstream.
* debian/patches/98_ice_depends_for_eggsmclient.patch: replaced by
  01_link_libice.patch.
* debian/control: remove duplicate entry in Build-Depends for intltool.
* debian/xchat-gnome.install: also install the xchat-gnome.desktop file from
  /usr/share/applications in xchat-gnome rather than xchat-gnome-common.
  (LP: #374686)
* debian/rules: update the xchat-gnome-common binary-install target to not
  keep a duplicate copy of the xchat-gnome.desktop file.

Show diffs side-by-side

added added

removed removed

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