# HG changeset patch # User Richard Laager # Date 1170655807 0 # Node ID 165a9e1f5bbc078875c81992e48da8c1705d46a4 # Parent c4e19bea83c1f40fc9c36a10d026728a4c2921ae Do the rename in the man page, and make a few updates. The man page still needs some serious TLC before release, especially the section on the Preferences window. diff -r c4e19bea83c1 -r 165a9e1f5bbc doc/Makefile.am --- a/doc/Makefile.am Mon Feb 05 06:05:54 2007 +0000 +++ b/doc/Makefile.am Mon Feb 05 06:10:07 2007 +0000 @@ -1,4 +1,4 @@ -man_MANS = gaim.1 gaim-text.1 +man_MANS = pidgin.1 gaim-text.1 EXTRA_DIST = \ C-HOWTO.dox \ @@ -12,7 +12,6 @@ conversation-signals.dox \ core-signals.dox \ dbus-server-signals.dox \ - gaim.1.in \ gaims_funniest_home_convos.txt \ gaim-text.1.in \ gtkaccount-signals.dox \ @@ -23,6 +22,7 @@ gtkrc-2.0 \ log-signals.dox \ notify-signals.dox \ + pidgin.1.in \ plugin-i18n.dox \ plugin-ids.dox \ plugin-signals.dox \ diff -r c4e19bea83c1 -r 165a9e1f5bbc doc/gaim.1.in --- a/doc/gaim.1.in Mon Feb 05 06:05:54 2007 +0000 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,616 +0,0 @@ -.\" Copyright (c) 2000, Dennis Ristuccia -.\" -.\" This is free documentation; you can redistribute it and/or -.\" modify it under the terms of the GNU General Public License as -.\" published by the Free Software Foundation; either version 2 of -.\" the License, or (at your option) any later version. -.\" -.\" The GNU General Public License's references to "object code" -.\" and "executables" are to be interpreted as the output of any -.\" document formatting or typesetting system, including -.\" intermediate and printed output. -.\" -.\" This manual is distributed in the hope that it will be useful, -.\" but WITHOUT ANY WARRANTY; without even the implied warranty of -.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -.\" GNU General Public License for more details. -.\" -.\" You should have received a copy of the GNU General Public -.\" License along with this manual; if not, write to the Free -.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, -.\" USA. -.TH gaim 1 -.SH NAME -Gaim v@VERSION@ \- Instant Messaging client -.SH SYNOPSIS -.TP 5 -\fBgaim \fI[options]\fR - -.SH DESCRIPTION -.PP -\fBgaim\fR is a gtk2-based modular messaging client capable of using -AIM, MSN, Yahoo!, Jabber, ICQ, IRC, SILC, Novell GroupWise, Lotus Sametime, -Zephyr, Gadu-Gadu, and QQ all at once. It has many common features found in -other clients, as well as many unique features. Gaim is not endorsed by or -affiliated with America Online, ICQ, Microsoft, or Yahoo. - -.SH OPTIONS -The following options are provided by \fBgaim\fR using the standard GNU -command line syntax: -.TP -.B \-d, \-\-debug -Print debugging messages to stdout. These are the same debugging messages -that are displayed in the \fBDebug\fR window. -.TP -.B \-c, \-\-config=\fIDIR\fB -Use \fIDIR\fR as the directory for config files instead of \fI~/.gaim\fR. -.TP -.B \-h, \-\-help -Print this help and exit. -.TP -.B \-n, \-\-nologin -Don't automatically login when \fBgaim\fR starts. Sets all accounts to -Offline. -.TP -.B \-l, \-\-login[=\fINAME\fR,\fINAME\fR,...] -Sign in the comma-separated list of accounts provided, in addition to the -accounts that would be logged in anyway. If you do not specify such a -comma-separated list, your first account will be signed in. -.TP -.B \-v, \-\-version -Display the version information window. - -.SH BUDDY LIST -The \fBBuddy List\fR window is \fBgaim\fR's main interface window. Using -this window you can see which of your buddies is online, away, idle, etc. -You can also add and remove buddies from your buddy list. - -The \fBBuddy List\fR window contains a list of your buddies who are online -and have allowed you to be notified of their presence. The icon to the -left of each buddy indicates the buddy's current state and the protocol -they are using. Double clicking a buddy will open a new \fBConversation\fR -window. Right clicking will pop up a menu: -.TP -.B Get Info -Retrieves and displays information about the buddy. This information is -also known as a Profile. -.TP -.B IM -Opens a new \fBConversation\fR window to the selected buddy. -.TP -.B Send File -Sends a file to the selected buddy (only available on protocols that support -file transfer). -.TP -.B Add Buddy Pounce -A Buddy Pounce is a configurable automated action to be performed when the -buddy's state changes. This will open the \fBBuddy Pounce\fR dialog to be -discussed later. -.TP -.B View Log -\fBgaim\fR is capable of automatically log its activities. These logs are -either plain text files (with a .log extension) or html files (with a -\&.html extension) located under the \fI~/.gaim/logs\fR directory. This -menu command will attempt to view this file with \fBgaim\fR's internal log -viewer. -.TP -.B Alias -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. - -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. -.LP -The remainder of the menu will consist of protocol specific commands. -These commands vary depending on the protocol. -.LP -At the bottom of the \fBBuddy List\fR are several buttons (if enabled in -\fBPreferences\fR): -.TP -.B IM -Opens a new \fBConversation\fR window to to the selected buddy, or brings -up the \fBNew Message\fR dialog box if no buddy is selected. -.TP -.B Info -Retrieves and display information about the selected buddy, or brings up -the \fBGet User Info\fR dialog box if no buddy is selected. -.TP -.B Chat -Brings up the \fBJoin Chat\fR dialog box, prompting the user to select -which username to use and what chat group to join. -.TP -.B Away -Brings up a menu of all available \fBAway Messages\fR. If an item is -selected, all online accounts will use this item as their away message. - -.SH ACCOUNT EDITOR -The account editor consists of a list of accounts and information about -them. Clicking \fIDelete\fR will delete the currently selected account. -Clicking \fIAdd\fR or \fIModify\fR will invoke a \fBModify Account\fR -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. - -If \fIRemember Password\fR is chosen, the password will be saved in -\fBgaim\fR's configuration file. - -If \fIAuto-Login\fR is chosen, this account will automatically login upon -starting \fBgaim\fR. - -Each protocol has it's own specific options that can be found in the -modify screen. - -.SH PREFERENCES - -All options take effect immediately. - -.SH Interface - -\fIDisplay remote nicknames if no alias is set\fR: Toggles whether server -nickname data should be used if no local alias exists. - -.SH Buddy List -\fISorting\fR: Toggles the order in which buddies are shown in your -\fBBuddy List\fR between none, alphabetical, by status and by log size. - -\fIShow buttons as\fR: Toggles between picture-only, text-only, picture and -text or no buttons view of the buttons on the \fBBuddy List\fR. - -\fIRaise window on events\fR: Tells \fBgaim\fR to bring the \fBBuddy -List\fR window to the top when buddies sign in or out. - -\fIShow numbers in groups\fR: The number of buddies from each group -currently logged in will be shown along with the total number of buddies in -the group. - -\fIShow buddy icons\fR: Toggles the display of buddies' custom icons. - -\fIShow warning levels\fR: 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. - -\fIShow idle times\fR: 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). - -\fIDim idle buddies\fR: If enabled, idle buddies will be displayed in grey -text instead of black text. - -\fIAutomatically expand contacts\fR: If enabled, contacts will -automatically expand to show the associated buddies when the mouse is held -over the contact for a short period. - -.SH Conversations - -\fIShow buttons as...\fR: The selected item will determine whether -picture-only, text-only, combined picture/text, or no buttons will be used -for \fBConversation\fR windows. - -\fIEnable "slash" commands\fR: Determines whether messages starting with -"slash" (eg. /help) will be interpreted as commands by \fBgaim\fR, or if they -will just be sent as messages. - -\fIShow formatting toolbar\fR: Display the formatting toolbar between the -upper and lower text boxes in conversations. - -\fIShow aliases in tabs/titles\fR: Displays buddy alias instead of screen -name in window tabs and titles. - -\fIShow buddy icons\fR: 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. - -\fIEnable buddy icon animation\fR: If these pictures happen to be animated, -this option will enable the animation, otherwise only the first frame will -be displayed. - -\fINotify buddies that you are typing to them\fR: Some protocols allow -clients to tell their buddies when they are typing. This option enables -this feature for protocols that supports it. - -\fIRaise IM windows on events\fR: If enabled, IM \fBConversation\fR windows -will be brought to the top when new messages are received. - -\fIRaise Chat windows on events\fR: If enabled, chat \fBConversation\fR windows -will be brought to the top when new messages are received. - -\fIUse multi-colored screen names in chats\fR: Color code the screen names of -users in chat rooms. - -.TP -.B Tab Options -\fIShow IMs and chats in tabbed windows\fR: Tabbed chatting allows one to -have multiple conversations without multiple windows. - -\fIShow close buttons on tabs\fR: Adds a close button to each tab. - -\fITab Placement...\fR: Specifies where tabs are shown in the conversation -window. - -\fI New conversation placement...\fR: Determines where new conversations will -be placed (Last created window / New window / windows grouped by group or -account / separate windows for IMs and Chats). - -.TP -.B Message Text -\fIShow timestamp on messages\fR: Toggles the timestamp behavior for -conversations. Per-conversation behavior can be changed by pressing -\fIF2\fR in the \fBConversation\fR window. - -\fIHighlight misspelled words\fR: Toggles highlighting of misspelled words -as you type. - -\fIIgnore colors/font faces/font sizes\fR: Tells \fBgaim\fR to disregard -buddies' color/font/size information in displaying IMs or Chats. - -\fIDefault Formatting\fR: Allows specifying the default formatting to apply -to all outgoing messages (only applicable to protocols that support -formatting in messages). - -.TP -.B Shortcuts -Allows the user to determine which keyboard shortcuts are available. - -.TP -.B Smiley Themes -Allows the user to choose between different smiley themes. The "none" theme -will disable graphical emoticons - they will be displayed as text instead. - -.SH Sounds - -\fISounds while away\fR: Determines whether sounds are played when an away -message is up. - -\fISound Method\fR 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 (\fI%s\fR expands to the full path to the file name). - -.TP -.B Sound Events -Lets the user choose when and what sounds are to be played. - -.SH Network - -.TP -.B IP Address -\fIAutodetect IP Address\fR: \fBGaim\fR will attempt to automatically determine -your IP address for use in file transfers and Direct IMs. - -\fIPublic IP\fR: What IP address to use for file transfer and Direct IMs. This -is mainly useful for users with multiple network interfaces or behind NAT. - -.TP -.B Ports -\fIManually specify range of ports to listen on\fR: Specify specific ports to -listen on, overriding any defaults. - -.TP -.B Proxy Server -The configuration section to enable \fBgaim\fR to operate through a proxy -server. \fBgaim\fR currently supports SOCKS 4/5 and HTTP proxies. - -.SH Browser - -Allows the user to select \fBgaim\fR'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 -(\fI%s\fR expands to the URL). For example, \fIxterm -e lynx "%s"\fR will -open the link with lynx. \fIOpen new window by default\fR makes the -browser use a new window instead of using the current window (or spawning a -new tab). - -.SH Logging - -\fIMessage Logs\fR lets the user choose whether \fBConversations\fR and/or -\fBBuddy Chats\fR will be logged as well as whether logs will be in HTML or -plain text format. \fISystem Logs\fR describes the types of events to be -logged. - -.SH Away / Idle - -\fIQueue new messages when away\fR: Messages received since going Away will -not be shown until away status is removed. - -\fISend auto-response\fR: If someone messages you while away, your -auto-response will be sent. - -\fIOnly send auto-response when idle\fR: If someone messages you while -away, your auto-response will only be sent if \fBgaim\fR decides that the -connection is idle. - -\fIIdle time reporting\fR: If \fINone\fR is selected, account idle time -will not be reported. \fIGaim usage\fR infers your idle time from your -usage of \fBgaim\fR. \fIX usage\fR infers your idle time from \fBX\fR -(this option may not be universally available). - -\fIAuto-away\fR: Determines if and under what conditions \fBgaim\fR will -automatically turn on the Away status. - -.TP -.B Away Messages -Lets the user add/edit/remove available \fBAway Messages\fR. - -.SH Plugins - -Allows the user to enable add-on plugins for \fBgaim\fR. Several of these -come with \fBgaim\fR, while others must be downloaded separately. The -\fIDescription\fR field gives the plugin author's description of the -plugin, while the \fIDetails\fR field gives the plugin's authorship, URL, -and file name/location information. - -Some plugins can be configured. If you load such a plugin, its -configuration preferences will appear as a submenu to \fBPlugins\fR, with -the submenu title determined by the plugin's name. - -.SH Protocols - -Protocols provide protocol specific preferences here. - -.SH CONVERSATIONS -When starting a new conversation, the user is presented with the -\fBConversation\fR 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. From left -to right: -.TP -.B Bold -Turns on/off bold. -.TP -.B Italics -Turns on/off italics. -.TP -.B Underline -Turns on/off underline. -.TP -.B Decrease font size -Increases the size of the message text. -.TP -.B Increase font size -Decreases the size of the message text. -.TP -.B Select a foreground color -Changes the foreground color of the message text. -.TP -.B Select a background color -Changes the background color of the message text. -.TP -.B Add image -Inserts an in-line image in the message. -.TP -.B Add hyperlink -Adds a clickable link to the message. -.TP -.B Add smiley -Adds an emoticon (smiley) to your message. - -Beneath the lower text box is a row of buttons that execute commands: -.TP -.B Warn -This issues a warning to the other person in the conversation (not -available in all protocols). -.TP -.B Block -This adds the other person to your deny list (not available in all -protocols). -.TP -.B Send File -Send a file to this user. This option is only available on protocols where -\fBGaim\fR supports file transfer. -.TP -.B Add -This adds this user to your buddy list. This option is not available if -the user is already on your list. -.TP -.B Remove -This removes this user from your buddy list. This option is not available -if the user is not on your list. -.TP -.B Info -This gets information (a profile) about the other person in the -conversation (not available in all protocols). -.TP -.B Send -This sends what's currently in the lower text box - -.SH BUDDY CHATS -For protocols that allow it, \fBBuddy Chats\fR can be entered through the -\fIFile\fR menu or the \fIChat\fR button at the bottom of the \fBBuddy -List\fR's \fBOnline\fR tab. - -Additional commands available in chat, depending on the protocol are: -.TP -.B Whisper -The text will appear in the chat conversation, but it will only be visible -to the sender and the receiver. -.TP -.B Invite -Invite other people to join the chat room. -.TP -.B Ignore -Ignore anything said by the chosen person -.TP -.B Set Topic -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. - -.SH AWAY MESSAGES -Most protocols allow for away messages. When a user is \fIAway\fR, he can -leave an informative message for others to see. The \fBAway\fR submenu of -the \fBTools\fR menu is used to add and remove away messages. - -\fINew Away Message\fR provides space for one to enter an away message and -a title for that message. If \fISave\fR or \fISave & Use\fR are chosen, -this message will be saved. It can later be referred to by the title given -to it. - -\fIRemove Away Message\fR is a submenu containing the titles of saved away -messages. Clicking on one of these titles will remove the away message -associated with it. - -The rest of the \fIaway\fR menu provides the user with a way to assign -different away messages to different connections. Choosing \fISet All -Away\fR will set away all the connections capable of the away state. - -.SH BUDDY POUNCE -A Buddy Pounce is an automated trigger that occurs when a buddy returns to -a normal state from an away state. The \fBNew Buddy Pounce\fR dialog box -can be activated by selecting the \fIBuddy Pounce\fR submenu from the -\fBTools\fR menu. A pounce can be set to occur on any combination of the -events listed, and any combination of actions can result. If \fISave this -pounce after activation\fR is checked, the trigger will remain until it is -removed from the \fIRemove Buddy Pounce\fR menu. - -.SH PLUGINS -\fBGaim\fR allows for dynamic loading of plugins to add extra functionality -to \fBgaim\fR. Plugins can be enabled and configured from the -\fBPreferences\fR window. See \fIplugins/HOWTO\fR for more information on -writing plugins. - -.SH PERL -\fBGaim\fR allows for perl scripting. See \fIPerl Scripting HOWTO\fR in -the Gaim documentation for more information about perl scripting. - -.SH TCL -\fBGaim\fR allows for Tcl scripting. See \fIplugins/tcl/TCL-HOWTO\fR for -more information about Tcl scripting. - -.SH FILES -\fI@prefix@/bin/gaim\fR: \fBgaim\fR's location. -.br -\fI@prefix@/lib/gaim/\fR: \fBgaim\fR's plugins directory. -.br -\fI~/.gaim/prefs.xml\fR: \fBgaim\fR's configuration file. -.br -\fI~/.gaim/accounts.xml\fR: information about your accounts. -.br -\fI~/.gaim/status.xml\fR: stores your away messages. -.br -\fI~/.gaim/pounces.xml\fR: stores your buddy pounces. -.br -\fI~/.gaim/logs/PROTOCOL/ACCOUNT/SCREENNAME/DATE.log\fR: conversation logs. -.br -\fI~/.gaim/blist.xml\fR: the buddy list. -.br -\fI~/.gaim/plugins/\fR: users local plugins - -.SH BUGS -Known bugs are listed at -.br -\fIhttp://sourceforge.net/tracker/?group_id=235&atid=100235\fR - -.SH PATCHES -If you fix a bug in \fBgaim\fR (or otherwise enhance it), please submit a -patch (using \fIcvs diff -up > my.diff\fR against the latest CVS version) -at -.br -\fIhttp://sourceforge.net/tracker/?func=add&group_id=235&atid=300235\fR - -Before sending a bug report, please verify that you have the latest -version of \fBgaim\fR. Many bugs (major and minor) are fixed -at each release, and if yours is out of date, the problem may already -have been solved. - -.SH SEE ALSO -\fIhttp://gaim.sourceforge.net/\fR -.br -\fIhttp://www.sourceforge.net/projects/gaim/\fR - -.SH LICENSE -This program is free software; you can redistribute it and/or modify -it under the terms of the GNU General Public License as published by -the Free Software Foundation; either version 2 of the License, or -(at your option) any later version. - -This program is distributed in the hope that it will be useful, but -\fBWITHOUT ANY WARRANTY\fR; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU -General Public License for more details. - -You should have received a copy of the GNU General Public License -along with this program; if not, write to the Free Software -Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA - -.SH AUTHORS -\fBGaim\fR's active developers are: - - Sean Egan (lead developer) <\fIseanegan@gmail.com\fR> -.br - Daniel 'datallah' Atallah (developer) -.br - Ethan 'Paco-Paco' Blanton (developer) -.br - Thomas Butter (developer) -.br - Sadrul Habib Chowdhury (developer) -.br - Mark 'KingAnt' Doliner (developer) <\fIthekingant@users.sourceforge.net\fR> -.br - Christian 'ChipX86' Hammond (developer & webmaster) <\fIchipx86@chipx86.com\fR> -.br - Gary 'grim' Kramlich (developer) -.br - Richard 'rlaager' Laager (developer) <\fIrlaager@pidgin.im\fR> -.br - Christopher 'siege' O'Brien (developer) -.br - Bartosz Oler (developer) -.br - Etan 'deryni' Reisner (developer) -.br - Tim 'marv' Ringenbach (developer) <\fImarv_sf@users.sf.net\fR> -.br - Luke 'LSchiere' Schierer (support) -.br - Megan 'Cae' Schneider (support/QA) -.br - Evan Schoenberg (developer) -.br - Stu 'nosnilmot' Tomlinson (developer) -.br - Nathan 'faceprint' Walp (developer) -.br - - -Our crazy patch writers include: - -Ka-Hing 'javabsp' Cheung -.br -Sadrul Habib Chowdhury -.br -Felipe 'shx' Contreras -.br -Decklin Foster -.br -Peter 'Bleeter' Lawler -.br -Robert 'Robot101' McQueen -.br -Benjamin Miller -.br -Kevin 'SimGuy' Stange -.br - - -The retired developers of \fBgaim\fR are: - - Herman Bloggs (win32 port) <\fIherman@bluedigits.com\fR> -.br - Jim Duchek <\fIjim@linuxpimps.com\fR> (maintainer) -.br - Rob Flynn <\fIgaim@robflynn.com\fR> (maintainer) -.br - Adam Fritzler (libfaim maintainer) -.br - Syd Logan (hacker and designated driver [lazy bum]) -.br - Jim Seymour (Jabber developer) -.br - Mark Spencer (original author) <\fImarkster@marko.net\fR> -.br - Eric Warmenhoven (former lead developer) <\fIeric@warmenhoven.org\fR> -.br - -This manpage was originally written by Dennis Ristuccia <\fIdennis@dennisr.net\fR>. It has been updated and largely rewritten by Sean Egan <\fIseanegan@gmail.com\fR> and Ben Tegarden <\fItegarden@uclink.berkeley.edu\fR>. diff -r c4e19bea83c1 -r 165a9e1f5bbc doc/pidgin.1.in --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/pidgin.1.in Mon Feb 05 06:10:07 2007 +0000 @@ -0,0 +1,610 @@ +.\" Copyright (c) 2000, Dennis Ristuccia +.\" +.\" This is free documentation; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public License as +.\" published by the Free Software Foundation; either version 2 of +.\" the License, or (at your option) any later version. +.\" +.\" The GNU General Public License's references to "object code" +.\" and "executables" are to be interpreted as the output of any +.\" document formatting or typesetting system, including +.\" intermediate and printed output. +.\" +.\" This manual is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public +.\" License along with this manual; if not, write to the Free +.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, +.\" USA. +.TH pidgin 1 +.SH NAME +Pidgin v@VERSION@ \- Instant Messaging client +.SH SYNOPSIS +.TP 5 +\fBpidgin \fI[options]\fR + +.SH DESCRIPTION +.PP +Pidgin is a modular messaging client capable of using AIM, MSN, Yahoo!, Jabber, +ICQ, IRC, SILC, SIP/SIMPLE Novell GroupWise, Lotus Sametime, Bonjour, +Zephyr, Gadu-Gadu, and QQ all at once. It has many common features found in +other clients, as well as many unique features. Pidgin is not endorsed by or +affiliated with America Online, ICQ, Microsoft, or Yahoo. + +.SH OPTIONS +The following options are provided by Pidgin using the standard GNU +command line syntax: +.TP +.B \-c, \-\-config=\fIDIR\fB +Use \fIDIR\fR as the directory for config files instead of \fI~/.gaim\fR. +.TP +.B \-d, \-\-debug +Print debugging messages to stdout. These are the same debugging messages +that are displayed in the \fBDebug Window\fR. +.TP +.B \-h, \-\-help +Print a summary of command line options and exit. +.TP +.B \-n, \-\-nologin +Don't automatically login when Pidgin starts. Sets the global status to +\fBOffline\fR. +.TP +.B \-l, \-\-login[=\fINAME\fR,\fINAME\fR,...] +Sign in the comma-separated list of accounts provided, in addition to the +accounts that would be logged in anyway. If you do not specify such a +comma-separated list, your first account will be signed in. +.TP +.B \-v, \-\-version +Print the current version and exit. + +.SH BUDDY LIST +The \fBBuddy List\fR window is Pidgin's main interface window. Using +this window you can see which of your buddies is online, away, idle, etc. +You can also add and remove buddies from your buddy list. + +The \fBBuddy List\fR window contains a list of your buddies who are online +and have allowed you to be notified of their presence. The icon to the +left of each buddy indicates the buddy's current state and the protocol +they are using. Double clicking a buddy will open a new \fBConversation\fR +window. Right clicking will pop up a menu: +.TP +.B Get Info +Retrieves and displays information about the buddy. This information is +also known as a Profile. +.TP +.B IM +Opens a new \fBConversation\fR window to the selected buddy. +.TP +.B Send File +Sends a file to the selected buddy (only available on protocols that support +file transfer). +.TP +.B Add Buddy Pounce +A Buddy Pounce is a configurable automated action to be performed when the +buddy's state changes. This will open the \fBBuddy Pounce\fR dialog to be +discussed later. +.TP +.B View Log +Pidgin 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 \fI~/.gaim/logs\fR directory. This +menu command will display Pidgin's log viewer with logs loaded for that +buddy or chat. +.TP +.B Alias +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. + +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. +.LP +The remainder of the menu will consist of protocol specific commands. +These commands vary depending on the protocol. +.LP +At the bottom of the \fBBuddy List\fR are several buttons (if enabled in +\fBPreferences\fR): +.TP +.B IM +Opens a new \fBConversation\fR window to to the selected buddy, or brings +up the \fBNew Message\fR dialog box if no buddy is selected. +.TP +.B Info +Retrieves and display information about the selected buddy, or brings up +the \fBGet User Info\fR dialog box if no buddy is selected. +.TP +.B Chat +Brings up the \fBJoin Chat\fR dialog box, prompting the user to select +which username to use and what chat group to join. +.TP +.B Away +Brings up a menu of all available \fBAway Messages\fR. If an item is +selected, all online accounts will use this item as their away message. + +.SH ACCOUNT EDITOR +The account editor consists of a list of accounts and information about +them. Clicking \fIDelete\fR will delete the currently selected account. +Clicking \fIAdd\fR or \fIModify\fR will invoke a \fBModify Account\fR +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. + +If \fIRemember Password\fR is chosen, the password will be saved in +Pidgin's configuration file. + +If \fIAuto-Login\fR is chosen, this account will automatically login upon +starting Pidgin. + +Each protocol has it's own specific options that can be found in the +modify screen. + +.SH PREFERENCES + +All options take effect immediately. + +.SH Interface + +\fIDisplay remote nicknames if no alias is set\fR: Toggles whether server +nickname data should be used if no local alias exists. + +.SH Buddy List +\fISorting\fR: Toggles the order in which buddies are shown in your +\fBBuddy List\fR between none, alphabetical, by status and by log size. + +\fIShow buttons as\fR: Toggles between picture-only, text-only, picture and +text or no buttons view of the buttons on the \fBBuddy List\fR. + +\fIRaise window on events\fR: Tells Pidgin to bring the \fBBuddy +List\fR window to the top when buddies sign in or out. + +\fIShow numbers in groups\fR: The number of buddies from each group +currently logged in will be shown along with the total number of buddies in +the group. + +\fIShow buddy icons\fR: Toggles the display of buddies' custom icons. + +\fIShow warning levels\fR: 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. + +\fIShow idle times\fR: 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). + +\fIDim idle buddies\fR: If enabled, idle buddies will be displayed in grey +text instead of black text. + +\fIAutomatically expand contacts\fR: If enabled, contacts will +automatically expand to show the associated buddies when the mouse is held +over the contact for a short period. + +.SH Conversations + +\fIShow buttons as...\fR: The selected item will determine whether +picture-only, text-only, combined picture/text, or no buttons will be used +for \fBConversation\fR windows. + +\fIShow formatting toolbar\fR: Display the formatting toolbar between the +upper and lower text boxes in conversations. + +\fIShow aliases in tabs/titles\fR: Displays buddy alias instead of screen +name in window tabs and titles. + +\fIShow buddy icons\fR: 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. + +\fIEnable buddy icon animation\fR: If these pictures happen to be animated, +this option will enable the animation, otherwise only the first frame will +be displayed. + +\fINotify buddies that you are typing to them\fR: Some protocols allow +clients to tell their buddies when they are typing. This option enables +this feature for protocols that supports it. + +\fIRaise IM windows on events\fR: If enabled, IM \fBConversation\fR windows +will be brought to the top when new messages are received. + +\fIRaise Chat windows on events\fR: If enabled, chat \fBConversation\fR windows +will be brought to the top when new messages are received. + +\fIUse multi-colored screen names in chats\fR: Color code the screen names of +users in chat rooms. + +.TP +.B Tab Options +\fIShow IMs and chats in tabbed windows\fR: Tabbed chatting allows one to +have multiple conversations without multiple windows. + +\fIShow close buttons on tabs\fR: Adds a close button to each tab. + +\fITab Placement...\fR: Specifies where tabs are shown in the conversation +window. + +\fI New conversation placement...\fR: Determines where new conversations will +be placed (Last created window / New window / windows grouped by group or +account / separate windows for IMs and Chats). + +.TP +.B Message Text +\fIShow timestamp on messages\fR: Toggles the timestamp behavior for +conversations. Per-conversation behavior can be changed by pressing +\fIF2\fR in the \fBConversation\fR window. + +\fIHighlight misspelled words\fR: Toggles highlighting of misspelled words +as you type. + +\fIIgnore colors/font faces/font sizes\fR: Tells Pidgin to disregard +buddies' color/font/size information in displaying IMs or Chats. + +\fIDefault Formatting\fR: Allows specifying the default formatting to apply +to all outgoing messages (only applicable to protocols that support +formatting in messages). + +.TP +.B Shortcuts +Allows the user to determine which keyboard shortcuts are available. + +.TP +.B Smiley Themes +Allows the user to choose between different smiley themes. The "none" theme +will disable graphical emoticons - they will be displayed as text instead. + +.SH Sounds + +\fISounds while away\fR: Determines whether sounds are played when an away +message is up. + +\fISound Method\fR 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 (\fI%s\fR expands to the full path to the file name). + +.TP +.B Sound Events +Lets the user choose when and what sounds are to be played. + +.SH Network + +.TP +.B IP Address +\fIAutodetect IP Address\fR: Pidgin will attempt to automatically determine +your IP address for use in file transfers and Direct IMs. + +\fIPublic IP\fR: What IP address to use for file transfer and Direct IMs. This +is mainly useful for users with multiple network interfaces or behind NAT. + +.TP +.B Ports +\fIManually specify range of ports to listen on\fR: Specify specific ports to +listen on, overriding any defaults. + +.TP +.B Proxy Server +The configuration section to enable Pidgin to operate through a proxy +server. Pidgin currently supports SOCKS 4/5 and HTTP proxies. + +.SH Browser + +Allows the user to select Pidgin'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 +(\fI%s\fR expands to the URL). For example, \fIxterm -e lynx "%s"\fR will +open the link with lynx. \fIOpen new window by default\fR makes the +browser use a new window instead of using the current window (or spawning a +new tab). + +.SH Logging + +\fIMessage Logs\fR lets the user choose whether \fBConversations\fR and/or +\fBBuddy Chats\fR will be logged as well as whether logs will be in HTML or +plain text format. \fISystem Logs\fR describes the types of events to be +logged. + +.SH Away / Idle + +\fIQueue new messages when away\fR: Messages received since going Away will +not be shown until away status is removed. + +\fISend auto-response\fR: If someone messages you while away, your +auto-response will be sent. + +\fIOnly send auto-response when idle\fR: If someone messages you while +away, your auto-response will only be sent if Pidgin decides that the +connection is idle. + +\fIIdle time reporting\fR: If \fINone\fR is selected, account idle time +will not be reported. \fIPidgin usage\fR infers your idle time from your +usage of Pidgin. \fIX usage\fR infers your idle time from \fBX\fR +(this option may not be universally available). + +\fIAuto-away\fR: Determines if and under what conditions Pidgin will +automatically turn on the Away status. + +.TP +.B Away Messages +Lets the user add/edit/remove available \fBAway Messages\fR. + +.SH Plugins + +Allows the user to enable add-on plugins for Pidgin. Several of these +come with Pidgin, while others must be downloaded separately. The +\fIDescription\fR field gives the plugin author's description of the +plugin, while the \fIDetails\fR field gives the plugin's authorship, URL, +and file name/location information. + +Some plugins can be configured. If you load such a plugin, its +configuration preferences will appear as a submenu to \fBPlugins\fR, with +the submenu title determined by the plugin's name. + +.SH Protocols + +Protocols provide protocol specific preferences here. + +.SH CONVERSATIONS +When starting a new conversation, the user is presented with the +\fBConversation\fR 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. From left +to right: +.TP +.B Bold +Turns on/off bold. +.TP +.B Italics +Turns on/off italics. +.TP +.B Underline +Turns on/off underline. +.TP +.B Decrease font size +Increases the size of the message text. +.TP +.B Increase font size +Decreases the size of the message text. +.TP +.B Select a foreground color +Changes the foreground color of the message text. +.TP +.B Select a background color +Changes the background color of the message text. +.TP +.B Add image +Inserts an in-line image in the message. +.TP +.B Add hyperlink +Adds a clickable link to the message. +.TP +.B Add smiley +Adds an emoticon (smiley) to your message. + +Beneath the lower text box is a row of buttons that execute commands: +.TP +.B Warn +This issues a warning to the other person in the conversation (not +available in all protocols). +.TP +.B Block +This adds the other person to your deny list (not available in all +protocols). +.TP +.B Send File +Send a file to this user. This option is only available on protocols where +Pidgin supports file transfer. +.TP +.B Add +This adds this user to your buddy list. This option is not available if +the user is already on your list. +.TP +.B Remove +This removes this user from your buddy list. This option is not available +if the user is not on your list. +.TP +.B Info +This gets information (a profile) about the other person in the +conversation (not available in all protocols). +.TP +.B Send +This sends what's currently in the lower text box + +.SH BUDDY CHATS +For protocols that allow it, \fBBuddy Chats\fR can be entered through the +\fIFile\fR menu or the \fIChat\fR button at the bottom of the \fBBuddy +List\fR's \fBOnline\fR tab. + +Additional commands available in chat, depending on the protocol are: +.TP +.B Whisper +The text will appear in the chat conversation, but it will only be visible +to the sender and the receiver. +.TP +.B Invite +Invite other people to join the chat room. +.TP +.B Ignore +Ignore anything said by the chosen person +.TP +.B Set Topic +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. + +.SH AWAY MESSAGES +Most protocols allow for away messages. When a user is \fIAway\fR, he can +leave an informative message for others to see. The \fBAway\fR submenu of +the \fBTools\fR menu is used to add and remove away messages. + +\fINew Away Message\fR provides space for one to enter an away message and +a title for that message. If \fISave\fR or \fISave & Use\fR are chosen, +this message will be saved. It can later be referred to by the title given +to it. + +\fIRemove Away Message\fR is a submenu containing the titles of saved away +messages. Clicking on one of these titles will remove the away message +associated with it. + +The rest of the \fIaway\fR menu provides the user with a way to assign +different away messages to different connections. Choosing \fISet All +Away\fR will set away all the connections capable of the away state. + +.SH BUDDY POUNCE +A Buddy Pounce is an automated trigger that occurs when a buddy returns to +a normal state from an away state. The \fBNew Buddy Pounce\fR dialog box +can be activated by selecting the \fIBuddy Pounce\fR submenu from the +\fBTools\fR menu. A pounce can be set to occur on any combination of the +events listed, and any combination of actions can result. If \fISave this +pounce after activation\fR is checked, the trigger will remain until it is +removed from the \fIRemove Buddy Pounce\fR menu. + +.SH PLUGINS +Pidgin allows for dynamic loading of plugins to add extra functionality +to Pidgin. Plugins can be enabled and configured from the +\fBPreferences\fR window. See \fIplugins/HOWTO\fR for more information on +writing plugins. + +.SH PERL +Pidgin allows for perl scripting. See \fIPerl Scripting HOWTO\fR in +the Pidgin documentation for more information about perl scripting. + +.SH TCL +Pidgin allows for Tcl scripting. See \fIplugins/tcl/TCL-HOWTO\fR for +more information about Tcl scripting. + +.SH FILES +\fI@prefix@/bin/pidgin\fR: Pidgin's location. +.br +\fI@prefix@/lib/pidgin/\fR: Pidgin's plugins directory. +.br +\fI~/.gaim/prefs.xml\fR: Pidgin's configuration file. +.br +\fI~/.gaim/accounts.xml\fR: information about your accounts. +.br +\fI~/.gaim/status.xml\fR: stores your away messages. +.br +\fI~/.gaim/pounces.xml\fR: stores your buddy pounces. +.br +\fI~/.gaim/logs/PROTOCOL/ACCOUNT/SCREENNAME/DATE.log\fR: conversation logs. +.br +\fI~/.gaim/blist.xml\fR: the buddy list. +.br +\fI~/.gaim/plugins/\fR: users local plugins + +.SH BUGS +Known bugs are listed at +.br +\fIhttp://sourceforge.net/tracker/?group_id=235&atid=100235\fR + +.SH PATCHES +If you fix a bug in Pidgin (or otherwise enhance it), please submit a +patch (using \fImtn diff > my.diff\fR against the latest version from the +Monotone repository) at +.br +\fIhttp://developer.pidgin.im/newticket\fR + +Before sending a bug report, please verify that you have the latest +version of Pidgin. Many bugs (major and minor) are fixed +at each release, and if yours is out of date, the problem may already +have been solved. + +.SH SEE ALSO +\fIhttp://pidgin.im/\fR + +.SH LICENSE +This program is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, but +\fBWITHOUT ANY WARRANTY\fR; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program; if not, write to the Free Software +Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + +.SH AUTHORS +Pidgin's active developers are: + + Sean Egan (lead developer) <\fIseanegan@gmail.com\fR> +.br + Daniel 'datallah' Atallah (developer) +.br + Ethan 'Paco-Paco' Blanton (developer) +.br + Thomas Butter (developer) +.br + Sadrul Habib Chowdhury (developer) +.br + Mark 'KingAnt' Doliner (developer) <\fIthekingant@users.sourceforge.net\fR> +.br + Christian 'ChipX86' Hammond (developer & webmaster) <\fIchipx86@chipx86.com\fR> +.br + Gary 'grim' Kramlich (developer) +.br + Richard 'rlaager' Laager (developer) <\fIrlaager@pidgin.im\fR> +.br + Christopher 'siege' O'Brien (developer) +.br + Bartosz Oler (developer) +.br + Etan 'deryni' Reisner (developer) +.br + Tim 'marv' Ringenbach (developer) <\fImarv_sf@users.sf.net\fR> +.br + Luke 'LSchiere' Schierer (support) +.br + Megan 'Cae' Schneider (support/QA) +.br + Evan Schoenberg (developer) +.br + Stu 'nosnilmot' Tomlinson (developer) +.br + Nathan 'faceprint' Walp (developer) +.br + + +Our crazy patch writers include: + +Ka-Hing 'javabsp' Cheung +.br +Sadrul Habib Chowdhury +.br +Felipe 'shx' Contreras +.br +Decklin Foster +.br +Peter 'Bleeter' Lawler +.br +Robert 'Robot101' McQueen +.br +Benjamin Miller +.br +Kevin 'SimGuy' Stange +.br + + +The retired developers of \fBgaim\fR are: + + Herman Bloggs (win32 port) <\fIherman@bluedigits.com\fR> +.br + Jim Duchek <\fIjim@linuxpimps.com\fR> (maintainer) +.br + Rob Flynn <\fIgaim@robflynn.com\fR> (maintainer) +.br + Adam Fritzler (libfaim maintainer) +.br + Syd Logan (hacker and designated driver [lazy bum]) +.br + Jim Seymour (Jabber developer) +.br + Mark Spencer (original author) <\fImarkster@marko.net\fR> +.br + Eric Warmenhoven (former lead developer) <\fIeric@warmenhoven.org\fR> +.br + +This manpage was originally written by Dennis Ristuccia <\fIdennis@dennisr.net\fR>. It has been updated and largely rewritten by Sean Egan <\fIseanegan@gmail.com\fR> and Ben Tegarden <\fItegarden@uclink.berkeley.edu\fR>.