Mercurial > pidgin.yaz
annotate doc/gaim-text.1.in @ 15034:b28f5caf9445
[gaim-migrate @ 17816]
This fixes gnt builds for me (avoiding multiple-definition errors when linking) by marking some declarations as extern in the gntkeys.h and actually defining them in gntkeys.c
committer: Tailor Script <tailor@pidgin.im>
author | Christopher O'Brien <siege@pidgin.im> |
---|---|
date | Thu, 23 Nov 2006 15:22:53 +0000 |
parents | 6e7184096615 |
children | c8228e154e24 |
rev | line source |
---|---|
14585 | 1 .\" Copyright (c) 2006, Sadrul Habib Chowdhury <sadrul@users.sf.net> |
2 .\" | |
3 .\" This is free documentation; you can redistribute it and/or | |
4 .\" modify it under the terms of the GNU General Public License as | |
5 .\" published by the Free Software Foundation; either version 2 of | |
6 .\" the License, or (at your option) any later version. | |
7 .\" | |
8 .\" The GNU General Public License's references to "object code" | |
9 .\" and "executables" are to be interpreted as the output of any | |
10 .\" document formatting or typesetting system, including | |
11 .\" intermediate and printed output. | |
12 .\" | |
13 .\" This manual is distributed in the hope that it will be useful, | |
14 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of | |
15 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
16 .\" GNU General Public License for more details. | |
17 .\" | |
18 .\" You should have received a copy of the GNU General Public | |
19 .\" License along with this manual; if not, write to the Free | |
20 .\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, | |
21 .\" USA. | |
22 .TH gaim-text 1 | |
23 .SH NAME | |
14788
4b20371086f0
[gaim-migrate @ 17552]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14585
diff
changeset
|
24 Gaim-Text \- A Pimpin' Penguin console frontend for Instant Messaging client Gaim. |
14585 | 25 .SH SYNOPSIS |
26 .TP 5 | |
27 \fBgaim-text \fI[options]\fR | |
28 | |
29 .SH DESCRIPTION | |
30 .PP | |
31 \fBgaim-text\fR is a console-based modular messaging client capable of using | |
32 AIM, MSN, Yahoo!, Jabber, ICQ, IRC, SILC, Novell GroupWise, Lotus Sametime, | |
33 Zephyr, Gadu-Gadu, and QQ all at once. It has many common features found in | |
34 other clients, as well as many unique features. Gaim is not endorsed by or | |
35 affiliated with America Online, ICQ, Microsoft, or Yahoo. | |
36 | |
37 .SH OPTIONS | |
38 The following options are provided by \fBgaim-text\fR using the standard GNU | |
39 command line syntax: | |
40 .TP | |
41 .B \-d, \-\-debug | |
42 Print debugging messages to stderr and start with the \fBDebug\fR window. The | |
43 messages shown in the \fBDebug\fR window are the same as the ones printed in | |
44 stderr. | |
45 .TP | |
46 .B \-c, \-\-config=\fIDIR\fB | |
47 Use \fIDIR\fR as the directory for config files instead of \fI~/.gaim\fR. | |
48 .TP | |
49 .B \-h, \-\-help | |
50 Print this help and exit. | |
51 .TP | |
52 .B \-n, \-\-nologin | |
53 Don't automatically login when \fBgaim-text\fR starts. Sets all accounts to | |
54 Offline. | |
55 .TP | |
56 .B \-v, \-\-version | |
57 Display the version information window. | |
58 | |
59 .SH GNT Shortcuts | |
60 You can use the following shortcuts: | |
61 .TP | |
14830
9ee68ce424ec
[gaim-migrate @ 17597]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14793
diff
changeset
|
62 .B Alt \+ a |
9ee68ce424ec
[gaim-migrate @ 17597]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14793
diff
changeset
|
63 Bring up a list of available actions. You can use this list to access the |
9ee68ce424ec
[gaim-migrate @ 17597]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14793
diff
changeset
|
64 accounts window, plugins window, preference window etc. |
9ee68ce424ec
[gaim-migrate @ 17597]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14793
diff
changeset
|
65 .TP |
14585 | 66 .B Alt \+ n |
67 Go to the next window. | |
68 .TP | |
69 .B Alt \+ p | |
70 Go to the previous window. | |
71 .TP | |
72 .B Alt \+ w | |
73 Show the list of windows. You can select and jump to any window from the list. | |
74 .TP | |
75 .B Alt \+ c | |
76 Close the current window. | |
77 .TP | |
78 .B Alt \+ q | |
79 Quit. | |
80 .TP | |
81 .B Alt \+ m | |
82 Start moving a window. Press the cursor keys to move the window. When you are | |
83 done, press \fBEnter\fR or \fBEscape\fR. | |
84 .TP | |
85 .B Alt \+ r | |
86 Start resizing a window. Press the cursor keys to resize the window. When you | |
87 are done, press \fBEnter\fR or \fBEscape\fR. | |
88 .TP | |
89 .B Alt \+ d | |
90 Dump the contents of the screen in HTML format in a file named "dump.html" in | |
91 working directory. | |
92 .TP | |
93 .B Alt \+ . | |
94 Move the position of the current window in the window list one place to the | |
95 right. | |
96 .TP | |
97 .B Alt \+ , | |
98 Move the position of the current window in the window list one place to the | |
99 left. | |
100 .TP | |
101 .B Alt \+ l | |
102 Refresh the windows. This is useful after resizing the terminal window. | |
103 .TP | |
104 .B Alt \+ 1 2 ... 0 | |
105 Jump to the 1st, 2nd ... 10th window. | |
14830
9ee68ce424ec
[gaim-migrate @ 17597]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14793
diff
changeset
|
106 .TP |
9ee68ce424ec
[gaim-migrate @ 17597]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14793
diff
changeset
|
107 .B Ctrl \+ o |
9ee68ce424ec
[gaim-migrate @ 17597]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14793
diff
changeset
|
108 Bring up the menu (if there is one) for a window. Note that currently only the |
9ee68ce424ec
[gaim-migrate @ 17597]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14793
diff
changeset
|
109 buddylist has a menu. |
14585 | 110 |
111 .SH FILES | |
112 \fI~/.gntrc\fR: configuration file for gnt applications. | |
113 .br | |
114 .TP | |
115 A sample file looks like: | |
116 .br | |
117 [general] | |
118 .br | |
119 shadow = 0 | |
120 .br | |
121 # There is experimental mouse support | |
122 .br | |
123 mouse = 1 | |
124 .br | |
125 # To use some custom window-manager | |
126 .br | |
127 wm = /usr/local/lib/gaim/s.so | |
128 .br | |
129 | |
130 .br | |
131 [colors] | |
132 .br | |
133 # The RGB values range in [0, 1000] | |
134 .br | |
135 black = 0; 0; 0 | |
136 .br | |
137 red = 1000; 0; 0 | |
138 .br | |
139 green = 0; 1000; 0 | |
140 .br | |
141 blue = 250; 250; 700 | |
142 .br | |
143 white = 1000; 1000; 1000 | |
144 .br | |
145 gray = 700; 700; 700 | |
146 .br | |
147 darkgray = 256; 256; 256 | |
148 .br | |
149 | |
150 .br | |
151 [colorpairs] | |
152 .br | |
153 normal = white; black | |
154 .br | |
155 highlight = white; blue | |
156 .br | |
157 highlightd = black; gray | |
158 .br | |
159 shadow = black; darkgray | |
160 .br | |
161 title = white; blue | |
162 .br | |
163 titled = white; gray | |
164 .br | |
165 text = white; blue | |
166 .br | |
167 disabled = gray; black | |
168 .br | |
14831
9cf3263c3f2f
[gaim-migrate @ 17598]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14830
diff
changeset
|
169 urgent = green; black |
9cf3263c3f2f
[gaim-migrate @ 17598]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14830
diff
changeset
|
170 .br |
14585 | 171 |
172 .br | |
173 # Remap some keys for GntEntry | |
174 .br | |
175 [GntEntry::remap] | |
176 .br | |
177 # Remap the up-arrow to the left-arrow | |
178 .br | |
179 ^[[A = ^[[D | |
180 .br | |
181 # Remap the down-arrow to the right-arrow | |
182 .br | |
183 ^[[B = ^[[C | |
184 .br | |
185 # Remap 'a' to 'bcd' | |
186 .br | |
187 a = bcd | |
188 .br | |
189 # Completely ignore the key 'q' | |
190 .br | |
191 q = | |
192 .br | |
193 # But the following will NOT work | |
194 .br | |
195 #abc = bcd | |
196 .br | |
197 | |
198 # Hitting 'space' will activate a button | |
199 .br | |
200 [GntButton::remap] | |
201 .br | |
202 \\ = \\r | |
203 .br | |
204 | |
14793
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
205 .SH Widget Actions |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
206 You can specifiy key-bindings for specific widgets. The following entries in |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
207 \fI~/.gntrc\fR correspond to the default keybindings for the actions: |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
208 |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
209 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
210 [GntEntry::binding] |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
211 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
212 c-a = cursor-home |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
213 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
214 home = cursor-home |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
215 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
216 c-e = cursor-end |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
217 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
218 end = cursor-end |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
219 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
220 backspace = delete-prev |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
221 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
222 del = delete-next |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
223 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
224 c-d = delete-next |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
225 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
226 c-u = delete-start |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
227 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
228 c-k = delete-end |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
229 .br |
14987 | 230 c-b = cursor-prev |
231 .br | |
14793
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
232 left = cursor-prev |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
233 .br |
14987 | 234 c-f = cursor-next |
235 .br | |
14793
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
236 right = cursor-next |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
237 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
238 tab = suggest-show |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
239 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
240 down = suggest-next |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
241 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
242 up = suggest-prev |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
243 .br |
14830
9ee68ce424ec
[gaim-migrate @ 17597]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14793
diff
changeset
|
244 # The following actions don't have any default binding: |
9ee68ce424ec
[gaim-migrate @ 17597]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14793
diff
changeset
|
245 .br |
9ee68ce424ec
[gaim-migrate @ 17597]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14793
diff
changeset
|
246 # delete-prev-word |
9ee68ce424ec
[gaim-migrate @ 17597]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14793
diff
changeset
|
247 .br |
9ee68ce424ec
[gaim-migrate @ 17597]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14793
diff
changeset
|
248 # cursor-prev-word |
14793
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
249 |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
250 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
251 [GntTree::binding] |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
252 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
253 up = move-up |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
254 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
255 down = move-down |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
256 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
257 c-n = move-down |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
258 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
259 c-p = move-up |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
260 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
261 pageup = page-up |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
262 .br |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
263 pagedown = page-down |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
264 .br |
14973
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
265 # The following will let you open the context-menu in the buddylist with c-b |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
266 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
267 c-b = context-menu |
14979
f719225f988e
[gaim-migrate @ 17757]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14973
diff
changeset
|
268 .br |
f719225f988e
[gaim-migrate @ 17757]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14973
diff
changeset
|
269 |
15017
6e7184096615
[gaim-migrate @ 17798]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14987
diff
changeset
|
270 .br |
6e7184096615
[gaim-migrate @ 17798]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14987
diff
changeset
|
271 [GntWidget::binding] |
6e7184096615
[gaim-migrate @ 17798]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14987
diff
changeset
|
272 .br |
6e7184096615
[gaim-migrate @ 17798]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14987
diff
changeset
|
273 f11 = context-menu |
6e7184096615
[gaim-migrate @ 17798]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14987
diff
changeset
|
274 |
14979
f719225f988e
[gaim-migrate @ 17757]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14973
diff
changeset
|
275 [GntWindow::binding] |
f719225f988e
[gaim-migrate @ 17757]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14973
diff
changeset
|
276 .br |
f719225f988e
[gaim-migrate @ 17757]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14973
diff
changeset
|
277 c-o = show-menu |
15017
6e7184096615
[gaim-migrate @ 17798]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14987
diff
changeset
|
278 .br |
6e7184096615
[gaim-migrate @ 17798]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14987
diff
changeset
|
279 f10 = show-menu |
14793
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
280 |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
281 The \fBc-\fR corresponds to the \fBControl\fR key. You can also use \fBctrl-\fR |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
282 or \fBctr-\fR or \fBctl-\fR to indicate a combination. For alt-keys, you can use |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
283 one of \fBa-\fR, \fBalt-\fR, \fBm-\fR or \fBmeta-\fR. You can also use |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
284 \fBhome\fR, \fBend\fR, \fBleft\fR, \fBright\fR etc. keys. |
8a0cfee11af8
[gaim-migrate @ 17558]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14788
diff
changeset
|
285 |
14585 | 286 .SH Mouse Support |
287 There is experimental mouse support. You can focus windows, activate buttons, | |
288 select rows in a list, scroll using the wheel-scroll etc. Mouse support is | |
14973
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
289 disabled by default, so you need to enable it in \fI~/.gntrc\fR (see the sample |
14585 | 290 above). |
291 | |
292 .SH Window Management | |
293 The default window management is very limited. But it is possible to write | |
294 custom window managers to suit your needs. There is a sample window-manager | |
295 included (named \fIs.so\fR) which adds a little 'close-button' for the windows, | |
296 removes the borders from the buddylist and pops up new windows in the middle of | |
297 the screen, instead of at the upper-left corder. It is provided as a sample | |
298 simple manager, but it should be possible to write more complex managers, and | |
299 it's very possible that the window-manager API will need to be enhanced. Look at | |
14973
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
300 the sample \fI~/.gntrc\fR file above to see how to select a window-manager. |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
301 |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
302 It is also possible to rebind the window-manager actions in \fI~/.gntrc\fR, eg: |
14585 | 303 |
14973
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
304 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
305 [GntWM::binding] |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
306 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
307 a-n = window-next |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
308 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
309 a-p = window-prev |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
310 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
311 a-c = window-close |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
312 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
313 a-w = window-list |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
314 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
315 a-d = dump-screen |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
316 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
317 a-, = shift-left |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
318 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
319 a-. = shift-right |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
320 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
321 a-a = action-list |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
322 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
323 a-m = start-move |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
324 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
325 a-r = start-resize |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
326 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
327 a-q = wm-quit |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
328 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
329 a-l = refresh-screen |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
330 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
331 # The following action is still incomplete, and doesn't have a default binding |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
332 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
333 # switch-window-n |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
334 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
335 |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
336 # For the sample custom window manager |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
337 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
338 [GntS::binding] |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
339 .br |
cfb736e4a2c4
[gaim-migrate @ 17751]
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
14831
diff
changeset
|
340 c-t = toggle-buddylist |
14585 | 341 |
342 .SH Conversation Commands | |
343 There are a few helpful commands in addition to the regular commands. You can | |
344 use these from any conversation to access other windows. | |
345 | |
346 .TP | |
347 .B accounts | |
348 for the accounts window. | |
349 | |
350 .TP | |
351 .B buddylist | |
352 for the buddylist. | |
353 | |
354 .TP | |
355 .B debugwin | |
356 for the debug window. | |
357 | |
358 .TP | |
359 .B plugins | |
360 for the plugins window. | |
361 | |
362 .TP | |
363 .B prefs | |
364 for the preferences window. | |
365 | |
366 .TP | |
367 .B status | |
368 for the status window. | |
369 | |
370 .SH BUGS | |
371 Known bugs are listed at | |
372 .br | |
373 \fIhttp://sourceforge.net/tracker/?group_id=235&atid=100235\fR | |
374 | |
375 .SH PATCHES | |
376 If you fix a bug in \fBgaim-text\fR (or otherwise enhance it), please submit a | |
377 patch (using \fIsvn diff > my.diff\fR against the latest SVN version) | |
378 at | |
379 .br | |
380 \fIhttp://sourceforge.net/tracker/?func=add&group_id=235&atid=300235\fR | |
381 | |
382 Before sending a bug report, please verify that you have the latest | |
383 version of \fBgaim-text\fR and \fBlibgaim\fR. Many bugs (major and minor) are | |
384 fixed at each release, and if yours is out of date, the problem may already have | |
385 been solved. | |
386 | |
387 You are also encouraged to drop by at \fB#gaim\fR on \fIirc.freenode.net\fR to | |
388 discuss about development. | |
389 | |
390 .SH SEE ALSO | |
391 \fIhttp://gaim.sourceforge.net/\fR | |
392 .br | |
393 \fIhttp://www.sourceforge.net/projects/gaim/\fR | |
394 | |
395 .SH LICENSE | |
396 This program is free software; you can redistribute it and/or modify | |
397 it under the terms of the GNU General Public License as published by | |
398 the Free Software Foundation; either version 2 of the License, or | |
399 (at your option) any later version. | |
400 | |
401 This program is distributed in the hope that it will be useful, but | |
402 \fBWITHOUT ANY WARRANTY\fR; without even the implied warranty of | |
403 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
404 General Public License for more details. | |
405 | |
406 You should have received a copy of the GNU General Public License | |
407 along with this program; if not, write to the Free Software | |
408 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA | |
409 | |
410 .SH AUTHORS | |
411 Sadrul Habib Chowdhury <\fIsadrul@users.sourceforge.net\fR> | |
412 .br | |
413 | |
414 This manpage was written by Sadrul Habib Chowdhury | |
415 <\fIsadrul@users.sourceforge.net\fR> and Dennis Ristuccia | |
416 <\fIdennis@dennisr.net\fR>. | |
417 |