rekkanoryo at pidgin.im
rekkanoryo at pidgin.im
Sun Nov 4 23:20:55 EST 2007
Author: rekkanoryo at pidgin.im
The first few of many updates needed for the man page. This round:
* Updates the AUTHORS section to more closely resemble the About box
* Updates the formatting toolbar section to match the current reality
* Updates Buddy Pounces section to reflect Kevin's new pounce dialog
* Changes AWAY MESSAGES to STATUS MESSAGES and updates that information
to be more current.
-------------- next part --------------
--- doc/pidgin.1.in 0d5bc25c06d5a4a06a90348bba1688e68100785b
+++ doc/pidgin.1.in 6f204e175140870370f797efe760674a4f828d57
@@ -341,81 +341,30 @@ the submenu title determined by the plug
configuration preferences will appear as a submenu to \fBPlugins\fR, with
the submenu title determined by the plugin's name.
-Protocols provide protocol specific preferences here.
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
+is a row of options, represented by icons. Some or all buttons may not be
active if the protocol does not support the specific formatting. From left
-Turns on/off bold.
+This menu provides font control options for the current conversation. Size,
+style, and face may be configured here.
-Turns on/off italics.
+This menu provides the ability to insert images, horizontal rules, and links
+where the protocol supports each of these features.
-Turns on/off underline.
-.B Decrease font size
-Increases the size of the message text.
-.B Increase font size
-Decreases the size of the message text.
-.B Select a foreground color
-Changes the foreground color of the message text.
-.B Select a background color
-Changes the background color of the message text.
-.B Add image
-Inserts an in-line image in the message.
-.B Add hyperlink
-Adds a clickable link to the message.
-.B Add smiley
-Adds an emoticon (smiley) to your message.
+Allows the insertion of graphical smileys via the mouse. This button shows
+the user a dialog with the available smileys for the current conversation.
-Beneath the lower text box is a row of buttons that execute commands:
-This issues a warning to the other person in the conversation (not
-available in all protocols).
-This adds the other person to your deny list (not available in all
-.B Send File
-Send a file to this user. This option is only available on protocols where
-Pidgin supports file transfer.
-This adds this user to your buddy list. This option is not available if
-the user is already on your list.
-This removes this user from your buddy list. This option is not available
-if the user is not on your list.
-This gets information (a profile) about the other person in the
-conversation (not available in all protocols).
-This sends what's currently in the lower text box
+For protocols that allow it, \fBChats\fR can be entered through the
-.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:
@@ -433,37 +382,33 @@ describing the nature of the chat--an ex
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.
+.SH STATUS MESSAGES
+Most protocols allow for status messages. By using status messages, a user
+can leave an informative message for others to see. Status and status
+messages are configured via the status selector at the bottom of the Buddy
+List window. By default the menu shown here is divided into sections for
+"primitive" status types, such as \fIAvailable\fR, \fIAway\fR, etc.; a few
+"popular" statuses which have been recently used, and a section which shows
+\fBNew...\fR and \fBSaved...\fR options for more advanced status manipulation.
-\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
-\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.
+a normal state from an away state. The \fBBuddy Pounce\fR dialog box
+can be activated by selecting the \fIBuddy Pounce\fR option from the
+\fBTools\fR menu. From this dialog, new pounces can be created with the
+\fBAdd\fR button and existing pounces can be removed with the \fBDelete\fR
+button. A pounce can be set to occur on any combination of the
+events listed, and any combination of actions can result. If \fIPounce
+only when my status is not Available\fR is checked, the pounce will occur
+only if you are set to a non-available status, such as invisible, do not
+disturb, away, etc. If \fIRecurring\fR is checked, the pounce will remain
+until removed by the \fBDelete\fR button.
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
+\fBPreferences\fR window. See \fIplugins/HOWTO\fR or
+\fIhttp://developer.pidgin.im/wiki/CHowTo\fR for more information on
@@ -491,19 +436,15 @@ more information about Tcl scripting.
\fI~/.purple/blist.xml\fR: the buddy list.
-\fI~/.purple/plugins/\fR: users local plugins
+\fI~/.purple/plugins/\fR: users' local plugins
-The bug tracker can be reached by visiting:
+The bug tracker can be reached by visiting \fIhttp://developer.pidgin.im/query\fR
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
+Monotone repository) at \fIhttp://developer.pidgin.im/simpleticket\fR
Before sending a bug report, please verify that you have the latest
version of Pidgin. Many bugs (major and minor) are fixed
@@ -530,86 +471,105 @@ Pidgin's active developers are:
Pidgin's active developers are:
- Sean Egan (lead developer) <\fIseanegan at gmail.com\fR>
- Daniel 'datallah' Atallah (developer)
+ Sean Egan (lead developer) <\fIseanegan at gmail.com\fR>
- Ethan 'Paco-Paco' Blanton (developer)
+ Daniel 'datallah' Atallah (developer)
- Thomas Butter (developer)
+ John 'rekkanoryo' Bailey (developer)
- Ka-Hing Cheung (developer)
+ Ethan 'Paco-Paco' Blanton (developer)
- Sadrul Habib Chowdhury (developer)
+ Thomas Butter (developer)
- Mark 'KingAnt' Doliner (developer) <\fIthekingant at users.sourceforge.net\fR>
+ Ka-Hing Cheung (developer)
- Christian 'ChipX86' Hammond (developer & webmaster) <\fIchipx86 at chipx86.com\fR>
+ Sadrul Habib Chowdhury (developer)
- Gary 'grim' Kramlich (developer)
+ Mark 'KingAnt' Doliner (developer) <\fIthekingant at users.sourceforge.net\fR>
- Richard 'rlaager' Laager (developer) <\fIrlaager at pidgin.im\fR>
+ Casey Harkins (developer)
- Richard 'wabz' Nelson (developer)
+ Gary 'grim' Kramlich (developer)
- Christopher 'siege' O'Brien (developer)
+ Richard 'rlaager' Laager (developer) <\fIrlaager at pidgin.im\fR>
- Bartosz Oler (developer)
+ Richard 'wabz' Nelson (developer)
- Etan 'deryni' Reisner (developer)
+ Christopher 'siege' O'Brien (developer)
- Tim 'marv' Ringenbach (developer) <\fImarv_sf at users.sf.net\fR>
+ Bartosz Oler (developer)
- Luke 'LSchiere' Schierer (support)
+ Etan 'deryni' Reisner (developer)
- Megan 'Cae' Schneider (support/QA)
+ Tim 'marv' Ringenbach (developer) <\fImarv_sf at users.sf.net\fR>
- Evan Schoenberg (developer)
+ Luke 'LSchiere' Schierer (support)
- Stu 'nosnilmot' Tomlinson (developer)
+ Megan 'Cae' Schneider (support/QA)
- Nathan 'faceprint' Walp (developer)
+ Evan Schoenberg (developer)
+ Kevin 'SimGuy' Stange (developer and webmaster)
+ Stu 'nosnilmot' Tomlinson (developer)
+ Nathan 'faceprint' Walp (developer)
Our crazy patch writers include:
+ Dennis 'EvilDennisR' Ristuccia
+ Peter 'fmoo' Ruibal
+ Gabriel 'Nix' Schulhof
+ Will 'resiak' Thompson
-John 'rekkanoryo' Bailey
+Our artists are:
-Felipe 'shx' Contreras
+ Hylke Bons <\fIh.bons at student.rug.nl\fR>
+Our retired developers are:
+ Herman Bloggs (win32 port) <\fIherman at bluedigits.com\fR>
-Peter 'Bleeter' Lawler
+ Jim Duchek <\fIjim at linuxpimps.com\fR> (maintainer)
-Robert 'Robot101' McQueen
+ Rob Flynn <\fIgaim at robflynn.com\fR> (maintainer)
+ Adam Fritzler (libfaim maintainer)
-Kevin 'SimGuy' Stange
+ Christian 'ChipX86' Hammond (developer & webmaster) <\fIchipx86 at chipx86.com\fR>
-The retired developers of \fBgaim\fR are:
- Herman Bloggs (win32 port) <\fIherman at bluedigits.com\fR>
+ Syd Logan (hacker and designated driver [lazy bum])
- Jim Duchek <\fIjim at linuxpimps.com\fR> (maintainer)
+ Jim Seymour (XMPP developer)
- Rob Flynn <\fIgaim at robflynn.com\fR> (maintainer)
+ Mark Spencer (original author) <\fImarkster at marko.net\fR>
- Adam Fritzler (libfaim maintainer)
+ Eric Warmenhoven (former lead developer) <\fIeric at warmenhoven.org\fR>
- Syd Logan (hacker and designated driver [lazy bum])
+Our retired crazy patch writers include:
- Jim Seymour (Jabber developer)
+ Felipe 'shx' Contreras
- Mark Spencer (original author) <\fImarkster at marko.net\fR>
+ Decklin Foster
- Eric Warmenhoven (former lead developer) <\fIeric at warmenhoven.org\fR>
+ Peter 'Bleeter' Lawler
+ Robert 'Robot101' McQueen
+ Benjamin Miller
This manpage was originally written by Dennis Ristuccia <\fIdennis at dennisr.net\fR>. It has been updated and largely rewritten by Sean Egan <\fIseanegan at gmail.com\fR> and Ben Tegarden <\fItegarden at uclink.berkeley.edu\fR>.
More information about the Commits