Mercurial > pidgin.yaz
annotate doc/finch.1.in @ 26262:b03430dae08e
Add xmlnode_set_attrib_full that enables you to set an attribute with both
a prefix and a namespace. Also, change xmlnode_remove_attribute to remove
all existing attributes that match the name. Otherwise, it would just take
out the first one, and may not do what you want.
Change Bonjour and XMPP to use the new function.
References #7681.
Fixes #8318.
author | Elliott Sales de Andrade <qulogic@pidgin.im> |
---|---|
date | Fri, 13 Mar 2009 04:29:11 +0000 |
parents | 4cd46791d3a8 |
children | 35bbc8160513 |
rev | line source |
---|---|
15845 | 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 finch 1 | |
23 .SH NAME | |
24 Finch \- A Pimpin' Penguin console frontend to libpurple. Instant | |
25 Messaging client. | |
26 .SH SYNOPSIS | |
27 .TP 5 | |
28 \fBfinch \fI[options]\fR | |
29 | |
30 .SH DESCRIPTION | |
31 .PP | |
16976
6b516b7eebc5
Pimp libpurple, based on a suggestion from James Lockie. This okay?
Richard Laager <rlaager@wiktel.com>
parents:
16915
diff
changeset
|
32 \fBfinch\fR is a console-based modular messaging client based on libpurple |
6b516b7eebc5
Pimp libpurple, based on a suggestion from James Lockie. This okay?
Richard Laager <rlaager@wiktel.com>
parents:
16915
diff
changeset
|
33 which is capable of connecting to AIM, MSN, Yahoo!, XMPP, ICQ, IRC, SILC, |
6b516b7eebc5
Pimp libpurple, based on a suggestion from James Lockie. This okay?
Richard Laager <rlaager@wiktel.com>
parents:
16915
diff
changeset
|
34 Novell GroupWise, Lotus Sametime, Zephyr, Gadu-Gadu, and QQ all at once. It has |
6b516b7eebc5
Pimp libpurple, based on a suggestion from James Lockie. This okay?
Richard Laager <rlaager@wiktel.com>
parents:
16915
diff
changeset
|
35 many common features found in other clients, as well as many unique features. |
6b516b7eebc5
Pimp libpurple, based on a suggestion from James Lockie. This okay?
Richard Laager <rlaager@wiktel.com>
parents:
16915
diff
changeset
|
36 Finch is not endorsed by or affiliated with America Online, ICQ, Microsoft, or |
6b516b7eebc5
Pimp libpurple, based on a suggestion from James Lockie. This okay?
Richard Laager <rlaager@wiktel.com>
parents:
16915
diff
changeset
|
37 Yahoo. |
15845 | 38 |
39 .SH OPTIONS | |
40 The following options are provided by \fBfinch\fR using the standard GNU | |
41 command line syntax: | |
42 .TP | |
43 .B \-d, \-\-debug | |
44 Print debugging messages to stderr and start with the \fBDebug\fR window. The | |
45 messages shown in the \fBDebug\fR window are the same as the ones printed in | |
46 stderr. | |
47 .TP | |
48 .B \-c, \-\-config=\fIDIR\fB | |
16197
30557aad1951
Update some paths in the man pages.
Richard Laager <rlaager@wiktel.com>
parents:
15845
diff
changeset
|
49 Use \fIDIR\fR as the directory for config files instead of \fI~/.purple\fR. |
15845 | 50 .TP |
51 .B \-h, \-\-help | |
52 Print this help and exit. | |
53 .TP | |
54 .B \-n, \-\-nologin | |
55 Don't automatically login when \fBfinch\fR starts. Sets all accounts to | |
56 Offline. | |
57 .TP | |
58 .B \-v, \-\-version | |
59 Display the version information window. | |
60 | |
61 .SH GNT Shortcuts | |
62 You can use the following shortcuts: | |
63 .TP | |
64 .B Alt \+ a | |
65 Bring up a list of available actions. You can use this list to access the | |
66 accounts window, plugins window, preference window etc. | |
67 .TP | |
68 .B Alt \+ n | |
69 Go to the next window. | |
70 .TP | |
71 .B Alt \+ p | |
72 Go to the previous window. | |
73 .TP | |
74 .B Alt \+ w | |
75 Show the list of windows. You can select and jump to any window from the list. | |
76 .TP | |
77 .B Alt \+ c | |
78 Close the current window. | |
79 .TP | |
80 .B Alt \+ q | |
81 Quit. | |
82 .TP | |
83 .B Alt \+ m | |
84 Start moving a window. Press the cursor keys to move the window. When you are | |
85 done, press \fBEnter\fR or \fBEscape\fR. | |
86 .TP | |
87 .B Alt \+ r | |
88 Start resizing a window. Press the cursor keys to resize the window. When you | |
89 are done, press \fBEnter\fR or \fBEscape\fR. | |
90 .TP | |
21682 | 91 .B Alt \+ D |
92 Dump the contents of the screen in HTML format. | |
15845 | 93 .TP |
94 .B Alt \+ . | |
95 Move the position of the current window in the window list one place to the | |
96 right. | |
97 .TP | |
98 .B Alt \+ , | |
99 Move the position of the current window in the window list one place to the | |
100 left. | |
101 .TP | |
102 .B Alt \+ l | |
103 Refresh the windows. This is useful after resizing the terminal window. | |
104 .TP | |
105 .B Alt \+ 1 2 ... 0 | |
106 Jump to the 1st, 2nd ... 10th window. | |
107 .TP | |
21976
a86c035be695
New actions: window-next-urgent (alt+tab), and window-prev-urgent (alt+shift+tab).
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21744
diff
changeset
|
108 .B Alt \+ Tab |
a86c035be695
New actions: window-next-urgent (alt+tab), and window-prev-urgent (alt+shift+tab).
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21744
diff
changeset
|
109 Jump to the next URGENT (highlighted) window. |
a86c035be695
New actions: window-next-urgent (alt+tab), and window-prev-urgent (alt+shift+tab).
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21744
diff
changeset
|
110 .TP |
a86c035be695
New actions: window-next-urgent (alt+tab), and window-prev-urgent (alt+shift+tab).
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21744
diff
changeset
|
111 .B Alt \+ Shift \+ Tab |
a86c035be695
New actions: window-next-urgent (alt+tab), and window-prev-urgent (alt+shift+tab).
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21744
diff
changeset
|
112 Jump to the previous URGENT (highlighted) window. |
a86c035be695
New actions: window-next-urgent (alt+tab), and window-prev-urgent (alt+shift+tab).
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21744
diff
changeset
|
113 .TP |
22747
5b8dbe4b9898
Update the manpage about F10 and F11.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21976
diff
changeset
|
114 .B Ctrl \+ o \fR or \fB F10 |
21682 | 115 Bring up the menu (if there is one) for a window. |
17076 | 116 .TP |
22747
5b8dbe4b9898
Update the manpage about F10 and F11.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21976
diff
changeset
|
117 .B F11 |
5b8dbe4b9898
Update the manpage about F10 and F11.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21976
diff
changeset
|
118 Popup the context menu (if there is one) for the selected widget. |
5b8dbe4b9898
Update the manpage about F10 and F11.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21976
diff
changeset
|
119 .TP |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
120 .B Alt \+ / |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
121 Show a list of available key-bindings for the current widget in focus. |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
122 .TP |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
123 .B Alt \+ \> |
17076 | 124 Switch to the next workspace |
125 .TP | |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
126 .B Alt \+ \< |
17076 | 127 Switch to the previous workspace |
128 .TP | |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
129 .B Alt \+ t |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
130 Tag (or untag) the current window |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
131 .TP |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
132 .B Alt \+ T |
21291
13cc55dff880
A grammar fix for finch(1).
Will Thompson <will.thompson@collabora.co.uk>
parents:
21251
diff
changeset
|
133 Attached all the tagged windows to the current workspace |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
134 .TP |
17076 | 135 .B Alt \+ s |
136 Show the workspace list | |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
137 .TP |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
138 .B F9 |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
139 Create a new workspace and switch to it |
15845 | 140 |
141 .SH FILES | |
142 \fI~/.gntrc\fR: configuration file for gnt applications. | |
143 .br | |
144 .TP | |
145 A sample file looks like: | |
146 .br | |
21691
3ed9b027479d
Add support for colour in gnttreerows, and colourise the blist. Fixes #1490
Richard Nelson <wabz@pidgin.im>
parents:
21682
diff
changeset
|
147 [Finch] |
3ed9b027479d
Add support for colour in gnttreerows, and colourise the blist. Fixes #1490
Richard Nelson <wabz@pidgin.im>
parents:
21682
diff
changeset
|
148 .br |
21694
2de3a2de5f13
Update the changelogs. Correct the man page. Allow 'default' to mean the
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21691
diff
changeset
|
149 color-available = green; black |
21691
3ed9b027479d
Add support for colour in gnttreerows, and colourise the blist. Fixes #1490
Richard Nelson <wabz@pidgin.im>
parents:
21682
diff
changeset
|
150 .br |
21694
2de3a2de5f13
Update the changelogs. Correct the man page. Allow 'default' to mean the
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21691
diff
changeset
|
151 color-away = blue; black |
21691
3ed9b027479d
Add support for colour in gnttreerows, and colourise the blist. Fixes #1490
Richard Nelson <wabz@pidgin.im>
parents:
21682
diff
changeset
|
152 .br |
21694
2de3a2de5f13
Update the changelogs. Correct the man page. Allow 'default' to mean the
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21691
diff
changeset
|
153 color-idle = gray; black |
21691
3ed9b027479d
Add support for colour in gnttreerows, and colourise the blist. Fixes #1490
Richard Nelson <wabz@pidgin.im>
parents:
21682
diff
changeset
|
154 .br |
21694
2de3a2de5f13
Update the changelogs. Correct the man page. Allow 'default' to mean the
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21691
diff
changeset
|
155 color-offline = red; black |
21691
3ed9b027479d
Add support for colour in gnttreerows, and colourise the blist. Fixes #1490
Richard Nelson <wabz@pidgin.im>
parents:
21682
diff
changeset
|
156 .br |
21738
e3e64d1e4869
Add color to the conversation window to indicate various message attributes
Richard Nelson <wabz@pidgin.im>
parents:
21694
diff
changeset
|
157 color-message-sent = cyan; default |
e3e64d1e4869
Add color to the conversation window to indicate various message attributes
Richard Nelson <wabz@pidgin.im>
parents:
21694
diff
changeset
|
158 .br |
e3e64d1e4869
Add color to the conversation window to indicate various message attributes
Richard Nelson <wabz@pidgin.im>
parents:
21694
diff
changeset
|
159 color-message-received = red; default |
e3e64d1e4869
Add color to the conversation window to indicate various message attributes
Richard Nelson <wabz@pidgin.im>
parents:
21694
diff
changeset
|
160 .br |
e3e64d1e4869
Add color to the conversation window to indicate various message attributes
Richard Nelson <wabz@pidgin.im>
parents:
21694
diff
changeset
|
161 color-message-highlight = black; green |
e3e64d1e4869
Add color to the conversation window to indicate various message attributes
Richard Nelson <wabz@pidgin.im>
parents:
21694
diff
changeset
|
162 .br |
e3e64d1e4869
Add color to the conversation window to indicate various message attributes
Richard Nelson <wabz@pidgin.im>
parents:
21694
diff
changeset
|
163 color-message-action = yellow; default |
e3e64d1e4869
Add color to the conversation window to indicate various message attributes
Richard Nelson <wabz@pidgin.im>
parents:
21694
diff
changeset
|
164 .br |
e3e64d1e4869
Add color to the conversation window to indicate various message attributes
Richard Nelson <wabz@pidgin.im>
parents:
21694
diff
changeset
|
165 color-timestamp = blue; default |
e3e64d1e4869
Add color to the conversation window to indicate various message attributes
Richard Nelson <wabz@pidgin.im>
parents:
21694
diff
changeset
|
166 .br |
21691
3ed9b027479d
Add support for colour in gnttreerows, and colourise the blist. Fixes #1490
Richard Nelson <wabz@pidgin.im>
parents:
21682
diff
changeset
|
167 #See below for details on color |
3ed9b027479d
Add support for colour in gnttreerows, and colourise the blist. Fixes #1490
Richard Nelson <wabz@pidgin.im>
parents:
21682
diff
changeset
|
168 .br |
21744 | 169 |
15845 | 170 [general] |
171 .br | |
172 shadow = 0 | |
173 .br | |
174 # There is experimental mouse support | |
175 .br | |
176 mouse = 1 | |
177 .br | |
178 # To use some custom window-manager | |
179 .br | |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
180 wm = /usr/local/lib/gnt/s.so |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
181 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
182 # There's also a custom window manager called irssi.so |
15845 | 183 .br |
184 # Remember window-positions based on the titles (on by default) | |
185 .br | |
186 remember_position = 1 | |
187 .br | |
18508
902685705e4e
Update the man about small buttons.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
18381
diff
changeset
|
188 # Use borderless one-line high buttons |
902685705e4e
Update the man about small buttons.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
18381
diff
changeset
|
189 .br |
902685705e4e
Update the man about small buttons.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
18381
diff
changeset
|
190 small-button = true |
15845 | 191 |
192 .br | |
17076 | 193 # Workspaces are created simply by adding Workspace-X groups as follows: |
194 .br | |
195 [Workspace-1] | |
196 .br | |
197 name = blist | |
198 .br | |
199 # window-names specifies that windows with these semi-colon separated names are placed | |
200 into this workspace | |
201 .br | |
202 window-names = buddylist;debug-window | |
203 .br | |
204 | |
205 .br | |
206 [Workspace-2] | |
207 .br | |
208 name = IM | |
209 .br | |
210 window-names = conversation-window | |
211 .br | |
212 # window-titles specifies that windows with these semi-colon separated titles are placed | |
213 into this workspace. These are matched as substrings. Window titles take precedence over | |
214 names. | |
215 .br | |
216 window-titles = Preferences;Pounce | |
217 .br | |
218 | |
219 .br | |
15845 | 220 [colors] |
221 .br | |
222 # The RGB values range in [0, 1000] | |
223 .br | |
224 black = 0; 0; 0 | |
225 .br | |
226 red = 1000; 0; 0 | |
227 .br | |
228 green = 0; 1000; 0 | |
229 .br | |
230 blue = 250; 250; 700 | |
231 .br | |
232 white = 1000; 1000; 1000 | |
233 .br | |
234 gray = 700; 700; 700 | |
235 .br | |
236 darkgray = 256; 256; 256 | |
237 .br | |
238 | |
239 .br | |
240 [colorpairs] | |
241 .br | |
242 normal = white; black | |
243 .br | |
244 highlight = white; blue | |
245 .br | |
246 highlightd = black; gray | |
247 .br | |
248 shadow = black; darkgray | |
249 .br | |
250 title = white; blue | |
251 .br | |
252 titled = white; gray | |
253 .br | |
254 text = white; blue | |
255 .br | |
256 disabled = gray; black | |
257 .br | |
258 urgent = green; black | |
259 .br | |
260 | |
261 .br | |
262 # Remap some keys for GntEntry | |
263 .br | |
264 [GntEntry::remap] | |
265 .br | |
266 # Remap the up-arrow to the left-arrow | |
267 .br | |
268 ^[[A = ^[[D | |
269 .br | |
270 # Remap the down-arrow to the right-arrow | |
271 .br | |
272 ^[[B = ^[[C | |
273 .br | |
274 # Remap 'a' to 'bcd' | |
275 .br | |
276 a = bcd | |
277 .br | |
278 # Completely ignore the key 'q' | |
279 .br | |
280 q = | |
281 .br | |
282 # But the following will NOT work | |
283 .br | |
284 #abc = bcd | |
285 .br | |
286 | |
287 # Hitting 'space' will activate a button | |
288 .br | |
289 [GntButton::remap] | |
290 .br | |
291 \\ = \\r | |
292 .br | |
293 | |
294 .SH Widget Actions | |
295 You can specifiy key-bindings for specific widgets. The following entries in | |
296 \fI~/.gntrc\fR correspond to the default keybindings for the actions: | |
297 | |
298 .br | |
24958
73e88188a7d4
Allow rebinding keys to change the focused widget.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
22940
diff
changeset
|
299 [GntBox::binding] |
73e88188a7d4
Allow rebinding keys to change the focused widget.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
22940
diff
changeset
|
300 .br |
73e88188a7d4
Allow rebinding keys to change the focused widget.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
22940
diff
changeset
|
301 tab = focus-next |
73e88188a7d4
Allow rebinding keys to change the focused widget.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
22940
diff
changeset
|
302 .br |
73e88188a7d4
Allow rebinding keys to change the focused widget.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
22940
diff
changeset
|
303 right = focus-next |
73e88188a7d4
Allow rebinding keys to change the focused widget.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
22940
diff
changeset
|
304 .br |
73e88188a7d4
Allow rebinding keys to change the focused widget.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
22940
diff
changeset
|
305 left = focus-prev |
73e88188a7d4
Allow rebinding keys to change the focused widget.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
22940
diff
changeset
|
306 |
73e88188a7d4
Allow rebinding keys to change the focused widget.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
22940
diff
changeset
|
307 .br |
15845 | 308 [GntEntry::binding] |
309 .br | |
310 c-a = cursor-home | |
311 .br | |
312 home = cursor-home | |
313 .br | |
314 c-e = cursor-end | |
315 .br | |
316 end = cursor-end | |
317 .br | |
318 backspace = delete-prev | |
319 .br | |
320 del = delete-next | |
321 .br | |
322 c-d = delete-next | |
323 .br | |
324 c-u = delete-start | |
325 .br | |
326 c-k = delete-end | |
327 .br | |
328 c-b = cursor-prev | |
329 .br | |
330 left = cursor-prev | |
331 .br | |
332 c-f = cursor-next | |
333 .br | |
334 right = cursor-next | |
335 .br | |
336 tab = suggest-show | |
337 .br | |
338 down = suggest-next | |
339 .br | |
340 up = suggest-prev | |
341 .br | |
342 c-w = delete-prev-word | |
343 .br | |
344 a-b = cursor-prev-word | |
345 .br | |
346 a-f = cursor-next-word | |
347 .br | |
348 a-d = delete-next-word | |
349 .br | |
350 c-v = clipboard-paste | |
351 | |
352 .br | |
353 [GntTree::binding] | |
354 .br | |
355 up = move-up | |
356 .br | |
357 down = move-down | |
358 .br | |
359 c-n = move-down | |
360 .br | |
361 c-p = move-up | |
362 .br | |
363 pageup = page-up | |
364 .br | |
365 pagedown = page-down | |
366 .br | |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
367 backspace = move-parent |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
368 .br |
15845 | 369 # Following is the default binding for the context-menu |
370 .br | |
371 menu = context-menu | |
372 .br | |
373 # The following will let you open the context-menu in the buddylist with c-b | |
374 .br | |
375 # c-b = context-menu | |
376 | |
377 .br | |
378 [GntWidget::binding] | |
379 .br | |
380 f11 = context-menu | |
381 | |
382 [GntWindow::binding] | |
383 .br | |
384 c-o = show-menu | |
385 .br | |
386 f10 = show-menu | |
387 | |
388 The \fBc-\fR corresponds to the \fBControl\fR key. You can also use \fBctrl-\fR | |
389 or \fBctr-\fR or \fBctl-\fR to indicate a combination. For alt-keys, you can use | |
390 one of \fBa-\fR, \fBalt-\fR, \fBm-\fR or \fBmeta-\fR. You can also use | |
391 \fBhome\fR, \fBend\fR, \fBleft\fR, \fBright\fR etc. keys. | |
392 | |
22940
9809516e0032
Add key unbinding to the finch man page
Ethan Blanton <elb@pidgin.im>
parents:
22747
diff
changeset
|
393 To unbind a key which has a default binding, you simply bind it to the empty string. For example, to unbind \fBAlt + q\fR from the Quit function, you would use: |
9809516e0032
Add key unbinding to the finch man page
Ethan Blanton <elb@pidgin.im>
parents:
22747
diff
changeset
|
394 |
9809516e0032
Add key unbinding to the finch man page
Ethan Blanton <elb@pidgin.im>
parents:
22747
diff
changeset
|
395 [GntWM::binding] |
9809516e0032
Add key unbinding to the finch man page
Ethan Blanton <elb@pidgin.im>
parents:
22747
diff
changeset
|
396 .br |
9809516e0032
Add key unbinding to the finch man page
Ethan Blanton <elb@pidgin.im>
parents:
22747
diff
changeset
|
397 a-q = |
9809516e0032
Add key unbinding to the finch man page
Ethan Blanton <elb@pidgin.im>
parents:
22747
diff
changeset
|
398 |
21251
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
399 .SH Menus |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
400 You can also specify key-bindings to trigger specific menuitems in windows. For example, the following entry in \fI~/.gntrc\fR will bind \fBCtrl + t\fR to the 'Send IM...' item in the buddylist: |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
401 |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
402 [buddylist::menu] |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
403 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
404 c-t = send-im |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
405 |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
406 The following is the list of IDs of the current menuitems in the buddylist: |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
407 |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
408 send-im |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
409 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
410 join-chat |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
411 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
412 show-empty-groups |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
413 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
414 show-offline-buddies |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
415 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
416 sort-status |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
417 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
418 sort-alpha |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
419 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
420 sort-log |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
421 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
422 add-buddy |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
423 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
424 add-chat |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
425 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
426 add-group |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
427 |
15845 | 428 .SH Mouse Support |
429 There is experimental mouse support. You can focus windows, activate buttons, | |
430 select rows in a list, scroll using the wheel-scroll etc. Selecting text in a | |
431 text-view copies it to the gnt clipboard. Mouse support is disabled by default, | |
432 so you need to enable it in \fI~/.gntrc\fR (see the sample above). | |
433 | |
434 .SH Window Management | |
435 The default window management is very limited. But it is possible to write | |
436 custom window managers to suit your needs. There is a sample window-manager | |
437 included (named \fIs.so\fR) which adds a little 'close-button' for the windows, | |
438 removes the borders from the buddylist and pops up new windows in the middle of | |
439 the screen, instead of at the upper-left corder. It is provided as a sample | |
440 simple manager, but it should be possible to write more complex managers, and | |
441 it's very possible that the window-manager API will need to be enhanced. Look at | |
442 the sample \fI~/.gntrc\fR file above to see how to select a window-manager. | |
443 | |
444 It is also possible to rebind the window-manager actions in \fI~/.gntrc\fR, eg: | |
445 | |
446 .br | |
447 [GntWM::binding] | |
448 .br | |
449 a-n = window-next | |
450 .br | |
451 a-p = window-prev | |
452 .br | |
453 a-c = window-close | |
454 .br | |
455 a-w = window-list | |
456 .br | |
457 a-d = dump-screen | |
458 .br | |
459 a-, = shift-left | |
460 .br | |
461 a-. = shift-right | |
462 .br | |
463 a-a = action-list | |
464 .br | |
465 a-m = start-move | |
466 .br | |
467 a-r = start-resize | |
468 .br | |
469 a-q = wm-quit | |
470 .br | |
471 a-l = refresh-screen | |
472 .br | |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
473 a-s = workspace-list |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
474 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
475 a-t = window-tag |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
476 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
477 a-T = place-tagged |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
478 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
479 a-C = toggle-clipboard |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
480 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
481 a-/ = help-for-widget |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
482 .br |
15845 | 483 # The following action is still incomplete, and doesn't have a default binding |
484 .br | |
485 # switch-window-n | |
486 .br | |
21976
a86c035be695
New actions: window-next-urgent (alt+tab), and window-prev-urgent (alt+shift+tab).
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
21744
diff
changeset
|
487 # Other actions: window-next-urgent, window-prev-urgent |
15845 | 488 |
489 # For the sample custom window manager | |
490 .br | |
491 [GntS::binding] | |
492 .br | |
493 a-b = toggle-buddylist | |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
494 |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
495 # For the irssi window manager |
15845 | 496 .br |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
497 [Irssi::binding] |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
498 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
499 a-L = move-right |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
500 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
501 a-H = move-left |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
502 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
503 a-J = move-down |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
504 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
505 a-K = move-up |
15845 | 506 |
507 .SH Conversation Commands | |
508 There are a few helpful commands in addition to the regular commands. You can | |
509 use these from any conversation to access other windows. | |
510 | |
511 .TP | |
512 .B accounts | |
513 for the accounts window. | |
514 | |
515 .TP | |
516 .B buddylist | |
517 for the buddylist. | |
518 | |
519 .TP | |
520 .B debugwin | |
521 for the debug window. | |
522 | |
523 .TP | |
524 .B plugins | |
525 for the plugins window. | |
526 | |
527 .TP | |
528 .B prefs | |
529 for the preferences window. | |
530 | |
531 .TP | |
532 .B status | |
533 for the status window. | |
534 | |
20207
48770cf120f1
applied changes from 11fef11dff49357783d6656f9e83bf59403163d0
Richard Laager <rlaager@wiktel.com>
parents:
19680
diff
changeset
|
535 .SH FAQ |
48770cf120f1
applied changes from 11fef11dff49357783d6656f9e83bf59403163d0
Richard Laager <rlaager@wiktel.com>
parents:
19680
diff
changeset
|
536 FAQ for \fBfinch\fR is located at |
48770cf120f1
applied changes from 11fef11dff49357783d6656f9e83bf59403163d0
Richard Laager <rlaager@wiktel.com>
parents:
19680
diff
changeset
|
537 .br |
48770cf120f1
applied changes from 11fef11dff49357783d6656f9e83bf59403163d0
Richard Laager <rlaager@wiktel.com>
parents:
19680
diff
changeset
|
538 \fIhttp://developer.pidgin.im/wiki/Using%20Finch\fR |
48770cf120f1
applied changes from 11fef11dff49357783d6656f9e83bf59403163d0
Richard Laager <rlaager@wiktel.com>
parents:
19680
diff
changeset
|
539 |
15845 | 540 .SH BUGS |
541 Known bugs are listed at | |
542 .br | |
21682 | 543 \fIhttp://developer.pidgin.im/query?status=new&status=assigned&status=reopened&component=finch+%28gnt%2Fncurses%29&order=priority\fR |
15845 | 544 |
545 Before sending a bug report, please verify that you have the latest | |
24992
4cd46791d3a8
Add SEE ALSO references between pidgin(1) and finch(1) and make a few other
Richard Laager <rlaager@wiktel.com>
parents:
24958
diff
changeset
|
546 version of \fBfinch\fR and libpurple. Many bugs (major and minor) are |
15845 | 547 fixed at each release, and if yours is out of date, the problem may already have |
548 been solved. | |
549 | |
550 .SH PATCHES | |
551 If you fix a bug in \fBfinch\fR (or otherwise enhance it), please submit a | |
24992
4cd46791d3a8
Add SEE ALSO references between pidgin(1) and finch(1) and make a few other
Richard Laager <rlaager@wiktel.com>
parents:
24958
diff
changeset
|
552 patch (using \fBmtn diff > my.diff\fR against the latest version from the |
4cd46791d3a8
Add SEE ALSO references between pidgin(1) and finch(1) and make a few other
Richard Laager <rlaager@wiktel.com>
parents:
24958
diff
changeset
|
553 Monotone repository) at \fIhttp://developer.pidgin.im/simpleticket\fR |
15845 | 554 |
24992
4cd46791d3a8
Add SEE ALSO references between pidgin(1) and finch(1) and make a few other
Richard Laager <rlaager@wiktel.com>
parents:
24958
diff
changeset
|
555 You are also encouraged to drop by at \fB#pidgin\fR on \fIirc.freenode.net\fR |
4cd46791d3a8
Add SEE ALSO references between pidgin(1) and finch(1) and make a few other
Richard Laager <rlaager@wiktel.com>
parents:
24958
diff
changeset
|
556 to discuss development. |
15845 | 557 |
558 .SH SEE ALSO | |
559 \fIhttp://pidgin.im/\fR | |
24992
4cd46791d3a8
Add SEE ALSO references between pidgin(1) and finch(1) and make a few other
Richard Laager <rlaager@wiktel.com>
parents:
24958
diff
changeset
|
560 .br |
4cd46791d3a8
Add SEE ALSO references between pidgin(1) and finch(1) and make a few other
Richard Laager <rlaager@wiktel.com>
parents:
24958
diff
changeset
|
561 \fIhttp://developer.pidgin.im/\fR |
4cd46791d3a8
Add SEE ALSO references between pidgin(1) and finch(1) and make a few other
Richard Laager <rlaager@wiktel.com>
parents:
24958
diff
changeset
|
562 .br |
4cd46791d3a8
Add SEE ALSO references between pidgin(1) and finch(1) and make a few other
Richard Laager <rlaager@wiktel.com>
parents:
24958
diff
changeset
|
563 \fBpurple-remote\fR(1) |
4cd46791d3a8
Add SEE ALSO references between pidgin(1) and finch(1) and make a few other
Richard Laager <rlaager@wiktel.com>
parents:
24958
diff
changeset
|
564 .br |
4cd46791d3a8
Add SEE ALSO references between pidgin(1) and finch(1) and make a few other
Richard Laager <rlaager@wiktel.com>
parents:
24958
diff
changeset
|
565 \fBpidgin\fR(1) |
15845 | 566 |
567 .SH LICENSE | |
568 This program is free software; you can redistribute it and/or modify | |
569 it under the terms of the GNU General Public License as published by | |
570 the Free Software Foundation; either version 2 of the License, or | |
571 (at your option) any later version. | |
572 | |
573 This program is distributed in the hope that it will be useful, but | |
574 \fBWITHOUT ANY WARRANTY\fR; without even the implied warranty of | |
575 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
576 General Public License for more details. | |
577 | |
578 You should have received a copy of the GNU General Public License | |
579 along with this program; if not, write to the Free Software | |
19680
44b4e8bd759b
The FSF changed its address a while ago; our files were out of date.
John Bailey <rekkanoryo@rekkanoryo.org>
parents:
18508
diff
changeset
|
580 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA |
15845 | 581 |
582 .SH AUTHORS | |
583 Sadrul Habib Chowdhury <\fIsadrul@users.sourceforge.net\fR> | |
584 .br | |
585 | |
586 This manpage was written by Sadrul Habib Chowdhury | |
587 <\fIsadrul@users.sourceforge.net\fR> and Dennis Ristuccia | |
588 <\fIdennis@dennisr.net\fR>. | |
589 |