comparison doc/gaim.1.in @ 8736:374477c0dd76

[gaim-migrate @ 9491] (21:37:35) nosnilmot: LSchiere: do you want this? http://nosnilmot.com/patches/gaim-0.77cvs-doclove.patch (21:38:43) LSchiere: oh wow (21:38:44) LSchiere: sure (21:38:56) nosnilmot: oh crap, does that spelling nonsense conflict with it? (21:40:22) nosnilmot: LSchiere: apparently the spelling police avoided doc/ , so that patch should still apply (21:40:29) KingAnt: :-) (21:40:31) LSchiere: nosnilmot: commit message? (21:40:44) KingAnt: "Dr. Love" (21:40:54) nosnilmot: "I never knew EvilDennisR did anything, now I do" (21:41:05) LSchiere: and the serious commit message? but apparently we aren't being serious tonight. committer: Tailor Script <[e-mail]>

8735:92cbf9713795

Launch the \fBAccount Editor\fR rather than the \fBLogin\fR window on start.
.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 \-f, \-\-file=\fIFILE\fB
Use \fIFILE\fR as the configuration file instead of \fI~/.gaimrc\fR.
.TP
.B \-h, \-\-help
Print this help and exit.
.TP
.B \-l, \-\-login[=\fINAME\fB]

.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 html files (with a .log extenstion) located in 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 conversataions.

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. 

.SH Interface

\fIDisplay remote nicknames if no alias is set\fR: Toggles whether server nickname data should be used if no local alias exists.

.TP
.B Themes
Allows the user to choose between different emoticon themes.
.TP
.B Fonts
Lets the user pick a default font style/face/color for all accounts (only available in protocols that accept HTML messages).
.TP
.B Message Text
\fIShow graphical smileys\fR: Enables the replacement of text emoticons with their graphical equivalents.

\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.

.TP
.B Shortcuts
Allows the user to determine which keyboard shortcuts are available.
.TP
.B Buddy List
\fIHide IM/Info/Chat buttons\fR: Disables the display of these buttons on the
\fBBuddy List\fR's \fBOnline\fR pane.

\fIShow pictures on buttons\fR: Toggles between picture-only and text-only views of the buttons on the \fBBuddy List\fR.

\fISave window size/position\fR: If enabled, \fBgaim\fR will place the \fBBuddy List\fR at its last screen position at start-up.

\fIRaise window on events\fR: Tells \fBgaim\fR to bring the \fBBuddy List\fR window to the top when buddies sign in or out.

\fIHide groups with no online buddies\fR: Groups in which no buddies are currently logged in will not be shown in the \fBOnline\fR pane.

\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 type icons\fR: The icons showing which protocol each buddy uses and whether or not the buddy is away will not be shown.

\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).

\fIGrey idle buddies\fR: If enabled, idle buddies will be displayed in grey text instead of black text.
.TP
.B IM Window
\fIShow buttons as...\fR: The selected item will determine whether picture-only, text-only, or combined picture/text buttons will be used for \fBConversation\fR windows.

\fINew window width/height...\fR: The values here determine how large \fBConversation\fR windows are by default.  However, each window can be independently resized.

\fITab Completion\fR: In a chat room with many participants, it can be tedious to keep typing the screen name of the user to whom you wish to direct a comment.  These options allow \fITab\fR to expand the current text into a valid nickname.
\fIShow people joining/leaving in window\fR: When chat room participants enter or exit the room, the information will be displayed in the \fBBuddy Chat\fR window.

\fIColorize screennames\fR: Color code the screen names of users in chat rooms.
.TP
.B Tabs
Tabbed chatting allows one to have multiple conversations without multiple windows. \fbTabs\fR show which conversations have unanswered messages, and can identify a user either by screen name or by alias.

.SH Proxy

The configuration section to enable \fBgaim\fR to operate through a proxy server.  \fBgaim\fR currently supports SOCKS 4/5 and HTTP proxies.

\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 Sounds

\fINo sounds when you log in\fR: Makes the log-in process silent.

\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).

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 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.  From left to right:
.TP
.B Bold
adds <b></b> to your message
.TP
.B Italics
adds <i></i> to your message
.TP
.B Underline
adds <u></u> to your message
.TP
.B Decrease font size
adds <font size="1"></font> to your message
.TP
.B Default font size
adds <font size="3"></font> to your message
.TP
.B Increase font size
adds <font size="5"></font> to your message
.TP
.B Select a foreground color
adds an appropriate font tag to your message.
.TP
.B Select a background color
adds an appropriate body tag to your message.
.TP
.B Add image
inserts an appropriate img tag (not available in all protocols).
.TP
.B Add hyperlink
adds an appropriate a href tag to your message.
.TP
.B Add smiley
adds an ASCII smiley to your message.  This will become a graphic smiley in the upper text box if the option for graphical smileys is set.

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).

\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 FILES
\fI@prefix@/bin/gaim\fR: \fBgaim\fR's location.
.br
\fI@prefix@/lib/gaim/\fR: \fBgaim\fR's plugins directory.
.br

.br
\fI~/.gaim/status.xml\fR: stores your away messages.
.br
\fI~/.gaim/pounces.xml\fR: stores your buddy pounces.
.br
\fI~/.gaim/logs/SCREENNAME.log\fR: a log of all conversation with \fISCREENNAME\fR.
.br
\fI~/.gaim/blist.xml\fR: the buddy list.

.SH BUGS
Known bugs are listed at \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 -u > my.diff\fR against the latest CVS version) at \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.

8736:374477c0dd76

Launch the \fBAccount Editor\fR rather than the \fBLogin\fR window on start.
.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 \-l, \-\-login[=\fINAME\fB]

.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 extenstion) 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 conversataions.

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. 

.SH Interface

\fIDisplay remote nicknames if no alias is set\fR: Toggles whether server nickname data should be used if no local alias exists.

.TP
.B Smiley Themes
Allows the user to choose between different smiley themes.
.TP
.B Fonts
Lets the user pick a default font style/face/color for all accounts (only applicable to protocols that support HTML formatting in messages).
.TP
.B Message Text
\fIShow graphical smileys\fR: Enables the replacement of text emoticons with their graphical equivalents.

\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.

.TP
.B Shortcuts
Allows the user to determine which keyboard shortcuts are available.
.TP
.B 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, picure 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

\fIPlacement...\fR: Determines where new conversations will be placed (Last created window / New window / windows grouped by group or account).

\fISend URLs as links\fR: Automatically turns URLs into clickable links when sent on protocols that support HTML.

\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.

\fITab Placement...\fR: Specifies where tabs are shown in the conversation window.

\fIShow IMs and chats in tabbed windows\fR: Tabbed chatting allows one to have multiple conversations without multiple windows.

\fIShow IMs and chats in same tabbed window\fR: Uses the same window for both IMs and chats.

\fIShow close buttons on tabs\fR: Adds a close button to each tab.

\fIShow status icons on tabs\fR: Adds an icon to each tab representing the buddy's status.

.TP
.B IM Window
\fIShow buttons as...\fR: The selected item will determine whether picture-only, text-only, or combined picture/text buttons will be used for \fBConversation\fR windows.

\fINew window width/height...\fR: The values here determine how large \fBConversation\fR windows are by default.  However, each window can be independently resized.

\fITab Completion\fR: In a chat room with many participants, it can be tedious to keep typing the screen name of the user to whom you wish to direct a comment.  These options allow \fITab\fR to expand the current text into a valid nickname.
\fIShow people joining/leaving in window\fR: When chat room participants enter or exit the room, the information will be displayed in the \fBBuddy Chat\fR window.

\fIColorize screennames\fR: Color code the screen names of users in chat rooms.
.TP

.SH Proxy

The configuration section to enable \fBgaim\fR to operate through a proxy server.  \fBgaim\fR currently supports SOCKS 4/5 and HTTP proxies.

\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 Sounds

\fISounds when you log in\fR: Enables sounds during log-in.

\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).

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 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).

\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

.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.