10139N/A<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [

10139N/A<!--ArborText, Inc., 1988-1999, v.4002-->

12161N/A<!ENTITY cmd "pidgin">

12161N/A<!ENTITY % commonents SYSTEM "smancommon.ent">

10139N/A%commonents;

10139N/A<!ENTITY % booktitles SYSTEM "booktitles.ent">

10139N/A%booktitles;

10139N/A<!ENTITY suncopy "Copyright (c) 2003,2006,2007 Sun Microsystems, Inc. All Rights Reserved.">

10315N/A]>

10139N/A<?Pub UDT _bookmark _target>

10139N/A<?Pub Inc>

10139N/A<refentry id="pidgin-1">

10139N/A<refmeta><refentrytitle>pidgin</refentrytitle><manvolnum>1</manvolnum>

10139N/A<refmiscinfo class="date">12 Nov 2007</refmiscinfo>

10139N/A<refmiscinfo class="sectdesc">&man1;</refmiscinfo>

10315N/A<refmiscinfo class="software">&release;</refmiscinfo>

10139N/A<refmiscinfo class="arch">generic</refmiscinfo>

11330N/A<refmiscinfo class="copyright">&suncopy;</refmiscinfo>

11330N/A</refmeta>

10139N/A<indexterm><primary>pidgin</primary></indexterm><indexterm><primary>Instant

10139N/AMessaging client</primary></indexterm>

10139N/A<refnamediv id="pidgin-1-name"><refname>pidgin</refname><refpurpose>Instant Messaging

10139N/Aclient</refpurpose></refnamediv>

10139N/A<refsynopsisdiv id="pidgin-1-synp"><title>&synp-tt;</title>

10139N/A<cmdsynopsis><command>&cmd;</command>

10139N/A<arg><option>-config</option>=<replaceable>directory</replaceable></arg>

10139N/A<arg><option>-debug</option></arg>

10139N/A<arg><option>-login</option>=<replaceable>name</replaceable></arg>

11330N/A<arg><option>-nologin</option></arg>

10139N/A<arg choice="opt"><option><replaceable>gnome-std-options</replaceable></option></arg>

12754N/A</cmdsynopsis></refsynopsisdiv>

10139N/A<refsect1 id="pidgin-1-desc"><title>&desc-tt;</title>

10139N/A<para>&cmd; is a graphical modular messaging client based on libpurple. It

10374N/Asupports multiple protocols including AIM, MSN, Yahoo!, XMPP, ICQ, IRC,

10374N/A GroupWise and GTalk all at once. It has many common features found in other clients,

10374N/A as well as many unique features.

10374N/A</para>

10374N/A</refsect1>

10374N/A<refsect1 id="pidgin-1-opts"><title>&opts-tt;</title>

10374N/A<para>The following options are supported:</para>

10374N/A<variablelist termlength="wide">

10374N/A<varlistentry>

10374N/A<term><option>c</option>, <option>-config=<replaceable>directory</replaceable></option></term>

10374N/A<listitem><para>

11330N/AUse <replaceable>directory</replaceable> as the directory for config files

11330N/Ainstead of <filename>~/.purple</filename>.

11330N/A</para>

10374N/A</listitem></varlistentry>

10374N/A<varlistentry>

10374N/A<term><option>d</option>, <option>-debug</option></term>

10374N/A<listitem><para>

10374N/APrint debug messages to <literal>stdout</literal>. These are the same debug

10374N/Amessages that are displayed in the Debug window.

10374N/A</para>

10374N/A</listitem></varlistentry>

10374N/A<varlistentry>

10374N/A<term><option>l</option>, <option>-login[=<replaceable>name</replaceable>,<replaceable>name</replaceable>,...]</option></term>

11331N/A<listitem><para>

10139N/ALog in with the comma-separated list of accounts provided, in addition to any

10139N/Aaccounts that are configured to be logged in automatically. If no argument

11331N/Ais provided, your first account will be signed in.

10139N/A</para>

10139N/A</listitem></varlistentry>

10139N/A<varlistentry>

10139N/A<term><option>n</option>, <option>-nologin</option></term>

10139N/A<listitem><para>

10139N/ADo not automatically login when &cmd; starts. Sets the global status

10139N/Ato Offline.

10139N/A</para>

10139N/A</listitem></varlistentry>

10139N/A<varlistentry>

10139N/A<term><option role="nodash"><replaceable>gnome-std-options</replaceable></option></term>

10139N/A<listitem><para>

10139N/AStandard options available for use with most GNOME applications. See

10139N/A<citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry>.

10139N/A</para>

10139N/A</listitem></varlistentry>

10139N/A</variablelist></refsect1>

10139N/A<refsect1 id="pidgin-1-exde"><title>&exde-tt;</title>

10139N/A<refsect2 id="pidgin-1-exde-buddylist">

10139N/A

10139N/A<title>Buddy List</title>

10139N/A<para>

10139N/AThe Buddy List window is &cmd;'s main interface window. Using this window you

10139N/Acan see which of your buddies is online, away, idle, etc. You can also add and

11330N/Aremove buddies from your buddy list.

11330N/A</para>

10374N/A<para>

10374N/AThe Buddy List window contains a list of your buddies who are online and have

10315N/Aallowed you to be notified of their presence. The icon to the left of each

10315N/Abuddy indicates the buddy's current state and the protocol they are using.

10139N/ADouble clicking a buddy will open a new Conversation window. Right clicking

10139N/Awill pop up a menu:

10139N/A</para>

10139N/A

10139N/A<variablelist termlength="wholeline">

10139N/A<varlistentry>

<term>Get Info</term>

<listitem><para>

Retrieves and displays information about the buddy. This information is also

known as a Profile.

</para></listitem></varlistentry>

<varlistentry><term>IM</term>

<listitem><para>

Opens a new Conversation window to the selected buddy.

</para></listitem></varlistentry>

<varlistentry><term>Send File</term>

<listitem><para>

Sends a file to the selected buddy (only available on protocols that support

file transfer).

</para></listitem></varlistentry>

<varlistentry><term>Add Buddy Pounce</term>

<listitem><para>

A Buddy Pounce is a configurable automated action to be performed when the

buddy's state changes. This will open the Buddy Pounce dialog to be discussed

later.

</para></listitem></varlistentry>

<varlistentry><term>View Log</term>

<listitem><para>

&cmd; is capable of automatically log its activities. These logs are either

plain text files (with a .txt extension) or html files (with a .html extension)

located under the <filename>~/.purple/logs</filename> directory. This menu

command will display &cmd;'s log viewer with logs loaded for that buddy or

chat.

</para></listitem></varlistentry>

<varlistentry><term>Alias</term>

<listitem><para>

Create an alias for this buddy. This will open up a new dialog in which one

can give this buddy an alternate name to appear on the buddy list and in

conversations.

</para>

<para>

For example, if a buddy's name screen name was jsmith1281xx and his real name

was 'John Q. Smith,' one could create an alias as to identify the buddy by his

common name.

</para>

</listitem></varlistentry>

</variablelist>

<para>

The remainder of the menu will consist of protocol specific commands. These

commands vary depending on the protocol.

</para>

<para>

At the bottom of the Buddy List are several buttons (if enabled in

Preferences):

</para>

<variablelist termlength="xtranarrow">

<varlistentry><term>IM</term>

<listitem><para>

Opens a new Conversation window to to the selected buddy, or brings up the New

Message dialog box if no buddy is selected.

</para></listitem></varlistentry>

<varlistentry><term>Info</term>

<listitem><para>

Retrieves and displays information about the selected buddy, or brings up the

Get User Info dialog box if no buddy is selected.

</para></listitem></varlistentry>

<varlistentry><term>Chat</term>

<listitem><para>

Brings up the Join Chat dialog box, prompting the user to select which

username to use and what chat group to join.

</para></listitem></varlistentry>

<varlistentry><term>Away</term>

<listitem><para>

Brings up a menu of all available Away Messages. If an item is selected, all

online accounts will use this item as their away message.

</para></listitem></varlistentry>

</variablelist>

</refsect2>

<refsect2 id="pidgin-1-exde-acct-editor">

<title>ACCOUNT EDITOR </title>

<para>

The account editor consists of a list of accounts and information about them.

Clicking <replaceable>Delete</replaceable> will delete the currently selected

account. Clicking <replaceable>Add</replaceable> or

<replaceable>Modify</replaceable> will invoke a Modify Account window. Here,

you can add or alter account information. When creating a new account, you

will submit your screen name and password. You will also choose your protocol.

</para>

<para>

If <replaceable>Remember Password</replaceable> is chosen, the password will be

saved in &cmd;'s configuration file.

</para>

<para>

If <replaceable>Auto-Login</replaceable> is chosen, this account will

automatically login upon starting &cmd;.

</para>

<para>

Each protocol has it's own specific options that can be found in the modify

screen.

</para>

</refsect2>

<refsect2 id="pidgin-1-exde-prefs">

<title>PREFERENCES</title>

<para>All options take effect immediately.</para>

<variablelist termlength="wholescreen">

<varlistentry><term>Interface</term>

<listitem><para>

<replaceable>Display remote nicknames if no alias is set</replaceable>:

Toggles whether server nickname data should be used if no local alias exists.

</para></listitem></varlistentry>

<varlistentry><term>Buddy List</term>

<listitem>

<para>

<replaceable>Sorting</replaceable>: Toggles the order in which buddies are

shown in your Buddy List between none, alphabetical, by status and by log size. </para>

<para>

<replaceable>Show buttons as</replaceable>: Toggles between picture-only,

text-only, picture and text or no buttons view of the buttons on the Buddy

List.

</para>

<para>

<replaceable>Raise window on events</replaceable>: Tells &cmd; to bring the

Buddy List window to the top when buddies sign in or out.

</para>

<para>

<replaceable>Show numbers in groups</replaceable>: The number of buddies from

each group currently logged in will be shown along with the total number of

buddies in the group.

</para>

<para>

<replaceable>Show buddy icons</replaceable>: Toggles the display of buddies'

custom icons.

</para>

<para>

<replaceable>Show warning levels</replaceable>: Each buddy's warning level

will be displayed next to the screen name. As a buddy's warning level

increases, outgoing messages are more and more severely rate-limited.

</para>

<para>

<replaceable>Show idle times</replaceable>: The amount of time each buddy has

been idle will be displayed next to the screen name (if the buddy has opted to

have their client report this information).

</para>

<para>

<replaceable>Dim idle buddies</replaceable>: If enabled, idle buddies will be

displayed in grey text instead of black text.

</para>

<para>

<replaceable>Automatically expand contacts</replaceable>: If enabled, contacts

will automatically expand to show the associated buddies when the mouse is held over the contact for a short period.

</para>

</listitem>

<varlistentry><term>Conversations</term>

<listitem>

<para>

<replaceable>Show buttons as</replaceable>...: The selected item will

determine whether picture-only, text-only, combined picture/text, or no buttons

will be used for Conversation windows.

</para>

<para>

<replaceable>Show formatting toolbar</replaceable>: Display the formatting

toolbar between the upper and lower text boxes in conversations.

</para>

<para>

<replaceable>Show aliases in tabs/titles</replaceable>: Displays buddy alias

instead of screen name in window tabs and titles.

</para>

<para>

<replaceable>Show buddy icons</replaceable>: For protocols that support it,

buddy icons allow buddies to send small pictures to be displayed during the

course of a conversation. Turning this option off hides those pictures.

</para>

<para>

<replaceable>Enable buddy icon animation</replaceable>: If these pictures

happen to be animated, this option will enable the animation, otherwise only

the first frame will be displayed.

</para>

<para>

<replaceable>Notify buddies that you are typing to them</replaceable>: Some

protocols allow clients to tell their buddies when they are typing. This option

enables this feature for protocols that supports it.

</para>

<para>

<replaceable>Raise IM windows on events</replaceable>: If enabled, IM

Conversation windows will be brought to the top when new messages are received.

</para>

<para>

<replaceable>Raise Chat windows on events</replaceable>: If enabled, chat

Conversation windows will be brought to the top when new messages are

received.

</para>

<para>

<replaceable>Use multi-colored screen names in chats</replaceable>: Color code

the screen names of users in chat rooms.

</para>

<variablelist termlength="wholeline">

<varlistentry><term>Tab Options</term>

<listitem>

<para>

<replaceable>Show IMs and chat in tabbed windows</replaceable>: Tabbed

chatting allows one to have multiple conversations without multiple windows.

</para>

<para>

<replaceable>Show close buttons on tabs</replaceable>: Adds a close button

to each tab.</replaceable>

</para>

<para>

<replaceable>Tab Placement</replaceable>...: Specifies where tabs are shown

in the conversation window.

</para>

<para>

<replaceable>New conversation placement</replaceable>...: Determines where

new conversations will be placed (Last created window / New window / windows

grouped by group or account / separate windwos for IMs and Chats).

</para>

</listitem></varlistentry>

<varlistentry><term>Message Text</term>

<listitem>

<para>

<replaceable>Show timestamp on messages</replaceable>: Toggles the timestamp

behavior for conversations. Per-conversation behavior can be changed by

pressing <replaceable>F2</replaceable> in the Conversation window.

</para>

<para>

<replaceable>Highlight misspelled words</replaceable>: Toggles highlighting of

misspelled words as you type.

</para>

<para>

<replaceable>Ignore colors/font faces/font sizes</replaceable>: Tells &cmd;

to disregard buddies' color/font/isze information in displaying IMs or Chats.

</para>

<para>

<replaceable>Default Formatting</replaceable>: Allows specifying the default

formatting to apply to all outgoing messages (only applicable to protocols

that support formatting in messages).

</para>

</listitem></varlistentry>

<varlistentry><term>Shortcuts</term>

<listitem>

<para>

Allows the user to determine which keyboard shortcuts are available.

</para>

</listitem></varlistentry>

<varlistentry><term>Smiley Themes</term>

<para>

Allows the user to choose between different smiley themes. The "none" theme

will disable graphical emoticons - they will be displayed as text instead.

</para>

</listitem></varlistentry>

</variablelist>

</listitem></varlistentry>

<varlistentry><term>Sounds</term>

<listitem>

<para>

<replaceable>Sounds while away</replaceable>: Determines whether sounds are

played when an away message is up.

</para>

<para><replaceable>Sound Method</replaceable>: lets the user choose between

different playback methods. The user can also manually enter a command to be

executed when a sound is to be played (<replaceable>%s</replaceable> expands to

the full path of the file name).

</para>

</listitem></varlistentry>

<varlistentry><term>Sound Events</term>

<listitem>

<para>

Lets the user choose when and what sounds are to be played.

</para>

</listitem></varlistentry>

<varlistentry><term>Network</term>

<listitem>

<variablelist termlength="wholeline">

<varlistentry><term>IP Address</term>

<listitem>

<replaceable>Autodetect IP Address</replaceable>: &cmd; will attempt to

automatically determine your IP address for use in file transfers and Direct

IMs.

</para>

<para>

<replaceable>Public IP</replaceable>: What IP address to use for file transfer

and Direct IMs. This is mainly useful for users with multiple network

interfaces or behind NAT.

</para>

</listitem></varlistentry>

<varlistentry><term>Ports</term>

<listitem>

<replaceable>Manually specify range of ports to listen on</replaceable>:

Specify specific ports to listen on, overriding any defaults.

</para>

</listitem></varlistentry>

<varlistentry><term>Proxy Server</term>

<listitem>

The configuration section to enable &cmd; to operate through a proxy server.

&cmd; currently supports SOCKS 4/5 and HTTP proxies.

</para>

</listitem></varlistentry>

</variablelist>

</listitem></varlistentry>

<varlistentry><term>Browser</term>

<listitem>

<para>

Allows the user to select &cmd;'s default web browser. Firefox, Galeon,

Konqueror, Mozilla, Netscape and Opera are supported natively. The user can

also manually enter a command to be executed when a link is clicked

(<replaceable>%s</replaceable> expands to the URL). For example,

<replaceable>xterm -e lynx "%s"</replaceable> will open the link with lynx.

<replaceable>Open new window by default</replaceable> makes the browser use a

new window instead of using the current window (or spawning a new tab).

</para>

</listitem></varlistentry>

<varlistentry><term>Logging</term>

<listitem><para>

<replaceable>Message Logs</replaceable> lets the user choose whether

Conversations and/or Buddy Chats will be logged as well as whether logs will be

in HTML or plain text format. <replaceable>System Logs</replaceable> describes

the types of events to be logged.

</para>

</listitem></varlistentry>

<varlistentry><term>Away / Idle</term>

<listitem>

<para>

<replaceable>Queue new messages when away</replaceable>: Messages received

since going Away will not be shown until away status is removed.

</para>

<para>

<replaceable>Send auto-response</replaceable>: If someone messages you while

away, your auto-response will be sent.

<para>

<replaceable>Only send auto-response when idle</replaceable>: If someone

messages you while away, your auto-response will only be sent if &cmd; decides

that the connection is idle.

</para>

<para>

<replaceable>Idle time reporting</replaceable>: If

<replaceable>None</replaceable> is selected, account idle time will not be

reported. <replaceable>&cmd; usage</replaceable> infers your idle time from

your usage of &cmd;. <replaceable>X usage</replaceable> infers your idle time

from X (this option may not be universally available).

</para>

<para>

<replaceable>Auto-away</replaceable>: Determines if and under what conditions

&cmd; will automatically turn on the Away status.

</para>

<variablelist termlength="wholeline">

<varlistentry><term>Away Messages</term>

<para>

Lets the user add/edit/remove available Away Messages.

</para>

</listitem></varlistentry>

</variablelist>

</listitem></varlistentry>

<varlistentry><term>Plugins</term>

<listitem>

<para>

Allows the user to enable add-on plugins for &cmd;. Several of these come

with &cmd;, while others must be downloaded separately. The

<replaceable>Description</replaceable> field gives the plugin author's

description of the plugin, while the <replaceable>Details</replaceable> field

gives the plugin's authorship, URL, and file name/location information.

</para>

<para>

Some plugins can be configured. If you load such a plugin, its configuration

preferences will appear as a submenu to Plugins, with the submenu title

determined by the plugin's name.

</para>

<listitem></varlistentry>

<varlistentry><term>Protocols</term>

<listitem>

<para>

Protocols provide protocol specific preferences here.

</para>

</listitem></varlistentry>

</variablelist>

</refsect2>

<refsect2 id="pidgin-1-exde-conversations">

<title>CONVERSATIONS</title>

<para>

When starting a new conversation, the user is presented with the Conversation

window. The conversation appears in the upper text box and the user types

his/her message in the lower text box. Between the two is a row of settings,

represented by icons. Some or all buttons may not be active if the protocol

does not support the specific formatting.

</para>

<para>

From left to right:

</para>

<variablelist termlength="wide">

<varlistentry><term>Bold</term>

<listitem><para>

Turns on/off bold.

</para></listitem></varlistentry>

<varlistentry><term>Italics</term>

<listitem><para>

Turns on/off italics.

</para></listitem></varlistentry>

<varlistentry><term>Underline</term>

<listitem><para>

Turns on/off underline.

</para></listitem></varlistentry>

<varlistentry><term>Decrease font size</term>

<listitem><para>

Decreases the size of the message text.

</para></listitem></varlistentry>

<varlistentry><term>Increase font size</term>

<listitem><para>

Increases the size of the message text.

</para></listitem></varlistentry>

<varlistentry><term>Select a foreground color</term>

<listitem><para>

Changes the foreground color of the message text.

</para></listitem></varlistentry>

<varlistentry><term>Select a background color</term>

<listitem><para>

Changes the background color of the message text.

</para></listitem></varlistentry>

<varlistentry><term>Add image</term>

<listitem><para>

Inserts an in-line image in the message.

</para></listitem></varlistentry>

<varlistentry><term>Add hyperlink</term>

<listitem><para>

Adds a clickable link to the message.

</para></listitem></varlistentry>

<varlistentry><term>Add smiley</term>

<listitem><para>

Adds an emoticon (smiley) to your message.

</para>

<para>

Beneath the lower text box is a row of buttons that execute commands:

</para>

</para></listitem></varlistentry>

<varlistentry><term>Warn</term>

<listitem><para>

This issues a warning to the other person in the conversation (not available in

all protocols).

</para></listitem></varlistentry>

<varlistentry><term>Block</term>

<listitem><para>

This adds the other person to your deny list (not available in all protocols).

</para></listitem></varlistentry>

<varlistentry><term>Send File</term>

<listitem><para>

Send a file to this user. This option is only available on protocols where

&cmd; supports file transfer.

</para></listitem></varlistentry>

<varlistentry><term>Add</term>

<listitem><para>

This adds this user to your buddy list. This option is not available if the

user is already on your list.

</para></listitem></varlistentry>

<varlistentry><term>Remove</term>

<listitem><para>

This removes this user from your buddy list. This option is not available if

the user is not on your list.

</para></listitem></varlistentry>

<varlistentry><term>Info</term>

<listitem><para>

This gets information (a profile) about the other person in the conversation

(not available in all protocols).

</para></listitem></varlistentry>

<varlistentry><term>Send</term>

<listitem><para>

This sends what is currently in the lower text box

</para></listitem></varlistentry>

</variablelist>

</refsect2>

<refsect2 id="pidgin-1-exde-buddy-chats">

<title>BUDDY CHATS</title>

<para>

For protocols that allow it, Buddy Chats can be entered through the

<replaceable>File</replaceable> menu or the <replaceable>Chat</replaceable>

button at the bottom of the Buddy List's Online tab.

</para>

<para>

Additional commands available in chat, depending on the protocol are:

</para>

<variablelist>

<varlistentry>

<term>Whisper</term>

<listitem><para>

The text will appear in the chat conversation, but it will only be visible to

the sender and the receiver.

</para></listitem></varlistentry>

<varlistentry>

<term>Invite</term>

<listitem><para>

Invite other people to join the chat room.

</para></listitem></varlistentry>

<varlistentry>

<term>Ignore</term>

<listitem><para>

Ignore anything said by the chosen person.

</para></listitem></varlistentry>

<varlistentry>

<term>Set Topic</term>

<listitem><para>

Set the topic of the chat room. This is usually a brief sentence describing

the nature of the chat; an explanation of the chat room's name.

</para></listitem></varlistentry>

</variablelist>

</refsect2>

<refsect2 id="pidgin-1-exde-away-msgs">

<title>AWAY MESSAGES </title>

<para>

Most protocols allow for away messages. When a user is

<replaceable>Away</replaceable>, he can leave an informative message for others

to see. The Away submenu of the Tools menu is used to add and remove away

messages.

</para>

<para>

<replaceable>New Away Message</replaceable> provides space for one to enter an

away message and a title for that message. If <replaceable>Save</replaceable>

or <replaceable>Save & Use</replaceable> are chosen, this message will be

saved. It can later be referred to by the title given to it.

</para>

<para>

<replaceable>Remove Away Message</replaceable> is a submenu containing the

titles of saved away messages. Clicking on one of these titles will remove the

away message associated with it.

</para>

<para>

The rest of the <replaceable>away</replaceable> menu provides the user with a

way to assign different away messages to different connections. Choosing

<replaceable>Set All Away</replaceable> will set away all the connections

capable of the away state.

</para>

</refsect2>

<refsect2 id="pidgin-1-exde-buddy-pounce">

<title>BUDDY POUNCE</title>

<para>

A Buddy Pounce is an automated trigger that occurs when a buddy returns to a

normal state from an away state. The New Buddy Pounce dialog box can be

activated by selecting the <replaceable>Buddy Pounce</replaceable> submenu from

the Tools menu. A pounce can be set to occur on any combination of the events

listed, and any combination of actions can result. If <replaceable>Save this

pounce after activation</replaceable> is checked, the trigger will remain until

it is removed from the Remove <replaceable>Buddy Pounce</replaceable> menu.

</para>

</refsect2>

<refsect2 id="pidgin-1-exde-plugins">

<title>PLUGINS</title>

<para>

&cmd; allows for dynamic loading of plugins to add extra functionality to

&cmd;. Plugins can be enabled and configured from the Preferences window.

See <replaceable>plugins/HOWTO</replaceable> for more information on writing

plugins.

</para>

</refsect2>

<refsect2 id="pidgin-1-exde-perl">

<title>PERL</title>

<para>

&cmd; allows for perl scripting. See <replaceable>Perl Scripting

HOWTO</replaceable> in the &cmd; documentation for more information about

perl scripting.

</para>

</refsect2>

<refsect2 id="pidgin-1-exde-tcl">

<title>TCL</title>

<para>

&cmd; allows for Tcl scripting. See

<replaceable>plugins/tcl/TCL-HOWTO</replaceable>

for more information about Tcl scripting.

</para>

</refsect2>

</refsect1>

<refsect1 id="pidgin-1-exam"><title>&exam-tt;</title>

<example role="example">

<title>Launching &cmd;</title>

<para><screen>example% <userinput>&cmd;</userinput></screen></para>

</example>

</refsect1>

<refsect1 id="pidgin-1-exit"><title>&exit-tt;</title>

<para>The following exit values are returned:</para>

<variablelist termlength="xtranarrow">

<varlistentry><term><returnvalue>0</returnvalue></term><listitem><para>Application

exited successfully</para>

</listitem></varlistentry>

<varlistentry><term><returnvalue>>0</returnvalue></term><listitem><para>Application

exited with failure</para>

</listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="pidgin-1-file"><title>&file-tt;</title>

<para>The following files are used by this application: </para>

<variablelist termlength="wide">

<varlistentry><term><filename>/usr/bin/&cmd;

</filename></term><listitem><para>

Executable for &cmd;.

</para></listitem></varlistentry>

<varlistentry><term><filename>/usr/lib/&cmd;

</filename></term><listitem><para>

Location of &cmd; plugins.

</para></listitem></varlistentry>

<varlistentry><term><filename>~/.purple/prefs.xml

</filename></term><listitem><para>

&cmd; configuration file.

</para></listitem></varlistentry>

<varlistentry><term><filename>~/.purple/accounts.xml

</filename></term><listitem><para>

Information about your accounts.

</para></listitem></varlistentry>

<varlistentry><term><filename>~/.purple/status.xml

</filename></term><listitem><para>

Stores your away messages.

</para></listitem></varlistentry>

<varlistentry><term><filename>~/.purple/pounces.xml

</filename></term><listitem><para>

Stores your buddy pounces.

</para></listitem></varlistentry>

<varlistentry><term><filename>~/.purple/logs/PROTOCOL/ACCOUNT/SCREENNAME/DATE.{html,txt}:

</filename></term><listitem><para></para><para>

Conversation logs

</para></listitem></varlistentry>

<varlistentry><term><filename>~/.purple/blist.xml

</filename></term><listitem><para>

The buddy list.

</para></listitem></varlistentry>

<varlistentry><term><filename>~/.purple/plugins/

</filename></term><listitem><para>

User's local plugins.

</para></listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="pidgin-1-attr"><title>&attr-tt;</title>

<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>

<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>

for descriptions of the following attributes:</para>

<informaltable frame="all">

<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">

<colspec colname="COLSPEC1" colwidth="1*">

<thead>

<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"

valign="middle">ATTRIBUTE VALUE</entry></row>

</thead>

<tbody>

<row><entry><para>Availability</para></entry>

<entry><para>SUNWgnome-im-client</para></entry>

</row>

<row><entry colname="COLSPEC0"><para>Interface stability</para></entry>

<entry colname="COLSPEC1"><para>Volatile</para></entry></row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 id="pidgin-1-also"><title>&also-tt;</title>

<para>

<citerefentry><refentrytitle>otr_parse</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>,

<citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry>

</para>

<para>

<citetitle>&cmd; Manual</citetitle>,

<literal>http://pidgin.im/</literal>

</para>

</refsect1>

<refsect1 id="pidgin-1-note"><title>&note-tt;</title>

<para>

This man page was originally written by Dennis Ristuccia (dennis@dennisr.net).

Updated and largely rewritten by Sean Egan (bj91704@binghamton.edu) and Ben

Tegarden (tegarden@uclink.berkeley.edu). Updated by Stephen Browne, Rick Ju,

and Brian Cameron, Sun Microsystems Inc, 2003, 2006, 2007.

</para>

</refsect1>

</refentry>