Mercurial > pidgin.yaz
annotate doc/finch.1.in @ 27427:e07abac099a2
Require SSL/TLS by default for XMPP accounts. Closes #8666.
I'm a bit concerned that this might cause some confusion for people who use
servers that just don't support TLS connections, but at the moment at least I
think that confusion is better than leaving connections unencrypted.
author | Etan Reisner <pidgin@unreliablesource.net> |
---|---|
date | Sun, 28 Jun 2009 07:06:31 +0000 |
parents | 35bbc8160513 |
children | 90a7224593d8 |
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 | |
25879
35bbc8160513
Obligatory 'whoops' commit for 2.5.6
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
24992
diff
changeset
|
62 You can use the following shortcuts (see the "\*QWidget Actions\*U" section for a more complete list): |
15845 | 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 | |
25879
35bbc8160513
Obligatory 'whoops' commit for 2.5.6
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
24992
diff
changeset
|
381 .br |
35bbc8160513
Obligatory 'whoops' commit for 2.5.6
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
24992
diff
changeset
|
382 c-x = context-menu |
15845 | 383 |
384 [GntWindow::binding] | |
385 .br | |
386 c-o = show-menu | |
387 .br | |
388 f10 = show-menu | |
389 | |
390 The \fBc-\fR corresponds to the \fBControl\fR key. You can also use \fBctrl-\fR | |
391 or \fBctr-\fR or \fBctl-\fR to indicate a combination. For alt-keys, you can use | |
392 one of \fBa-\fR, \fBalt-\fR, \fBm-\fR or \fBmeta-\fR. You can also use | |
393 \fBhome\fR, \fBend\fR, \fBleft\fR, \fBright\fR etc. keys. | |
394 | |
22940
9809516e0032
Add key unbinding to the finch man page
Ethan Blanton <elb@pidgin.im>
parents:
22747
diff
changeset
|
395 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
|
396 |
9809516e0032
Add key unbinding to the finch man page
Ethan Blanton <elb@pidgin.im>
parents:
22747
diff
changeset
|
397 [GntWM::binding] |
9809516e0032
Add key unbinding to the finch man page
Ethan Blanton <elb@pidgin.im>
parents:
22747
diff
changeset
|
398 .br |
9809516e0032
Add key unbinding to the finch man page
Ethan Blanton <elb@pidgin.im>
parents:
22747
diff
changeset
|
399 a-q = |
9809516e0032
Add key unbinding to the finch man page
Ethan Blanton <elb@pidgin.im>
parents:
22747
diff
changeset
|
400 |
21251
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
401 .SH Menus |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
402 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
|
403 |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
404 [buddylist::menu] |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
405 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
406 c-t = send-im |
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 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
|
409 |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
410 send-im |
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 join-chat |
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-empty-groups |
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 show-offline-buddies |
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-status |
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-alpha |
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 sort-log |
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-buddy |
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-chat |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
427 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
428 add-group |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
429 |
15845 | 430 .SH Mouse Support |
431 There is experimental mouse support. You can focus windows, activate buttons, | |
432 select rows in a list, scroll using the wheel-scroll etc. Selecting text in a | |
433 text-view copies it to the gnt clipboard. Mouse support is disabled by default, | |
434 so you need to enable it in \fI~/.gntrc\fR (see the sample above). | |
435 | |
436 .SH Window Management | |
437 The default window management is very limited. But it is possible to write | |
438 custom window managers to suit your needs. There is a sample window-manager | |
439 included (named \fIs.so\fR) which adds a little 'close-button' for the windows, | |
440 removes the borders from the buddylist and pops up new windows in the middle of | |
441 the screen, instead of at the upper-left corder. It is provided as a sample | |
442 simple manager, but it should be possible to write more complex managers, and | |
443 it's very possible that the window-manager API will need to be enhanced. Look at | |
444 the sample \fI~/.gntrc\fR file above to see how to select a window-manager. | |
445 | |
446 It is also possible to rebind the window-manager actions in \fI~/.gntrc\fR, eg: | |
447 | |
448 .br | |
449 [GntWM::binding] | |
450 .br | |
451 a-n = window-next | |
452 .br | |
453 a-p = window-prev | |
454 .br | |
455 a-c = window-close | |
456 .br | |
457 a-w = window-list | |
458 .br | |
459 a-d = dump-screen | |
460 .br | |
461 a-, = shift-left | |
462 .br | |
463 a-. = shift-right | |
464 .br | |
465 a-a = action-list | |
466 .br | |
467 a-m = start-move | |
468 .br | |
469 a-r = start-resize | |
470 .br | |
471 a-q = wm-quit | |
472 .br | |
473 a-l = refresh-screen | |
474 .br | |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
475 a-s = workspace-list |
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 = window-tag |
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-T = place-tagged |
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-C = toggle-clipboard |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
482 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
483 a-/ = help-for-widget |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
484 .br |
15845 | 485 # The following action is still incomplete, and doesn't have a default binding |
486 .br | |
487 # switch-window-n | |
488 .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
|
489 # Other actions: window-next-urgent, window-prev-urgent |
15845 | 490 |
491 # For the sample custom window manager | |
492 .br | |
493 [GntS::binding] | |
494 .br | |
495 a-b = toggle-buddylist | |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
496 |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
497 # For the irssi window manager |
15845 | 498 .br |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
499 [Irssi::binding] |
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-L = move-right |
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-H = move-left |
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-J = move-down |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
506 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17076
diff
changeset
|
507 a-K = move-up |
15845 | 508 |
509 .SH Conversation Commands | |
510 There are a few helpful commands in addition to the regular commands. You can | |
511 use these from any conversation to access other windows. | |
512 | |
513 .TP | |
514 .B accounts | |
515 for the accounts window. | |
516 | |
517 .TP | |
518 .B buddylist | |
519 for the buddylist. | |
520 | |
521 .TP | |
522 .B debugwin | |
523 for the debug window. | |
524 | |
525 .TP | |
526 .B plugins | |
527 for the plugins window. | |
528 | |
529 .TP | |
530 .B prefs | |
531 for the preferences window. | |
532 | |
533 .TP | |
534 .B status | |
535 for the status window. | |
536 | |
20207
48770cf120f1
applied changes from 11fef11dff49357783d6656f9e83bf59403163d0
Richard Laager <rlaager@wiktel.com>
parents:
19680
diff
changeset
|
537 .SH FAQ |
48770cf120f1
applied changes from 11fef11dff49357783d6656f9e83bf59403163d0
Richard Laager <rlaager@wiktel.com>
parents:
19680
diff
changeset
|
538 FAQ for \fBfinch\fR is located at |
48770cf120f1
applied changes from 11fef11dff49357783d6656f9e83bf59403163d0
Richard Laager <rlaager@wiktel.com>
parents:
19680
diff
changeset
|
539 .br |
48770cf120f1
applied changes from 11fef11dff49357783d6656f9e83bf59403163d0
Richard Laager <rlaager@wiktel.com>
parents:
19680
diff
changeset
|
540 \fIhttp://developer.pidgin.im/wiki/Using%20Finch\fR |
48770cf120f1
applied changes from 11fef11dff49357783d6656f9e83bf59403163d0
Richard Laager <rlaager@wiktel.com>
parents:
19680
diff
changeset
|
541 |
15845 | 542 .SH BUGS |
543 Known bugs are listed at | |
544 .br | |
21682 | 545 \fIhttp://developer.pidgin.im/query?status=new&status=assigned&status=reopened&component=finch+%28gnt%2Fncurses%29&order=priority\fR |
15845 | 546 |
547 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
|
548 version of \fBfinch\fR and libpurple. Many bugs (major and minor) are |
15845 | 549 fixed at each release, and if yours is out of date, the problem may already have |
550 been solved. | |
551 | |
552 .SH PATCHES | |
553 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
|
554 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
|
555 Monotone repository) at \fIhttp://developer.pidgin.im/simpleticket\fR |
15845 | 556 |
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
|
557 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
|
558 to discuss development. |
15845 | 559 |
560 .SH SEE ALSO | |
561 \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
|
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 \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
|
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 \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
|
566 .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
|
567 \fBpidgin\fR(1) |
15845 | 568 |
569 .SH LICENSE | |
570 This program is free software; you can redistribute it and/or modify | |
571 it under the terms of the GNU General Public License as published by | |
572 the Free Software Foundation; either version 2 of the License, or | |
573 (at your option) any later version. | |
574 | |
575 This program is distributed in the hope that it will be useful, but | |
576 \fBWITHOUT ANY WARRANTY\fR; without even the implied warranty of | |
577 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
578 General Public License for more details. | |
579 | |
580 You should have received a copy of the GNU General Public License | |
581 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
|
582 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA |
15845 | 583 |
584 .SH AUTHORS | |
585 Sadrul Habib Chowdhury <\fIsadrul@users.sourceforge.net\fR> | |
586 .br | |
587 | |
588 This manpage was written by Sadrul Habib Chowdhury | |
589 <\fIsadrul@users.sourceforge.net\fR> and Dennis Ristuccia | |
590 <\fIdennis@dennisr.net\fR>. | |
591 |