pidgin.1 revision 11965
11925N/A<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
11925N/A<!--ArborText, Inc., 1988-1999, v.4002-->
11925N/A<!ENTITY cmd "pidgin">
11925N/A<!ENTITY % commonents SYSTEM "smancommon.ent">
11925N/A%commonents;
11925N/A<!ENTITY % booktitles SYSTEM "booktitles.ent">
11925N/A%booktitles;
11925N/A<!ENTITY suncopy "Copyright (c) 2003,2006,2007 Sun Microsystems, Inc. All Rights Reserved.">
11925N/A]>
11925N/A<?Pub UDT _bookmark _target>
11925N/A<?Pub Inc>
11925N/A<refentry id="pidgin-1">
11925N/A<!-- %Z%%M% %I% %E% SMI; -->
11925N/A<refmeta><refentrytitle>pidgin</refentrytitle><manvolnum>1</manvolnum>
11925N/A<refmiscinfo class="date">12 Nov 2007</refmiscinfo>
11925N/A<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
11925N/A<refmiscinfo class="software">&release;</refmiscinfo>
11925N/A<refmiscinfo class="arch">generic</refmiscinfo>
11925N/A<refmiscinfo class="copyright">&suncopy;</refmiscinfo>
11925N/A</refmeta>
11925N/A<indexterm><primary>pidgin</primary></indexterm><indexterm><primary>Instant
11925N/AMessaging client</primary></indexterm>
11925N/A<refnamediv id="pidgin-1-name"><refname>pidgin</refname><refpurpose>Instant Messaging
11925N/Aclient</refpurpose></refnamediv>
11925N/A<refsynopsisdiv id="pidgin-1-synp"><title>&synp-tt;</title>
11925N/A<cmdsynopsis><command>&cmd;</command>
11925N/A<arg><option>-config</option>=<replaceable>directory</replaceable></arg>
11925N/A<arg><option>-debug</option></arg>
11925N/A<arg><option>-login</option>=<replaceable>name</replaceable></arg>
11925N/A<arg><option>-nologin</option></arg>
11925N/A<arg choice="opt"><option><replaceable>gnome-std-options</replaceable></option></arg>
11925N/A</cmdsynopsis></refsynopsisdiv>
11925N/A<refsect1 id="pidgin-1-desc"><title>&desc-tt;</title>
11925N/A<para>&cmd; is a graphical modular messaging client based on libpurple. It
11947N/Asupports multiple protocols including AIM, MSN, Yahoo!, XMPP, ICQ, IRC,
11947N/A GroupWise and GTalk all at once. It has many common features found in other clients,
11947N/A as well as many unique features.
11925N/A</para>
11925N/A</refsect1>
11925N/A<refsect1 id="pidgin-1-opts"><title>&opts-tt;</title>
11925N/A<para>The following options are supported:</para>
11925N/A<variablelist termlength="wide">
11925N/A<varlistentry>
11925N/A<term><option>c</option>, <option>-config=<replaceable>directory</replaceable></option></term>
11925N/A<listitem><para>
11925N/AUse <replaceable>directory</replaceable> as the directory for config files
11925N/Ainstead of <filename>~/.purple</filename>.
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A<varlistentry>
11925N/A<term><option>d</option>, <option>-debug</option></term>
11925N/A<listitem><para>
11925N/APrint debug messages to <literal>stdout</literal>. These are the same debug
11925N/Amessages that are displayed in the Debug window.
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A<varlistentry>
11925N/A<term><option>l</option>, <option>-login[=<replaceable>name</replaceable>,<replaceable>name</replaceable>,...]</option></term>
11925N/A<listitem><para>
11925N/ALog in with the comma-separated list of accounts provided, in addition to any
11925N/Aaccounts that are configured to be logged in automatically. If no argument
11925N/Ais provided, your first account will be signed in.
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A<varlistentry>
11925N/A<term><option>n</option>, <option>-nologin</option></term>
11925N/A<listitem><para>
11925N/ADo not automatically login when &cmd; starts. Sets the global status
11925N/Ato Offline.
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A<varlistentry>
11925N/A<term><option role="nodash"><replaceable>gnome-std-options</replaceable></option></term>
11925N/A<listitem><para>
11925N/AStandard options available for use with most GNOME applications. See
11925N/A<citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A</variablelist></refsect1>
11925N/A<refsect1 id="pidgin-1-exde"><title>&exde-tt;</title>
11925N/A<refsect2 id="pidgin-1-exde-buddylist">
11925N/A
11925N/A<title>Buddy List</title>
11925N/A<para>
11925N/AThe Buddy List window is &cmd;'s main interface window. Using this window you
11925N/Acan see which of your buddies is online, away, idle, etc. You can also add and
11925N/Aremove buddies from your buddy list.
11925N/A</para>
11925N/A<para>
11925N/AThe Buddy List window contains a list of your buddies who are online and have
11925N/Aallowed you to be notified of their presence. The icon to the left of each
11925N/Abuddy indicates the buddy's current state and the protocol they are using.
11925N/ADouble clicking a buddy will open a new Conversation window. Right clicking
11925N/Awill pop up a menu:
11925N/A</para>
11925N/A
11925N/A<variablelist termlength="wholeline">
11925N/A<varlistentry>
11925N/A<term>Get Info</term>
11925N/A<listitem><para>
11925N/ARetrieves and displays information about the buddy. This information is also
11925N/Aknown as a Profile.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>IM</term>
11925N/A<listitem><para>
11925N/AOpens a new Conversation window to the selected buddy.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Send File</term>
11925N/A<listitem><para>
11925N/ASends a file to the selected buddy (only available on protocols that support
11925N/Afile transfer).
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Add Buddy Pounce</term>
11925N/A<listitem><para>
11925N/AA Buddy Pounce is a configurable automated action to be performed when the
11925N/Abuddy's state changes. This will open the Buddy Pounce dialog to be discussed
11925N/Alater.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>View Log</term>
11925N/A<listitem><para>
11925N/A&cmd; is capable of automatically log its activities. These logs are either
11925N/Aplain text files (with a .txt extension) or html files (with a .html extension)
11925N/Alocated under the <filename>~/.purple/logs</filename> directory. This menu
11925N/Acommand will display &cmd;'s log viewer with logs loaded for that buddy or
11925N/Achat.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Alias</term>
11925N/A<listitem><para>
11925N/ACreate an alias for this buddy. This will open up a new dialog in which one
11925N/Acan give this buddy an alternate name to appear on the buddy list and in
11925N/Aconversations.
11925N/A</para>
11925N/A<para>
11925N/AFor example, if a buddy's name screen name was jsmith1281xx and his real name
11925N/Awas 'John Q. Smith,' one could create an alias as to identify the buddy by his
11925N/Acommon name.
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A</variablelist>
11925N/A
11925N/A<para>
11925N/AThe remainder of the menu will consist of protocol specific commands. These
11925N/Acommands vary depending on the protocol.
11925N/A</para>
11925N/A<para>
11925N/AAt the bottom of the Buddy List are several buttons (if enabled in
11925N/APreferences):
11925N/A</para>
11925N/A
11925N/A<variablelist termlength="xtranarrow">
11925N/A<varlistentry><term>IM</term>
11925N/A<listitem><para>
11925N/AOpens a new Conversation window to to the selected buddy, or brings up the New
11925N/AMessage dialog box if no buddy is selected.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Info</term>
11925N/A<listitem><para>
11925N/ARetrieves and displays information about the selected buddy, or brings up the
11925N/AGet User Info dialog box if no buddy is selected.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Chat</term>
11925N/A<listitem><para>
11925N/ABrings up the Join Chat dialog box, prompting the user to select which
11925N/Ausername to use and what chat group to join.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Away</term>
11925N/A<listitem><para>
11925N/ABrings up a menu of all available Away Messages. If an item is selected, all
11925N/Aonline accounts will use this item as their away message.
11925N/A</para></listitem></varlistentry>
11925N/A</variablelist>
11925N/A</refsect2>
11925N/A
11925N/A<refsect2 id="pidgin-1-exde-acct-editor">
11925N/A<title>ACCOUNT EDITOR </title>
11925N/A<para>
11925N/AThe account editor consists of a list of accounts and information about them.
11925N/AClicking <replaceable>Delete</replaceable> will delete the currently selected
11925N/Aaccount. Clicking <replaceable>Add</replaceable> or
11925N/A<replaceable>Modify</replaceable> will invoke a Modify Account window. Here,
11925N/Ayou can add or alter account information. When creating a new account, you
11925N/Awill submit your screen name and password. You will also choose your protocol.
11925N/A</para>
11925N/A<para>
11925N/AIf <replaceable>Remember Password</replaceable> is chosen, the password will be
11925N/Asaved in &cmd;'s configuration file.
11925N/A</para>
11925N/A<para>
11925N/AIf <replaceable>Auto-Login</replaceable> is chosen, this account will
11925N/Aautomatically login upon starting &cmd;.
11925N/A</para>
11925N/A<para>
11925N/AEach protocol has it's own specific options that can be found in the modify
11925N/Ascreen.
11925N/A</para>
11925N/A</refsect2>
11925N/A
11925N/A<refsect2 id="pidgin-1-exde-prefs">
11925N/A<title>PREFERENCES</title>
11925N/A<para>All options take effect immediately.</para>
11925N/A<variablelist termlength="wholescreen">
11925N/A<varlistentry><term>Interface</term>
11925N/A<listitem><para>
11925N/A<replaceable>Display remote nicknames if no alias is set</replaceable>:
11925N/AToggles whether server nickname data should be used if no local alias exists.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Buddy List</term>
11925N/A<listitem>
11925N/A<para>
11925N/A<replaceable>Sorting</replaceable>: Toggles the order in which buddies are
11925N/Ashown in your Buddy List between none, alphabetical, by status and by log size. </para>
11925N/A<para>
11925N/A<replaceable>Show buttons as</replaceable>: Toggles between picture-only,
11925N/Atext-only, picture and text or no buttons view of the buttons on the Buddy
11925N/AList.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Raise window on events</replaceable>: Tells &cmd; to bring the
11925N/ABuddy List window to the top when buddies sign in or out.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Show numbers in groups</replaceable>: The number of buddies from
11925N/Aeach group currently logged in will be shown along with the total number of
11925N/Abuddies in the group.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Show buddy icons</replaceable>: Toggles the display of buddies'
11925N/Acustom icons.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Show warning levels</replaceable>: Each buddy's warning level
11925N/Awill be displayed next to the screen name. As a buddy's warning level
11925N/Aincreases, outgoing messages are more and more severely rate-limited.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Show idle times</replaceable>: The amount of time each buddy has
11925N/Abeen idle will be displayed next to the screen name (if the buddy has opted to
11925N/Ahave their client report this information).
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Dim idle buddies</replaceable>: If enabled, idle buddies will be
11925N/Adisplayed in grey text instead of black text.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Automatically expand contacts</replaceable>: If enabled, contacts
11925N/Awill automatically expand to show the associated buddies when the mouse is held over the contact for a short period.
11925N/A</para>
11925N/A</listitem>
11925N/A
11925N/A<varlistentry><term>Conversations</term>
11925N/A<listitem>
11925N/A<para>
11925N/A<replaceable>Show buttons as</replaceable>...: The selected item will
11925N/Adetermine whether picture-only, text-only, combined picture/text, or no buttons
11925N/Awill be used for Conversation windows.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Show formatting toolbar</replaceable>: Display the formatting
11925N/Atoolbar between the upper and lower text boxes in conversations.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Show aliases in tabs/titles</replaceable>: Displays buddy alias
11925N/Ainstead of screen name in window tabs and titles.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Show buddy icons</replaceable>: For protocols that support it,
11925N/Abuddy icons allow buddies to send small pictures to be displayed during the
11925N/Acourse of a conversation. Turning this option off hides those pictures.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Enable buddy icon animation</replaceable>: If these pictures
11925N/Ahappen to be animated, this option will enable the animation, otherwise only
11925N/Athe first frame will be displayed.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Notify buddies that you are typing to them</replaceable>: Some
11925N/Aprotocols allow clients to tell their buddies when they are typing. This option
11925N/Aenables this feature for protocols that supports it.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Raise IM windows on events</replaceable>: If enabled, IM
11925N/AConversation windows will be brought to the top when new messages are received.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Raise Chat windows on events</replaceable>: If enabled, chat
11925N/A Conversation windows will be brought to the top when new messages are
11925N/Areceived.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Use multi-colored screen names in chats</replaceable>: Color code
11925N/Athe screen names of users in chat rooms.
11925N/A</para>
11925N/A<variablelist termlength="wholeline">
11925N/A<varlistentry><term>Tab Options</term>
11925N/A<listitem>
11925N/A<para>
11925N/A<replaceable>Show IMs and chat in tabbed windows</replaceable>: Tabbed
11925N/Achatting allows one to have multiple conversations without multiple windows.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Show close buttons on tabs</replaceable>: Adds a close button
11925N/Ato each tab.</replaceable>
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Tab Placement</replaceable>...: Specifies where tabs are shown
11925N/Ain the conversation window.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>New conversation placement</replaceable>...: Determines where
11925N/Anew conversations will be placed (Last created window / New window / windows
11925N/Agrouped by group or account / separate windwos for IMs and Chats).
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A<varlistentry><term>Message Text</term>
11925N/A<listitem>
11925N/A<para>
11925N/A<replaceable>Show timestamp on messages</replaceable>: Toggles the timestamp
11925N/Abehavior for conversations. Per-conversation behavior can be changed by
11925N/Apressing <replaceable>F2</replaceable> in the Conversation window.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Highlight misspelled words</replaceable>: Toggles highlighting of
11925N/Amisspelled words as you type.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Ignore colors/font faces/font sizes</replaceable>: Tells &cmd;
11925N/Ato disregard buddies' color/font/isze information in displaying IMs or Chats.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Default Formatting</replaceable>: Allows specifying the default
11925N/Aformatting to apply to all outgoing messages (only applicable to protocols
11925N/Athat support formatting in messages).
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A<varlistentry><term>Shortcuts</term>
11925N/A<listitem>
11925N/A<para>
11925N/AAllows the user to determine which keyboard shortcuts are available.
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A<varlistentry><term>Smiley Themes</term>
11925N/A<para>
11925N/AAllows the user to choose between different smiley themes. The "none" theme
11925N/Awill disable graphical emoticons - they will be displayed as text instead.
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A</variablelist>
11925N/A</listitem></varlistentry>
11925N/A<varlistentry><term>Sounds</term>
11925N/A<listitem>
11925N/A<para>
11925N/A<replaceable>Sounds while away</replaceable>: Determines whether sounds are
11925N/Aplayed when an away message is up.
11925N/A</para>
11925N/A<para><replaceable>Sound Method</replaceable>: lets the user choose between
11925N/Adifferent playback methods. The user can also manually enter a command to be
11925N/Aexecuted when a sound is to be played (<replaceable>%s</replaceable> expands to
11925N/Athe full path of the file name).
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A<varlistentry><term>Sound Events</term>
11925N/A<listitem>
11925N/A<para>
11925N/ALets the user choose when and what sounds are to be played.
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A<varlistentry><term>Network</term>
11925N/A<listitem>
11925N/A<variablelist termlength="wholeline">
11925N/A<varlistentry><term>IP Address</term>
11925N/A<listitem>
11925N/A<replaceable>Autodetect IP Address</replaceable>: &cmd; will attempt to
11925N/Aautomatically determine your IP address for use in file transfers and Direct
11925N/AIMs.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Public IP</replaceable>: What IP address to use for file transfer
11925N/Aand Direct IMs. This is mainly useful for users with multiple network
11925N/Ainterfaces or behind NAT.
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A<varlistentry><term>Ports</term>
11925N/A<listitem>
11925N/A<replaceable>Manually specify range of ports to listen on</replaceable>:
11925N/ASpecify specific ports to listen on, overriding any defaults.
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A<varlistentry><term>Proxy Server</term>
11925N/A<listitem>
11925N/AThe configuration section to enable &cmd; to operate through a proxy server.
11925N/A&cmd; currently supports SOCKS 4/5 and HTTP proxies.
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A</variablelist>
11925N/A</listitem></varlistentry>
11925N/A<varlistentry><term>Browser</term>
11925N/A<listitem>
11925N/A<para>
11925N/AAllows the user to select &cmd;'s default web browser. Firefox, Galeon,
11925N/AKonqueror, Mozilla, Netscape and Opera are supported natively. The user can
11925N/Aalso manually enter a command to be executed when a link is clicked
11925N/A(<replaceable>%s</replaceable> expands to the URL). For example,
11925N/A<replaceable>xterm -e lynx "%s"</replaceable> will open the link with lynx.
11925N/A<replaceable>Open new window by default</replaceable> makes the browser use a
11925N/Anew window instead of using the current window (or spawning a new tab).
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A<varlistentry><term>Logging</term>
11925N/A<listitem><para>
11925N/A<replaceable>Message Logs</replaceable> lets the user choose whether
11925N/AConversations and/or Buddy Chats will be logged as well as whether logs will be
11925N/Ain HTML or plain text format. <replaceable>System Logs</replaceable> describes
11925N/Athe types of events to be logged.
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A<varlistentry><term>Away / Idle</term>
11925N/A<listitem>
11925N/A<para>
11925N/A<replaceable>Queue new messages when away</replaceable>: Messages received
11925N/Asince going Away will not be shown until away status is removed.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Send auto-response</replaceable>: If someone messages you while
11925N/Aaway, your auto-response will be sent.
11925N/A<para>
11925N/A<replaceable>Only send auto-response when idle</replaceable>: If someone
11925N/Amessages you while away, your auto-response will only be sent if &cmd; decides
11925N/Athat the connection is idle.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Idle time reporting</replaceable>: If
11925N/A<replaceable>None</replaceable> is selected, account idle time will not be
11925N/Areported. <replaceable>&cmd; usage</replaceable> infers your idle time from
11925N/Ayour usage of &cmd;. <replaceable>X usage</replaceable> infers your idle time
11925N/Afrom X (this option may not be universally available).
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Auto-away</replaceable>: Determines if and under what conditions
11925N/A&cmd; will automatically turn on the Away status.
11925N/A</para>
11925N/A<variablelist termlength="wholeline">
11925N/A<varlistentry><term>Away Messages</term>
11925N/A<para>
11925N/ALets the user add/edit/remove available Away Messages.
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A</variablelist>
11925N/A</listitem></varlistentry>
11925N/A<varlistentry><term>Plugins</term>
11925N/A<listitem>
11925N/A<para>
11925N/AAllows the user to enable add-on plugins for &cmd;. Several of these come
11925N/Awith &cmd;, while others must be downloaded separately. The
11925N/A<replaceable>Description</replaceable> field gives the plugin author's
11925N/Adescription of the plugin, while the <replaceable>Details</replaceable> field
11925N/Agives the plugin's authorship, URL, and file name/location information.
11925N/A</para>
11925N/A<para>
11925N/ASome plugins can be configured. If you load such a plugin, its configuration
11925N/Apreferences will appear as a submenu to Plugins, with the submenu title
11925N/Adetermined by the plugin's name.
11925N/A</para>
11925N/A<listitem></varlistentry>
11925N/A<varlistentry><term>Protocols</term>
11925N/A<listitem>
11925N/A<para>
11925N/AProtocols provide protocol specific preferences here.
11925N/A</para>
11925N/A</listitem></varlistentry>
11925N/A</variablelist>
11925N/A</refsect2>
11925N/A
11925N/A<refsect2 id="pidgin-1-exde-conversations">
11925N/A<title>CONVERSATIONS</title>
11925N/A<para>
11925N/AWhen starting a new conversation, the user is presented with the Conversation
11925N/Awindow. The conversation appears in the upper text box and the user types
11925N/Ahis/her message in the lower text box. Between the two is a row of settings,
11925N/Arepresented by icons. Some or all buttons may not be active if the protocol
11925N/Adoes not support the specific formatting.
11925N/A</para>
11925N/A<para>
11925N/AFrom left to right:
11925N/A</para>
11925N/A
11925N/A<variablelist termlength="wide">
11925N/A<varlistentry><term>Bold</term>
11925N/A<listitem><para>
11925N/ATurns on/off bold.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Italics</term>
11925N/A<listitem><para>
11925N/ATurns on/off italics.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Underline</term>
11925N/A<listitem><para>
11925N/ATurns on/off underline.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Decrease font size</term>
11925N/A<listitem><para>
11925N/ADecreases the size of the message text.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Increase font size</term>
11925N/A<listitem><para>
11925N/AIncreases the size of the message text.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Select a foreground color</term>
11925N/A<listitem><para>
11925N/AChanges the foreground color of the message text.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Select a background color</term>
11925N/A<listitem><para>
11925N/AChanges the background color of the message text.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Add image</term>
11925N/A<listitem><para>
11925N/AInserts an in-line image in the message.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Add hyperlink</term>
11925N/A<listitem><para>
11925N/AAdds a clickable link to the message.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Add smiley</term>
11925N/A<listitem><para>
11925N/AAdds an emoticon (smiley) to your message.
11925N/A</para>
11925N/A<para>
11925N/ABeneath the lower text box is a row of buttons that execute commands:
11925N/A</para>
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Warn</term>
11925N/A<listitem><para>
11925N/AThis issues a warning to the other person in the conversation (not available in
11925N/Aall protocols).
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Block</term>
11925N/A<listitem><para>
11925N/AThis adds the other person to your deny list (not available in all protocols).
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Send File</term>
11925N/A<listitem><para>
11925N/ASend a file to this user. This option is only available on protocols where
11925N/A&cmd; supports file transfer.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Add</term>
11925N/A<listitem><para>
11925N/AThis adds this user to your buddy list. This option is not available if the
11925N/Auser is already on your list.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Remove</term>
11925N/A<listitem><para>
11925N/AThis removes this user from your buddy list. This option is not available if
11925N/Athe user is not on your list.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Info</term>
11925N/A<listitem><para>
11925N/AThis gets information (a profile) about the other person in the conversation
11925N/A(not available in all protocols).
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term>Send</term>
11925N/A<listitem><para>
11925N/AThis sends what is currently in the lower text box
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A</variablelist>
11925N/A</refsect2>
11925N/A
11925N/A<refsect2 id="pidgin-1-exde-buddy-chats">
11925N/A<title>BUDDY CHATS</title>
11925N/A<para>
11925N/AFor protocols that allow it, Buddy Chats can be entered through the
11925N/A<replaceable>File</replaceable> menu or the <replaceable>Chat</replaceable>
11925N/Abutton at the bottom of the Buddy List's Online tab.
11925N/A</para>
11925N/A<para>
11925N/AAdditional commands available in chat, depending on the protocol are:
11925N/A</para>
11925N/A
11925N/A<variablelist>
11925N/A<varlistentry>
11925N/A<term>Whisper</term>
11925N/A<listitem><para>
11925N/AThe text will appear in the chat conversation, but it will only be visible to
11925N/Athe sender and the receiver.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry>
11925N/A<term>Invite</term>
11925N/A<listitem><para>
11925N/AInvite other people to join the chat room.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry>
11925N/A<term>Ignore</term>
11925N/A<listitem><para>
11925N/AIgnore anything said by the chosen person.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry>
11925N/A<term>Set Topic</term>
11925N/A<listitem><para>
11925N/ASet the topic of the chat room. This is usually a brief sentence describing
11925N/Athe nature of the chat; an explanation of the chat room's name.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A</variablelist>
11925N/A</refsect2>
11925N/A
11925N/A<refsect2 id="pidgin-1-exde-away-msgs">
11925N/A<title>AWAY MESSAGES </title>
11925N/A
11925N/A<para>
11925N/AMost protocols allow for away messages. When a user is
11925N/A<replaceable>Away</replaceable>, he can leave an informative message for others
11925N/Ato see. The Away submenu of the Tools menu is used to add and remove away
11925N/Amessages.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>New Away Message</replaceable> provides space for one to enter an
11925N/Aaway message and a title for that message. If <replaceable>Save</replaceable>
11925N/Aor <replaceable>Save & Use</replaceable> are chosen, this message will be
11925N/Asaved. It can later be referred to by the title given to it.
11925N/A</para>
11925N/A<para>
11925N/A<replaceable>Remove Away Message</replaceable> is a submenu containing the
11925N/Atitles of saved away messages. Clicking on one of these titles will remove the
11925N/Aaway message associated with it.
11925N/A</para>
11925N/A<para>
11925N/AThe rest of the <replaceable>away</replaceable> menu provides the user with a
11925N/Away to assign different away messages to different connections. Choosing
11925N/A<replaceable>Set All Away</replaceable> will set away all the connections
11925N/Acapable of the away state.
11925N/A</para>
11925N/A</refsect2>
11925N/A
11925N/A<refsect2 id="pidgin-1-exde-buddy-pounce">
11925N/A<title>BUDDY POUNCE</title>
11925N/A<para>
11925N/AA Buddy Pounce is an automated trigger that occurs when a buddy returns to a
11925N/Anormal state from an away state. The New Buddy Pounce dialog box can be
11925N/Aactivated by selecting the <replaceable>Buddy Pounce</replaceable> submenu from
11925N/Athe Tools menu. A pounce can be set to occur on any combination of the events
11925N/Alisted, and any combination of actions can result. If <replaceable>Save this
11925N/Apounce after activation</replaceable> is checked, the trigger will remain until
11925N/Ait is removed from the Remove <replaceable>Buddy Pounce</replaceable> menu.
11925N/A</para>
11925N/A</refsect2>
11925N/A
11925N/A<refsect2 id="pidgin-1-exde-plugins">
11925N/A<title>PLUGINS</title>
11925N/A<para>
11925N/A&cmd; allows for dynamic loading of plugins to add extra functionality to
11925N/A&cmd;. Plugins can be enabled and configured from the Preferences window.
11925N/ASee <replaceable>plugins/HOWTO</replaceable> for more information on writing
11925N/Aplugins.
11925N/A</para>
11925N/A</refsect2>
11925N/A
11925N/A<refsect2 id="pidgin-1-exde-perl">
11925N/A<title>PERL</title>
11925N/A<para>
11925N/A&cmd; allows for perl scripting. See <replaceable>Perl Scripting
11925N/AHOWTO</replaceable> in the &cmd; documentation for more information about
11925N/Aperl scripting.
11925N/A</para>
11925N/A</refsect2>
11925N/A
11925N/A<refsect2 id="pidgin-1-exde-tcl">
11925N/A<title>TCL</title>
11925N/A<para>
11925N/A&cmd; allows for Tcl scripting. See
11925N/A<replaceable>plugins/tcl/TCL-HOWTO</replaceable>
11925N/Afor more information about Tcl scripting.
11925N/A</para>
11925N/A</refsect2>
11925N/A</refsect1>
11925N/A
11925N/A<refsect1 id="pidgin-1-exam"><title>&exam-tt;</title>
11925N/A<example role="example">
11925N/A<title>Launching &cmd;</title>
11925N/A<para><screen>example% <userinput>&cmd;</userinput></screen></para>
11925N/A</example>
11925N/A</refsect1>
11925N/A
11925N/A<refsect1 id="pidgin-1-exit"><title>&exit-tt;</title>
11925N/A<para>The following exit values are returned:</para>
11925N/A<variablelist termlength="xtranarrow">
11925N/A<varlistentry><term><returnvalue>0</returnvalue></term><listitem><para>Application
11925N/Aexited successfully</para>
11925N/A</listitem></varlistentry>
11925N/A<varlistentry><term><returnvalue>>0</returnvalue></term><listitem><para>Application
11925N/Aexited with failure</para>
11925N/A</listitem></varlistentry>
11925N/A</variablelist></refsect1>
11925N/A
11925N/A<refsect1 id="pidgin-1-file"><title>&file-tt;</title>
11925N/A<para>The following files are used by this application: </para>
11925N/A<variablelist termlength="wide">
11925N/A
11925N/A<varlistentry><term><filename>/usr/bin/&cmd;
11925N/A</filename></term><listitem><para>
11965N/AExecutable for &cmd;
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term><filename>/usr/lib/&cmd;
11925N/A</filename></term><listitem><para>
11925N/ALocation of &cmd; plugins.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term><filename>~/.purple/prefs.xml
11925N/A</filename></term><listitem><para>
11925N/A&cmd; configuration file.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term><filename>~/.purple/accounts.xml
11925N/A</filename></term><listitem><para>
11925N/AInformation about your accounts.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term><filename>~/.purple/status.xml
11925N/A</filename></term><listitem><para>
11925N/AStores your away messages.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term><filename>~/.purple/pounces.xml
11925N/A</filename></term><listitem><para>
11925N/AStores your buddy pounces.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term><filename>~/.purple/logs/PROTOCOL/ACCOUNT/SCREENNAME/DATE.{html,txt}:
11925N/A</filename></term><listitem><para></para><para>
11925N/AConversation logs
11925N/A </para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term><filename>~/.purple/blist.xml
11925N/A</filename></term><listitem><para>
11925N/AThe buddy list.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A<varlistentry><term><filename>~/.purple/plugins/
11925N/A</filename></term><listitem><para>
11925N/AUser's local plugins.
11925N/A</para></listitem></varlistentry>
11925N/A
11925N/A</variablelist></refsect1>
11925N/A
11925N/A<refsect1 id="pidgin-1-attr"><title>&attr-tt;</title>
11925N/A<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>
11925N/A<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>
11925N/Afor descriptions of the following attributes:</para>
11925N/A<informaltable frame="all">
11925N/A<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">
11925N/A<colspec colname="COLSPEC1" colwidth="1*">
11925N/A<thead>
11925N/A<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"
11925N/Avalign="middle">ATTRIBUTE VALUE</entry></row>
11925N/A</thead>
11925N/A<tbody>
11925N/A<row><entry><para>Availability</para></entry>
11925N/A<entry><para>SUNWgnome-im-client</para></entry>
11925N/A</row>
11925N/A<row><entry colname="COLSPEC0"><para>Interface stability</para></entry>
11925N/A<entry colname="COLSPEC1"><para>Volatile</para></entry></row>
11925N/A</tbody>
11925N/A</tgroup>
11925N/A</informaltable>
11925N/A</refsect1>
11925N/A
11925N/A<refsect1 id="pidgin-1-also"><title>&also-tt;</title>
11925N/A<!--Reference to another man page-->
11925N/A<!--Reference to a Help manual-->
11925N/A<!--Reference to a book.-->
11925N/A<para>
11925N/A<citerefentry><refentrytitle>otr_parse</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
11925N/A<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
11925N/A<citerefentry><refentrytitle>gnome-std-options</refentrytitle><manvolnum>5</manvolnum></citerefentry>
11925N/A</para>
11925N/A<para>
11925N/A<citetitle>&cmd; Manual</citetitle>,
11925N/A<literal>http://pidgin.im/</literal>
11925N/A</para>
11925N/A</refsect1>
11925N/A<refsect1 id="pidgin-1-note"><title>&note-tt;</title>
11925N/A<para>
11925N/AThis man page was originally written by Dennis Ristuccia (dennis@dennisr.net).
11925N/AUpdated and largely rewritten by Sean Egan (bj91704@binghamton.edu) and Ben
11925N/ATegarden (tegarden@uclink.berkeley.edu). Updated by Stephen Browne, Rick Ju,
11925N/Aand Brian Cameron, Sun Microsystems Inc, 2003, 2006, 2007.
11925N/A</para>
11925N/A</refsect1>
11925N/A</refentry>