comparison doc/gaim.1.in @ 8201:065a7fe05abc

[gaim-migrate @ 8924] I think this is the right file... Some of this was disgustingly outdated. It probably still has some problems, but at least we don't talk about tabbed buddy lists... committer: Tailor Script <tailor@pidgin.im>
author Mark Doliner <mark@kingant.net>
date Tue, 03 Feb 2004 05:20:52 +0000
parents 86933f4e7fb8
children 9758dcf0afcc
comparison
equal deleted inserted replaced
8200:82627be0f420 8201:065a7fe05abc
26 .TP 5 26 .TP 5
27 \fBgaim \fI[options]\fR 27 \fBgaim \fI[options]\fR
28 28
29 .SH DESCRIPTION 29 .SH DESCRIPTION
30 .PP 30 .PP
31 \fBgaim\fR is a GTK2-based Instant Messaging (IM) client designed primarily for use with AOL Instant Messenger (AIM). However, it supports most other popular IM protocols including Gadu-Gadu, ICQ, IRC, Jabber, MSN Messenger, Napster, Yahoo!, and Zephyr. 31 \fBgaim\fR is a GTK2-based Instant Messaging (IM) application. It supports multiple protocols via modules, including AIM, ICQ, Yahoo!, MSN, Jabber, IRC, Napster, Gadu-Gadu and Zephyr. It has many common features found in other clients, as well as many unique features. Gaim is not endorsed by or affiliated with AOL TimeWarner, Microsoft, or Yahoo.
32 32
33 .SH OPTIONS 33 .SH OPTIONS
34 The following options are provided by \fBgaim\fR using the standard GNU command line syntax: 34 The following options are provided by \fBgaim\fR using the standard GNU command line syntax:
35 .TP 35 .TP
36 .B \-a, \-\-acct 36 .B \-a, \-\-acct
59 .TP 59 .TP
60 .B \-w, \-\-away[=\fIMESG\fB] 60 .B \-w, \-\-away[=\fIMESG\fB]
61 Automatically go away on signon. You may optionally use the \fIMESG\fR parameter to set the away message. 61 Automatically go away on signon. You may optionally use the \fIMESG\fR parameter to set the away message.
62 62
63 .SH BUDDY LIST 63 .SH BUDDY LIST
64 The \fBBuddy List\fR window is \fBgaim\fR's main interface window. The focus of this window is the \fBBuddy List\fR itself, shown in the \fBOnline\fR pane. Buddy list organization and editing is handled in the \fBEdit Buddies\fR pane. 64 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.
65 65
66 Buddy Lists can be imported by using the \fIImport Buddy List\fR command in the \fIFile\fR menu. 66 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:
67
68 .SH Online Pane
69 The \fBOnline\fR pane 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 (if enabled in \fBgaim\fR's \fBPreferences\fR) indicates the buddy's current state. Double clicking a buddy will open a new \fBConversation\fR window. Right clicking will pop up a menu:
70 .TP 67 .TP
71 .B IM 68 .B IM
72 Opens a new \fBConversation\fR window to the selected buddy. 69 Opens a new \fBConversation\fR window to the selected buddy.
73 .TP
74 .B Alias
75 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.
76
77 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.
78 .TP 70 .TP
79 .B Add Buddy Pounce 71 .B Add Buddy Pounce
80 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. 72 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.
81 .TP 73 .TP
82 .B View Log 74 .B View Log
83 \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. 75 \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.
76 .TP
77 .B Alias
78 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.
79
80 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.
84 .LP 81 .LP
85 The remainder of the menu will consist of protocol specific commands. These commands vary depending on the protocol; below are the commands available when using OSCAR, the more popular and developer-recommended AIM protocol: 82 The remainder of the menu will consist of protocol specific commands. These commands vary depending on the protocol; below are the commands available when using OSCAR, the more popular and developer-recommended AIM protocol:
86 .TP 83 .TP
87 .B Get Info 84 .B Get Info
88 Retrieves and displays information about the buddy. This information is also known as a Profile. 85 Retrieves and displays information about the buddy. This information is also known as a Profile.
89 .TP 86 .TP
90 .B Get Away Msg 87 .B Get Away Msg
91 If this buddy is in an Away state, this will retrieve and display the buddy's \fBAway Message\fR. 88 If this buddy is in an Away state, this will retrieve and display the buddy's \fBAway Message\fR.
92 .TP
93 .B Get Capabilities
94 Retrieves and displays the client capabilities of your buddy.
95 .LP 89 .LP
96 At the bottom of the pane are several buttons (if enabled in \fBPreferences\fR): 90 At the bottom of the \fBBuddy List\fR are several buttons (if enabled in \fBPreferences\fR):
97 .TP 91 .TP
98 .B IM 92 .B IM
99 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. 93 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.
100 .TP 94 .TP
101 .B Info 95 .B Info
105 Brings up the \fBJoin Chat\fR dialog box, prompting the user to select which username to use and what chat group to join. 99 Brings up the \fBJoin Chat\fR dialog box, prompting the user to select which username to use and what chat group to join.
106 .TP 100 .TP
107 .B Away 101 .B Away
108 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. 102 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.
109 103
110 .SH Edit Buddies Pane
111 Clicking the \fBEdit Buddies\fR tab on the \fBBuddy List Window\fR will invoke the main interface to edit and organize buddy lists. Buddies already in your buddy list can be moved to different groups or reordered in the same group by clicking and dragging with the mouse. One can also add, rename, alias, or delete buddies here, as well as access some of the functions available in the \fBBuddy List Dialog\fR.
112
113 At the bottom of the pane are several buttons:
114 .TP
115 .B Add
116 This brings up the \fBAdd Buddy Dialog\fR, where you can add a buddy to your buddy list.
117 .TP
118 .B Group
119 This brings up the \fBAdd Group Dialog\fR, where you can add a group to the current connection (the connection with an item selected, otherwise the top-most connection).
120 .TP
121 .B Remove
122 This removes the currently selected buddy or group. If no buddy or group is selected, no action is taken.
123
124 .SH ACCOUNT EDITOR 104 .SH ACCOUNT EDITOR
125 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. The AIM protocol, OSCAR, is always loaded, but other protocols can be dynamically loaded and unloaded using \fBProtocols Plugins\fR (PRPLS). 105 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.
126 106
127 If \fIRemember Password\fR is chosen, the password will be saved in \fBgaim\fR's configuration file. 107 If \fIRemember Password\fR is chosen, the password will be saved in \fBgaim\fR's configuration file.
128 108
129 If \fIAuto-Login\fR is chosen, this account will automatically login upon starting \fBgaim\fR. 109 If \fIAuto-Login\fR is chosen, this account will automatically login upon starting \fBgaim\fR.
130 110
133 .SH PREFERENCES 113 .SH PREFERENCES
134 114
135 All options take effect immediately. 115 All options take effect immediately.
136 116
137 .SH Interface 117 .SH Interface
138
139 \fIShow debug window\fR: Makes visable \fBgaim\fR's debugging window, which displays more verbose operating information. A must for bug-tracking.
140 118
141 \fIDisplay remote nicknames if no alias is set\fR: Toggles whether server nickname data should be used if no local alias exists. 119 \fIDisplay remote nicknames if no alias is set\fR: Toggles whether server nickname data should be used if no local alias exists.
142 120
143 .TP 121 .TP
144 .B Themes 122 .B Themes
419 .br 397 .br
420 Mark Spencer (original author) <\fImarkster@marko.net\fR> 398 Mark Spencer (original author) <\fImarkster@marko.net\fR>
421 399
422 400
423 This manpage was originally written by Dennis Ristuccia <\fIdennis@dennisr.net\fR>. It has been updated and largely rewritten by Sean Egan <\fIbj91704@binghamton.edu\fR> and Ben Tegarden <\fItegarden@uclink.berkeley.edu\fR>. 401 This manpage was originally written by Dennis Ristuccia <\fIdennis@dennisr.net\fR>. It has been updated and largely rewritten by Sean Egan <\fIbj91704@binghamton.edu\fR> and Ben Tegarden <\fItegarden@uclink.berkeley.edu\fR>.
424