im.pidgin.pidgin: de413390d6cfd199238da03e9d83b20ac231c258
rekkanoryo at pidgin.im
rekkanoryo at pidgin.im
Sun Nov 4 23:20:55 EST 2007
-----------------------------------------------------------------
Revision: de413390d6cfd199238da03e9d83b20ac231c258
Ancestor: c795c095e383b25c78043c651ed440d45caeba49
Author: rekkanoryo at pidgin.im
Date: 2007-11-05T04:16:03
Branch: im.pidgin.pidgin
Modified files:
doc/pidgin.1.in
ChangeLog:
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.
-.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
+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
to right:
.TP
-.B Bold
-Turns on/off bold.
+.B Font
+This menu provides font control options for the current conversation. Size,
+style, and face may be configured here.
.TP
-.B Italics
-Turns on/off italics.
+.B Insert
+This menu provides the ability to insert images, horizontal rules, and links
+where the protocol supports each of these features.
.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.
+.B Smile!
+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:
-.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 CHATS
+For protocols that allow it, \fBChats\fR can be entered through the
+\fIBuddies\fR menu.
-.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
@@ -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
-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.
+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.
.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
+\fBPreferences\fR window. See \fIplugins/HOWTO\fR or
+\fIhttp://developer.pidgin.im/wiki/CHowTo\fR for more information on
writing plugins.
.SH PERL
@@ -491,19 +436,15 @@ more information about Tcl scripting.
.br
\fI~/.purple/blist.xml\fR: the buddy list.
.br
-\fI~/.purple/plugins/\fR: users local plugins
+\fI~/.purple/plugins/\fR: users' local plugins
.SH BUGS
-The bug tracker can be reached by visiting:
-.br
-\fIhttp://developer.pidgin.im/report\fR
+The bug tracker can be reached by visiting \fIhttp://developer.pidgin.im/query\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
+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:
.SH AUTHORS
Pidgin's active developers are:
-
- Sean Egan (lead developer) <\fIseanegan at gmail.com\fR>
.br
- Daniel 'datallah' Atallah (developer)
+ Sean Egan (lead developer) <\fIseanegan at gmail.com\fR>
.br
- Ethan 'Paco-Paco' Blanton (developer)
+ Daniel 'datallah' Atallah (developer)
.br
- Thomas Butter (developer)
+ John 'rekkanoryo' Bailey (developer)
.br
- Ka-Hing Cheung (developer)
+ Ethan 'Paco-Paco' Blanton (developer)
.br
- Sadrul Habib Chowdhury (developer)
+ Thomas Butter (developer)
.br
- Mark 'KingAnt' Doliner (developer) <\fIthekingant at users.sourceforge.net\fR>
+ Ka-Hing Cheung (developer)
.br
- Christian 'ChipX86' Hammond (developer & webmaster) <\fIchipx86 at chipx86.com\fR>
+ Sadrul Habib Chowdhury (developer)
.br
- Gary 'grim' Kramlich (developer)
+ Mark 'KingAnt' Doliner (developer) <\fIthekingant at users.sourceforge.net\fR>
.br
- Richard 'rlaager' Laager (developer) <\fIrlaager at pidgin.im\fR>
+ Casey Harkins (developer)
.br
- Richard 'wabz' Nelson (developer)
+ Gary 'grim' Kramlich (developer)
.br
- Christopher 'siege' O'Brien (developer)
+ Richard 'rlaager' Laager (developer) <\fIrlaager at pidgin.im\fR>
.br
- Bartosz Oler (developer)
+ Richard 'wabz' Nelson (developer)
.br
- Etan 'deryni' Reisner (developer)
+ Christopher 'siege' O'Brien (developer)
.br
- Tim 'marv' Ringenbach (developer) <\fImarv_sf at users.sf.net\fR>
+ Bartosz Oler (developer)
.br
- Luke 'LSchiere' Schierer (support)
+ Etan 'deryni' Reisner (developer)
.br
- Megan 'Cae' Schneider (support/QA)
+ Tim 'marv' Ringenbach (developer) <\fImarv_sf at users.sf.net\fR>
.br
- Evan Schoenberg (developer)
+ Luke 'LSchiere' Schierer (support)
.br
- Stu 'nosnilmot' Tomlinson (developer)
+ Megan 'Cae' Schneider (support/QA)
.br
- Nathan 'faceprint' Walp (developer)
+ Evan Schoenberg (developer)
.br
+ Kevin 'SimGuy' Stange (developer and webmaster)
+.br
+ Stu 'nosnilmot' Tomlinson (developer)
+.br
+ Nathan 'faceprint' Walp (developer)
+.br
Our crazy patch writers include:
+.br
+ Dennis 'EvilDennisR' Ristuccia
+.br
+ Peter 'fmoo' Ruibal
+.br
+ Gabriel 'Nix' Schulhof
+.br
+ Will 'resiak' Thompson
+.br
-John 'rekkanoryo' Bailey
+
+Our artists are:
.br
-Felipe 'shx' Contreras
+ Hylke Bons <\fIh.bons at student.rug.nl\fR>
.br
-Decklin Foster
+
+
+Our retired developers are:
.br
-Casey Harkins
+ Herman Bloggs (win32 port) <\fIherman at bluedigits.com\fR>
.br
-Peter 'Bleeter' Lawler
+ Jim Duchek <\fIjim at linuxpimps.com\fR> (maintainer)
.br
-Robert 'Robot101' McQueen
+ Rob Flynn <\fIgaim at robflynn.com\fR> (maintainer)
.br
-Benjamin Miller
+ Adam Fritzler (libfaim maintainer)
.br
-Kevin 'SimGuy' Stange
+ Christian 'ChipX86' Hammond (developer & webmaster) <\fIchipx86 at chipx86.com\fR>
.br
-
-
-The retired developers of \fBgaim\fR are:
-
- Herman Bloggs (win32 port) <\fIherman at bluedigits.com\fR>
+ Syd Logan (hacker and designated driver [lazy bum])
.br
- Jim Duchek <\fIjim at linuxpimps.com\fR> (maintainer)
+ Jim Seymour (XMPP developer)
.br
- Rob Flynn <\fIgaim at robflynn.com\fR> (maintainer)
+ Mark Spencer (original author) <\fImarkster at marko.net\fR>
.br
- Adam Fritzler (libfaim maintainer)
+ Eric Warmenhoven (former lead developer) <\fIeric at warmenhoven.org\fR>
.br
- Syd Logan (hacker and designated driver [lazy bum])
+
+
+Our retired crazy patch writers include:
.br
- Jim Seymour (Jabber developer)
+ Felipe 'shx' Contreras
.br
- Mark Spencer (original author) <\fImarkster at marko.net\fR>
+ Decklin Foster
.br
- Eric Warmenhoven (former lead developer) <\fIeric at warmenhoven.org\fR>
+ Peter 'Bleeter' Lawler
.br
+ Robert 'Robot101' McQueen
+.br
+ Benjamin Miller
+.br
+
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
mailing list