# &app; Manual

2005-2006
Brian Pepple
2006
Joachim Noreiko
Brian Pepple

&legal;

Brian
Pepple
Fedora Project

     bpepple@fedoraproject.org

Joachim
Noreiko
GNOME Documentation Project

     jnoreiko@yahoo.com

&app; Manual &manrevision;
&date;

Joachim Noreiko jnoreiko@yahoo.com

GNOME Documentation Project

XChat-GNOME Manual V2.0
November 2005

Brian Pepple bpepple@fedoraproject.org

GNOME Documentation Project

This manual describes version &appversion; of XChat-GNOME.

## Feedback

To report a bug or make a suggestion regarding the &app; application or this manual, follow the directions in the Feedback section of the GNOME User Guide.

A user manual which describes the use of the XChat-GNOME IRC client.

## Introduction

The &app; application is an Internet Relay Chat (IRC) program for the GNOME desktop.

&app; provides the following features:

- Notification Area Icon Plugin

- Direct Client-To-Client (DCC) Transfers

- Direct Client-To-Client (DCC) Chats

- Adherence to GNOME Human Interface Guidelines (HIG)

## Getting Started

### Starting &app;

You can start &app; in the following ways:

Applications menu

  Choose Internet XChat-GNOME IRC Chat .

Command line

  To start &app; from a command line, type `xchat-gnome`, then press Return:

  To view other command line options that are available, type `xchat-gnome --help`, then press Return

### When You Start &app;

When you start &app;, the following window is displayed.

#### &app; Main Window

Shows &app; main window. Contains titlebar, menubar, display area, and scrollbars. Menubar contains IRC, Edit, Network, Discussion, Go, and Help menus.

The &app; window contains the following elements:

Menubar

  The menus on the menubar contain all of the commands you need to use in &app;.

Server Pane

  The Server Pane shows the Servers and Channels currently connected.

User Button

  The User Button shows the number of users present in the selected Channel. Click the User Button to show a list of users.

Discussion Area

  The Discussion Area presents the discussion occurring in the selected Channel.

  Type into the message input line at the bottom of the discussion area to chat in the selected Channel.

## Usage

### Connecting to an Internet Relay Chat (IRC) Server

To connect to an Internet Relay Chat (IRC) Server, choose IRC Connect . The Connect dialog is displayed. Select the Server that you wish to connect to, then click Connect.

### Viewing Direct Client-To-Client (DCC) File Transfers Information

To view Direct Client-To-Client (DCC) file transfer information, choose IRC File Transfers .

### Editing Text

You can edit text in the following ways:

- To delete the selected text from the file and move the selected text to a buffer, choose Edit Cut .

- To copy the selected text to a buffer, choose Edit Copy .

- To insert the contents of the buffer at the cursor position, choose Edit Paste . You must cut or copy text before you can paste text into the file.

- To clear all text from the Discussion Area for the currently selected Channel, choose Edit Clear.

### Reconnecting to a Server

To reconnect &app; to an Internet Relay Chat (IRC) server, choose Network Reconnect .

### Disconnecting from a Server

To disconnect &app; from an Internet Relay Chat (IRC) server, choose Network Disconnect .

### Saving a Channel Transcript

To save a transcript of a Channel, choose Ctrl S Discussion Save Transcript .

### Leaving a Channel

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.

To leave a Channel, choose Ctrl Q Discussion Leave .

### Closing a Channel

When you close a channel, the channel is removed from the list in the Server Pane.

To close a Channel, choose Ctrl W Discussion Close .

### Navigating through Channels

- To view previous channel, choose Alt Up Go Previous Discussion

- To view next channel, choose Alt Down Go Next Discussion

### Navigating Through Servers

- To view previous server, choose Ctrl Up Go Previous Network

- To view next server, choose Ctrl Down Go Next Network

### Quitting &app;

To quit &app;, choose Ctrl Q IRC Quit .

## Preferences

To modify the preferences of &app;, choose Edit Preferences . The Preferences dialog contains the following sections:

### IRC Preferences

General

  Enter the Nickname you wish to use in the Internet Relay Chat (IRC) channel.

  Enter your Real Name, which is displayed on `/whois` requests.

  Enter the Quit Message you wish to be shown to other users when you leave an Internet Relay Chat (IRC) network.

  Enter the Part Message 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.

  Enter the Away Message you wish to be shown to people who try to contact you when you are away.

Highlighting

  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.

Use Interface

  Select the Use System Terminal Font option to use the same fonts as your system terminal.

  Select the Use this font option to open the Font Selection dialog box.

  Select the Show colors option to enable color nicknames in discussion area.

  Select the Show timestamps option to show timestamps of discussion.

### Colors

Text Colors

  Use the Built-in schemes drop-down box to specify how &app; should display the text and backgroud color. Select one of the following options:

  - Use the Black on White option to provide black text on a white background.

  - Use the White on Black option to provide white text on a black background.

  - Use the Custom option to create a custom color scheme.

  The following options are only able to be changed if Built-in schemes is set to Custom.

  Click on the Foreground color button to display the color selector dialog. Select a foreground color for the &app; discussion area.

  Click on the Background color button to display the color selector dialog. Select the background color for the &app; discussion area.

  Click on the Foreground mark button to display the color selector dialog. Select the forground mark color for the &app; discussion area.

  Click on the Background mark button to display the color selector dialog. Select the background mark color for the &app; discussion area.

mIRC Colors

  Select the buttons of the colors that you wish to change, to display the color selector dialog.

  The colors are only able to be changed if Built-in schemes is set to Custom.

Extra Colors

  Selct the buttons of the colors that you wish to change, to display the color selector dialog.

  The colors are only able to be changed if Built-in schemes is set to Custom.

### File Transfers & DCC

File Transfers

  Use the Download file to button to select the folder where you wish to download file.

  Use the Move completed files to button to select the folder where you wish for completed downloads to be moved.

  Select Convert spaces to underscore in filenames if you wish to have spaces converted to underscores in the filename.

  Select Save senders nickname in filenames to add the senders nickname to the downloaded file name.

DCC Settings

  Select the Auto-accept DCC Chat option to automatically accept Direct Client-to-Client (DCC) chats.

  Select the Auto-accept DCC File Transfers option to automatically accept Direct Client-to-Client (DCC) file transfers.

  Select the Get IP Address From Server option to use your providers DNS to resolve an IP address.

  Select the Use This IP Address option and enter your IP address, to use a static IP address.

Throttling

  Use the Individual send KB/s spin box to set your individual maximum upload speed.

  Use the Global send KB/s spin box to set your global maximum upload speed.

  Use the Individual receive KB/s spin box to set your individual maximum download speed.

  Use the Global receive KB/s spin box to set your global maximum download speed.

### Networks

Internet Relay Chat (IRC) Servers

  To add an Internet Relay Chat (IRC) server, click the Add button to open the Network Properties dialog.

  To edit an Internet Relay Chat (IRC) server, click the Edit button to open the Network Properties dialog.

  To remove an Internet Relay Chat (IRC) server, click the Remove button.

### Scripts and Plugins

Script and Plugins

  To enable or disable a plugin or script, select the Enable option next to the appropriate item.

  To add a new plugin or script, click the Open button to open the file open dialog.

  To remove a plugin or script, select the appropriate item and click on the Remove buton .

## Network Properties

The Network Properties dialog for &app;, allows you to set the properties for an Internet Relay Chat (IRC) server, and contains the following tabs:

### Network Settings

General

  Enter the Name for the Internet Relay Chat (IRC) server.

  Select the Automatically connect to network option to connect to a network when starting &app;.

  Select the Use secure connection (SSL) option to connect with Secure Socket Layer (SSL).

  Select the Cycle until connected option to continue attempts to connect to network, until successful.

  Use the Character encoding drop-down box to specify which character encoding &app; should use.

  Enter the Server Password, if the Internet Relay Chat (IRC) server requires it.

### Users and Channels

Users Info

  Select the Use global user settings option to use the global settings used in the General section of .

  Select the Use the user settings option to set the Nick name and Real Name specific to this Internet Relay Chat (IRC) server.

Automatically Join Channels

  Click the Add button to add a new channel.

  Click the Edit button to edit the selected channel.

  Click the Remove button to remove the selected channel.

  The channel name should begin with a pound sign (#).

### Servers

Servers

  Click the Add button to add a new Internet Relay Chat (IRC) server.

  Click the Edit button to edit the selected Internet Relay Chat (IRC) server.

  Click the Remove button to remove the selected Internet Relay Chat (IRC) server.

## About &app;

To find more information about &app;, please visit the &app; Web page.

To report a bug or make a suggestion regarding this application or this manual, see the Feedback section of the GNOME User Guide.

This program is distributed under the terms of the GNU General Public license as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. A copy of this license can be found at this link, or in the file COPYING included with the source code of this program.