<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kopete "<application>Kopete</application>">
  <!ENTITY Will.Stephenson "<personname><firstname>Will</firstname><surname>Stephenson</surname></personname>">
  <!ENTITY Will.Stephenson.mail "<email>lists@stevello.free-online.co.uk</email>">
  <!ENTITY package "kdenetwork">
  <!ENTITY kappname "&kopete;">
  <!ENTITY im "<acronym>IM</acronym>">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE">
]>
<!--
Intro (1st draft, Will)
Getting Started (1st draft, Will)
        Add an account
        Go online
        Start chatting
Using Kopete (1st draft, Will)
        Contact List window
		Layout
			Menu
			Toolbar
			Contact List view
			Status bar
		Set your presence
		Start a chat
            	Organising contacts
                	Adding contacts
				Metacontacts
			Grouping Contacts
				Within Metacontacts
		Configure &kopete;
		Quit.
		Shortcuts
        Chat window
		Layout
			Chat members list
			Status bar (typing notifications, etc )
			Tabbing
		Starting group chats
		Shortcuts
	        File transfers
Configuring Kopete
	Global Shortcuts
	Adding/Editing Accounts
	Behaviour/Notifications
	Look and Feel
	Loading Plugins
Plugins (Outlined, Will)
        (Section on each plugin, use, and configuration)
Menus
        (Short description of each menu item)
FAQ
Specialised Tasks
    (Any tricks involving _use_ of Kopete)
	Command line flags
Credits
Appendix: Obtaining and installation
-->

<book lang="&language;">
<bookinfo>
<title>The &kopete; Handbook</title>

<authorgroup>

<author>&Will.Stephenson; &Will.Stephenson.mail;</author>

<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>

<legalnotice>&FDLNotice;</legalnotice>

<date>2003-10-05</date>
<releaseinfo>0.8</releaseinfo>

<copyright>
<year>2003</year>
</copyright>

<!-- Abstract about this handbook -->

<abstract>
<para>
&kopete; is &kde;'s multi-protocol instant messenger client.
</para>
</abstract>


<keywordset>
<keyword>KDE</keyword>
<keyword>IM</keyword>
<keyword>Instant</keyword>
<keyword>Messaging</keyword>
<keyword>Jabber</keyword>
<keyword>IRC</keyword>
<keyword>MSN</keyword>
<keyword>ICQ</keyword>
<keyword>AIM</keyword>
<keyword>Yahoo</keyword>
<keyword>Gadu-Gadu</keyword>
<keyword>WinPopup</keyword>
<keyword>SMS</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title>Introduction</title>
<!--
<chapterinfo>
<authorgroup>
<author>
<firstname>Will</firstname>
<surname>Stephenson</surname>
<affiliation><address>
<email>lists@stevello.free-online.co.uk</email>
</address></affiliation>
</author>
</authorgroup>
<date>2003-10-05</date>
<releaseinfo>0.8</releaseinfo>
</chapterinfo>
-->
<sect1 id="intro-to-kopete">
<title>Introduction</title>
<para>&kopete; is the &kde; instant messaging (&im;) client.  It allows you to communicate using various instant messaging services.  A single program is easy to learn and use if your friends or colleagues use more than one &im; service.  </para>
<para>If you've used Instant Messaging before, you'll want to skip to <link linkend="getting-started">Getting Started</link>, otherwise, take a quick look at the following section.</para>
</sect1>
<sect1 id="intro-to-instant-messaging">
<title>Introduction to Instant Messaging</title>
<para>What is Instant Messaging (&im;)? &im; is a way for you to communicate instantly with your friends over the Internet.  That might not sound so different to email.  Have you ever noticed how cumbersome it is to have a brief conversation via email?  You have to click Reply to each message, then find the right spot in the message to type something new, then send it.  Then you have to wait for the next message to arrive! &im; lets you to have a conversation almost as naturally as on the phone or face to face, by typing messages into a window shared between you and your friend's screens.</para>
<para>Another difference between &im; and email is that with &im; you can see your friends' presence, that is, whether they are actually on-line at the same time as you.  This lets you send messages truly instantly, instead of sending off a mail and having to wait for your friend to check their mailbox.  An &im; message pops up on the other person's screen as soon as you send it.  Of course, if you'd rather not be interrupted, you can change your own presence so others will know not to disturb you.</para>
<para>There are lots of other fun and useful &im; features you can explore with &kopete;, like group chats, file transfers and emoticons that reflect your mood. Read on to find out more!</para>
</sect1>

</chapter>

<chapter id="getting-started">
<title>Getting Started</title>
<para>To use &kopete; you need to set up one or more accounts for the instant messaging services you wish to use.</para>
<para>You've probably already chosen a messaging service, either because you already use &im;, or you need to use the same service as your friends.  If you don't fit into either of these categories, please consider using a messaging service based on open standards, because these are designed for use by Free Software.  Other messaging services are prone to changing the underlying technology without making the details freely available, making them harder for Free Software developers to support.</para>
<para>The messaging services that &kopete; supports that are based on open standards are Jabber and IRC.</para>
<para>The following section assumes you are registered with an &im;
service already.  If not, you can register with Gadu-Gadu, Jabber, and
MSN from inside &kopete;; for other services, you'll have to register
using their respective web site before creating an account in
&kopete;.</para>
<sect1 id="creating-accounts">
<title>Creating Accounts</title>
<para>To create an account, use <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure &kopete;...</guimenuitem> </menuchoice> to display the Configure window.</para>
<para>The Configure window is the main way to set up and customise &kopete;.  On the left a column of icons control which aspect of &kopete; is being configured.  Click the <guiicon>Accounts</guiicon> icon.  The main pane will change to display the account management pane.  This is currently empty, but will soon list your &im; accounts.  Click <guibutton>New</guibutton> to display the <interface>Account Wizard</interface>.</para>
<para>The <interface>Account Wizard</interface> helps you create an &im; account.  After the <guilabel>Welcome</guilabel> page, you are asked to select the messaging service that you'd like to use.  Click one of the services shown and then click <guibutton>Next</guibutton>.  On the following page, you should enter your registration details for that instant messaging service.</para>
<para>Most services just require you to enter a username or unique identifying number (<acronym>UIN</acronym>) and password.  The special purpose services Winpopup and <acronym>SMS</acronym> work slightly differently, so please see their specific sections.  There are a couple of other options that apply to most services that you should look at:</para>
<variablelist>
<varlistentry><term>Remember password</term><listitem><para>When this is checked, &kopete; will store the password for you, so you don't have to enter it every time you connect to the &im; service.  If you are security-conscious or want to limit access to the &im; account you can leave this unchecked.</para></listitem></varlistentry>
<varlistentry><term>Connect at startup</term><listitem><para>When this is checked, &kopete; will try to connect to the &im; service as when it starts.  If you use a <acronym>LAN</acronym>, <acronym>DSL</acronym>or other <quote>always-on</quote> connection, this is appropriate; dial-up modem users should turn this off and connect manually when you have dialed up.</para></listitem></varlistentry>
</variablelist>
<para>Once you've entered your &im; details, you can proceed to the <guilabel>Finish</guilabel> page and then dismiss the wizard and the Configure window.</para>
</sect1><!-- creating-accounts -->
<sect1 id="go-online">
<title>Go Online and Start Chatting!</title>
<para>Now you'll notice that an icon representing the account has appeared in the status bar at the bottom of the &kopete; <interface>Contact List</interface> window.  This represents your current presence for this account.  <mousebutton>Right</mousebutton> click on it and you can go online from the menu that appears.  The status bar icon will animate while &kopete; connects to the &im; service.</para>
<para>Once you're online, if you've used this &im; service before, your contacts will be fetched from the server and displayed in the <interface>Contact List</interface>.  To start a chat with a contact, just click their name and a Chat window will appear.  The upper part of the window is where the conversation appears - to say something, type into the bottom part of the window and click <guibutton>Send</guibutton>.</para>
<para>If you've just created a new account you won't have any contacts.  See <link linkend="organise-contacts-adding">Adding Contacts</link> for details on how to add contacts.</para>
<tip><para>The shortcut for <guibutton>Send</guibutton> is set to <keycombo action="simul">&Ctrl;&Enter;</keycombo> by default; you can change it in the Chat window using <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
Shortcuts...</guimenuitem></menuchoice>.</para></tip>
</sect1><!-- go-online -->
</chapter>

<chapter id="using-kopete">
<title>Using &kopete;</title>
<para>This chapter gives an overview of &kopete;'s basic features.  We will look first at the contact list, where your contacts are displayed, and then at the Chat window, where you carry out a conversation.</para>
<sect1 id="contact-list">
<title>The Contact List</title>
<para>The Contact List appears when you start &kopete;.  It's the main window where you can set your presence, start a chat, organise your contacts, configure &kopete; and quit.</para>
<sect2 id="contact-list-layout">
<title>Layout of the Contact List window</title>
<sect3 id="contact-list-layout-menu"><title>Menu</title><para>You will usually find the menu bar at the top of the contact list.  If it's not there, you might have turned it off; you can re-enable it with <keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>.  Details on each menu item can be found in the <link linkend="menus">chapter on menu structure</link>.</para>
</sect3>
<sect3 id="contact-list-layout-toolbar"><title>Tool bar</title><para>The toolbar holds the most frequently used &kopete; actions.  You can customise it with <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure Toolbars...</guimenuitem></menuchoice>.  Notice the <guibutton>Show Offline Users</guibutton> and <guibutton>Show Empty Groups</guibutton> buttons.  With these you can hide contacts and groups that are offline.</para>
</sect3>
<sect3 id="contact-list-layout-contactlist"><title>Contact List</title><para>The Contact List takes up the main part of the window.  All your contacts are listed here, in the groups you have chosen for them.  You can open or close groups by clicking the plus symbol adjacent to the group.  You can reverse the order the groups are sorted in by clicking the <guilabel>Contacts</guilabel> label above the list.</para>
<para>The context menu in the Contact List changes depending on the item under the mouse.  Groups, <link linkend="organise-contacts-metacontacts">Metacontacts</link> and &im; system specific contacts have their own options.  The context menu in empty areas of the Contact List allows you to add contacts or groups, or change the viewing options for the list.</para>
</sect3>
<sect3 id="contact-list-layout-statusbar"><title>Status bar</title><para>The status bar shows an icon for each &im; account you have created.  The icons represent the current presence of each account, which can be changed by <mousebutton>right</mousebutton>-clicking the account icon.  </para>
</sect3>
</sect2>
<sect2 id="contact-list-setting-presence">
<title>Setting Your Presence</title>
<para>We introduced you to setting presence <link linkend="go-online">in the previous chapter</link>.  'Presence' determines how visible you are on the &im; network.  To use the network at all, you have to connect to the network, so you can send and receive messages and see others' presence.  Once you are connected, most &im; systems allow you to indicate what you're doing and whether you want to chat by setting special types of presence such as 'Away' or 'Free For Chat'.  The difference presence settings are particular to each away system; but &kopete; allows you some control all your &im; systems at once by setting them to 'Away' or 'Available' at the same time.</para>
<para>You set your presence for individual &im; accounts by <mousebutton>right</mousebutton> clicking the account's icon in the <interface>status</interface> bar at the bottom of the <interface>Contact List</interface>.  The context menu for each account lets you choose the possible presence settings for each &im; system.</para>
<para>To change all your accounts' presence together, click the <guibutton>Status</guibutton>, or use the <menuchoice><guimenu>File</guimenu> <guimenuitem>Status</guimenuitem></menuchoice> menu.</para>
</sect2>
<sect2 id="contact-list-start-chat">
<title>Start A Chat From The Contact List</title>
<para>To start a chat from the <interface>Contact List</interface>, simply click a contact.  A <link linkend="chat-window">Chat window</link> will appear.</para>
<para>You can also <mousebutton>right</mousebutton> click a contact and select either <menuchoice><guimenuitem>Send Message</guimenuitem></menuchoice> or <menuchoice><guimenuitem>Start Chat</guimenuitem></menuchoice>.  <menuchoice><guimenuitem>Send Message</guimenuitem></menuchoice> works differently in that it just sends a single message without opening the <interface>Chat window</interface>, using a simple dialog.  Use it for <quote>fire-and-forget</quote> messages.</para>
</sect2>
<sect2 id="organise-contacts">
<title>Organising Contacts</title>
<sect3 id="organise-contacts-metacontacts">
<title>A Word about Metacontacts</title>
<para>One of the principles behind &kopete; is that it offers a standardised way to use &im; systems.  Differences between &im; systems are smoothed over, making it easier to communicate.  We follow this principle in the way contacts are organised.  When you use &kopete; you just find contacts by name; the actual &im; system used is less important.  Some people have more than one &im; account - &kopete; puts the person using the account first.</para>
<para>To support this, &kopete; introduced <quote>Metacontacts</quote>, which represent the person you want to chat with.  One Metacontact contains all the different &im; IDs they may have, making it easy to see with a glance at the Metacontact whether someone is available, regardless of which &im; system they are using right now.</para>
</sect3>
<sect3 id="organise-contacts-grouping">
<title>A Word about Grouping Contacts</title>
<para>&kopete; lets you create groups to sort your contacts.  A contact may be in more than one group.  Where possible, groupings are saved on server side contact lists, so if you use other &im; programs, group memberships are kept in sync.</para>

</sect3><sect3 id="organise-contacts-adding">
<title>Adding Contacts</title>
<para>To add a contact, either select <menuchoice><guimenu>File</guimenu><guimenuitem>Add Contact...</guimenuitem></menuchoice> or click the <guibutton>Add Contact</guibutton> button on the toolbar.  This brings up the Add Contact Wizard.</para>
<para>The Add Contact Wizard creates a new Metacontact using one or more &im; systems, byleads you through the following pages:</para>

<orderedlist>
<listitem><para>Welcome Page.  Here you can choose whether you want to use the KDE Address Book for this contact.  Storing &im; information in the KDE Address Book will enable other &kde; &im; programs to share contact information with &kopete; and in future &kde; applications may use &kopete; to send information via &im;.  If you prefer to keep your &im; contacts separated, clear the checkbox here.</para></listitem>
<listitem><para>Choose KDE Address Book entry.  By choosing an entry from your KDE Address Book, you can use its name as a Display Name in &kopete;.  You can also create a new entry here.  This page doesn't show if you chose not to use the KDE Address Book.</para></listitem>
<listitem><para>Select Display Name and Group.  Here you can enter a Display Name (the name used for this person inside &kopete;), and choose the <link linkend="organise-contacts-grouping">groups</link> they are a member of.</para></listitem>
<listitem><para>Select &im; Accounts.  Here you can choose which accounts you want to use to chat to the new contact.  If you only have one &im; account yourself, you won't see this screen.</para></listitem>
<listitem><para>Account-specific Add Contact Pages.  For each account, you'll get one page where you can enter the <acronym>UIN</acronym>, buddy name or E-mail address, depending on the &im; system in use.</para></listitem>
<listitem><para>Finish Screen.  All done.  Except if the &im; system requires authorisation (such as <trademark>ICQ</trademark>) to add a contact to your list - in which case, you'll be prompted after the wizard exits.</para></listitem>
</orderedlist>

<para>You can add contacts to an existing Metacontact using its context menu.</para>
</sect3>

<sect3 id="organise-contacts-removing">
<title>Removing Contacts</title>
<para>If you no longer want a contact to be in the contact list, you can remove a Metacontact and all the contacts under it with <menuchoice><guimenu>Metacontact context menu</guimenu><guimenuitem>Remove Contact</guimenuitem></menuchoice>.</para>
</sect3>
<sect3 id="organise-contacts-moving-contact">
<title>Moving Contacts between Metacontacts</title>
<para>You can change the metacontact a contact belongs to.  In practice, you only have to do this when you have just added multiple accounts to &kopete;, and you know that HotDog76 and mikejones@hotmail.com are both the same person.</para>
<para>There are two ways to do this:</para>
<variablelist>
<varlistentry><term>Drag and Drop</term><listitem><para>The contact icon to the right of the Metacontact name may be dragged from one Metacontact to another.</para></listitem></varlistentry>
<varlistentry><term>Contact Context Menu</term><listitem><para>The context menu for contacts (<mousebutton>Right</mousebutton>-click the contact icon) allows you to choose the new Metacontact from a dialog.</para></listitem></varlistentry>
</variablelist>
<para>If the move would leave a Metacontact empty (with no contacts), you'll be asked if you want to delete this contact.</para>
</sect3>
<sect3 id="organise-contacts-removing-contacts-">
<title>Removing Contacts from Metacontacts</title>
<para>To remove a contact from a Metacontact, choose <menuchoice><guimenu>Contact context menu</guimenu><guimenuitem>Delete Contact</guimenuitem></menuchoice>.</para>
</sect3>
</sect2>
<sect2 id="contact-list-configure">
<title>Configure &kopete;</title>
<para>You can configure &kopete; using <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kopete;...</guimenuitem></menuchoice>.  See the <link linkend="configuring">next chapter</link> for details.</para>
</sect2>
<sect2 id="contact-list-quit">
<title>Exiting &kopete;</title>
<para>To exit &kopete; you should use <menuchoice><guimenu>File</guimenu><guimenuitem>Quit</guimenuitem></menuchoice>, <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>, or the &kopete; System Tray icon's context menu.  If you just close the Contact List window, &kopete; will continue to run in the KDE System Tray.</para>
</sect2>
<sect2 id="contact-list-shortcuts">
<title>Keyboard shortcuts</title>
<para>The following keyboard shortcuts are supported in the Contact List window:</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Keyboard Shortcut</entry>
<entry>Action</entry>
</row>
</thead>
<tbody>
<row>
<entry><keycap>Up Arrow</keycap></entry>
<entry>Select the previous item in the contact list.</entry>
</row>
<row>
<entry><keycap>Down Arrow</keycap></entry>
<entry>Select the next item in the contact list.</entry>
</row>
<row>
<entry><keycap>Left Arrow</keycap></entry>
<entry>Close the current group.</entry>
</row>
<row>
<entry><keycap>Right Arrow</keycap></entry>
<entry>Open the current group.</entry>
</row>
<row>
<entry><keycap>Enter</keycap></entry>
<entry>Start a chat with the selected contact.</entry>
</row>
<row>
<entry><keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo></entry>
<entry>Show/Hide the menu bar.</entry>
</row>
<row>
<entry><keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo></entry>
<entry>Show/Hide offline users.</entry>
</row>
<row>
<entry><keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo></entry>
<entry>Show/Hide empty groups.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect2>
</sect1><!-- contact-list -->

<sect1 id="chat-window">
<title>The Chat Window</title>
<sect2 id="chat-window-layout"><title>Layout of the Chat Window</title>
<sect3 id="chat-window-layout-chatview"><title>The Chat View</title><para>The Chat View usually takes up most of the Chat window and is where the conversation between you and your contacts takes place.  Messages appear in the order they are received, with the earliest messages at the top of the view.</para>
<para>You can <link linkend="configuring-appearance">control</link> the appearance of the <interface>Chat View</interface>, making it look like other &im; clients or create a completely individual look.</para>
</sect3>
<sect3 id="chat-window-layout-memberslist"><title>Chat Members List</title>
<para>Since some &im; systems allow you to chat as a group, it's useful to see who's chatting at the moment.  The Chat Members List appears to the left or the right of the Chat View.  You can change this using <menuchoice><guimenu>Settings</guimenu><guisubmenu>Chat Members List</guisubmenu></menuchoice>.  The contact context menu is available in the Chat Members List.</para></sect3>
<sect3 id="chat-window-layout-input-area"><title>Input Area</title><para>The Input Area is below the Chat View.  This is where you type messages before sending them.  You can change the font and colour of the message using the usual tools on the toolbar.  If the &im; system supports this, your messages will appear in colour when your contacts read them.</para><para>By default, the keyboard shortcut to send messages is <keycombo action="simul">&Ctrl;&Enter;</keycombo>.</para></sect3>
<sect3 id="chat-window-layout-statusbar"><title>Status Bar</title><para>The Status Bar contains temporary messages, such as notification that someone else is typing, as well as the <guibutton>Send</guibutton> button.</para></sect3>
<sect3 id="chat-window-layout-tabbing"><title>Tabbing</title><para>&kopete; lets you carry on multiple conversations in one window, by putting each one in its own tab within the window.  The tab titles change colour to show when a new message has been received:</para>
<variablelist>
<varlistentry><term>Red</term><listitem><para>Someone typed a message.</para></listitem></varlistentry>
<varlistentry><term>Blue</term><listitem><para>Someone typed a message containing your nickname.</para></listitem></varlistentry>
</variablelist> 
<para>There are several different ways to control grouping.  To configure this behaviour, go to the Chat tab of the Behaviour page of the Configure &kopete; dialog.  You can also move chats between windows using the <menuchoice><guimenu>Tabs</guimenu></menuchoice> menu, and control the placement of the tabs in the window.</para></sect3>
</sect2>
<sect2 id="chat-window-group">
<title>Group Chats in &kopete;</title>
<para>You can use &kopete; to chat one to one, or in a group, where the &im; system supports this.</para>
<para>MSN lets you invite others into a chat using <menuchoice><guimenu>Chat</guimenu><guisubmenu>Invite</guisubmenu><guimenuitem>&lt;contact name&gt;</guimenuitem></menuchoice>.</para>
</sect2>
<sect2 id="chat-window-file-xfer">
<title>File Transfers</title>
<para>Some &im; systems allow you to send and receive files.  You can access this function from the contact's context menu.  If you're already chatting, and want to send a file, select the recipient from the <menuchoice><guimenu>Chat</guimenu><guisubmenu>Contacts</guisubmenu></menuchoice> menu.</para>
</sect2>
<sect2 id="chat-window-shortcuts">
<title>Keyboard Shortcuts</title>
<para>The following keyboard shortcuts are supported in the Chat window:</para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Keyboard Shortcut</entry>
<entry>Action</entry>
</row>
</thead>
<tbody>
<row>
<entry><keycombo action="simul">&Ctrl;&Enter;</keycombo></entry>
<entry>Send the message in the <interface>Input Area</interface>.</entry>
</row>
<row>
<entry><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></entry>
<entry>Print the contents of the Chat View.</entry>
</row>
<row>
<entry><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></entry>
<entry>Save the contents of the Chat View.</entry>
</row>
<row>
<entry><keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></entry>
<entry>Close the current Chat View.  The Chat window will close unless there is more than one tab in the window.</entry>
</row>
<row>
<entry><keycombo action="simul">&Alt;<keycap>Left Arrow</keycap></keycombo></entry>
<entry>Change to the previous tab.</entry>
</row>
<row>
<entry><keycombo action="simul">&Alt;<keycap>Right Arrow</keycap></keycombo></entry>
<entry>Change to the next tab.</entry>
</row>
<row>
<entry><keycombo action="simul">&Ctrl;&Shift;<keycap>B</keycap></keycombo></entry>
<entry>Detach a tabbed chat into a separate window.</entry>
</row>
<row>
<entry><keycap>Tab</keycap></entry>
<entry>Complete a partially typed nickname belonging to someone you're chatting with.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect2>

</sect1><!-- chat-window -->
</chapter><!-- Using-kopete -->

<chapter id="configuring">
<title>Configuring &kopete;</title>
<para>To configure &kopete;...</para>
<sect1 id="configuring-global-shortcuts">
<title>Global Shortcuts</title>
<para>&kopete; defines some shortcuts which are valid in any KDE application.</para>
</sect1>
<sect1 id="configuring-accounts">
<title>Adding and Editing Accounts</title>
<para>We briefly showed you how to add an account in <link linkend="getting-started">Getting Started</link>.  To change an account's setting later...</para>
</sect1>
<sect1 id="configuring-behaviour-notifications">
<title>Behaviour and Notifications</title>
<para>Behaviour and Notifications covers the way &kopete; integrates with your desktop, <quote>Away</quote> settings, and chat user interface options.</para>
</sect1>
<sect1 id="configuring-appearance">
<title>Appearance</title>
<para>Appearance governs the style of the Chat window, its colours and fonts, and lets you choose your preferred emoticons.</para>
</sect1>
<sect1 id="configuring-loading-plugins">
<title>Loading Plugins</title>
<para>You can customise &kopete; with special functions that may be useful or just a bit of fun.</para>
<!--FIND OUT WHAT THE FINAL PLUGIN LOADING UI WILL BE LIKE -->
</sect1>
</chapter> <!-- configuring -->

<chapter id="plugins">
<title>&kopete;'s plugins</title>
<para>&kopete; is designed to make it easy to create plugins that give &kopete; more functions.</para>
<sect1 id="plugins-auto-replace">
<title>Auto Replace</title>
<para>Auto Replace allows you to correct frequently misspelled words or save typing certain words using abbreviations.</para>
</sect1>
<sect1 id="plugins-connection-status">
<title>Connection Status</title>
<para>Connection Status is useful for modem users or others who don't have a permanent Internet connection.  It watches for an active Internet connection and sets your accounts online when it detects you have dialed up.</para>
</sect1>
<sect1 id="plugins-contact-notes">
<title>Contact Notes</title>
<para>Contact Notes allows you to note down any useful bits of information on a metacontact.</para>
</sect1>
<sect1 id="plugins-cryptography">
<title>Cryptography</title>
<para>Cryptography lets you use <acronym>GPG</acronym> to encrypt conversations.  Note that this is not the same as an SSL secured chat session - this kind of encryption not only ensures the message cannot be tampered with, it also guarantees that only the intended recipient can read the messages.</para>
</sect1>
<sect1 id="plugins-highlight">
<title>Highlight</title>
<para>Highlight works a little like e-mail filters, in that it allows you to make things happen in response to particular messages.  As well as highlighting the text, you can play sounds.</para>
</sect1>
<sect1 id="plugins-history">
<title>History</title>
<para>The History plugin, when activated, records conversations using any &im; system and allows you to view old conversations later.  A <menuchoice><guimenuitem>History</guimenuitem></menuchoice> item appears in each Metacontact's context menu, to view the message history for that metacontact.</para>
</sect1>
<sect1 id="plugins-motion-auto-away">
<title>Motion Auto-Away</title>
<para>In conjunction with a webcam and the Video4Linux package, this lets you detect when you're no longer at your computer and have &kopete; automatically become <quote>Away</quote>.</para>
</sect1>
<sect1 id="plugins-now-listening">
<title>Now Listening</title>
<para>With the Now Listening plugin, let people you're chatting with know what you're listening to, by typing <userinput>/media</userinput> in a chat, or from the <menuchoice><guimenu>File</guimenu><guimenu>Actions</guimenu></menuchoice> menu.</para>
</sect1>
<sect1 id="plugins-text-effect">
<title>Text Effect</title>
<para>Text Effect applies funny effects to your messages before sending them, like colouring them or changing the case of the words.  Just don't forget you have activated it - we've had bug reports from forgetful Text Effect users!</para>
</sect1>
<sect1 id="plugins-translator">
<title>Translator</title>
<para>The Translator plugin lets you define a preferred language for each Metacontact, and then translates messages to or from them using web based translation services such as <trademark>Google</trademark> and <trademark>Babelfish</trademark>.</para>
</sect1>
<sect1 id="plugins-web-presence">
<title>Web Presence</title>
<para>Web Presence allows you to publicise your &im; presence on the Web.  Give it the path to a file on an FTP server, (for example), and it will upload a short piece of HTML to that file, which you can include in your homepage.  Good for bloggers to make friends with, or you could use it to use &im; in your business.</para>
</sect1>
</chapter><!-- plugins -->

<chapter id="menus">
<title>Menu Structure</title>
<para>File Menu</para>
</chapter> <!-- menus -->

<chapter id="faq">
<title>Frequently Asked Questions</title>
<para>Question:</para>
<para>Answer:</para>
</chapter> <!-- faq -->

<chapter id="specialised">
<title>Specialised Actions</title>
<para>Command line parameters</para>
</chapter> <!-- specialised -->

<chapter id="credits-and-licenses">
<title>Credits and Licenses</title>
<para>
&kopete; copyright 2003, &kopete; Developers
</para>
<para>
Documentation copyright 2003, Will Stephenson
</para>
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
&underFDL;
&underGPL;
</chapter><!-- credits-and-licenses -->

&documentation.index;
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->
