Mercurial > pidgin
annotate doc/finch.1.in @ 22750:4040c4ee1f44
Clicking on the buddyicon in the conversation window toggles the size of
the icon between small (32px) and large (96px). The size can also be
changed from the context menu for the icon.
I initially tried to make double-click change the size, instead of a
single-click. But something was going wrong with tab-dragging. If single
clicking is massively unpopular, I can look at getting the double-click
to work.
author | Sadrul Habib Chowdhury <imadil@gmail.com> |
---|---|
date | Sat, 26 Apr 2008 23:14:00 +0000 |
parents | a86c035be695 |
children | 5b8dbe4b9898 |
rev | line source |
---|---|
15844 | 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 | |
16965
6b516b7eebc5
Pimp libpurple, based on a suggestion from James Lockie. This okay?
Richard Laager <rlaager@wiktel.com>
parents:
16904
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:
16904
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:
16904
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:
16904
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:
16904
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:
16904
diff
changeset
|
37 Yahoo. |
15844 | 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:
15844
diff
changeset
|
49 Use \fIDIR\fR as the directory for config files instead of \fI~/.purple\fR. |
15844 | 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. | |
15844 | 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 |
15844 | 114 .B Ctrl \+ o |
21682 | 115 Bring up the menu (if there is one) for a window. |
17829 | 116 .TP |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
117 .B Alt \+ / |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
118 Show a list of available key-bindings for the current widget in focus. |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
119 .TP |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
120 .B Alt \+ \> |
17829 | 121 Switch to the next workspace |
122 .TP | |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
123 .B Alt \+ \< |
17829 | 124 Switch to the previous workspace |
125 .TP | |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
126 .B Alt \+ t |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
127 Tag (or untag) the current window |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
128 .TP |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
129 .B Alt \+ T |
21291
13cc55dff880
A grammar fix for finch(1).
Will Thompson <will.thompson@collabora.co.uk>
parents:
21251
diff
changeset
|
130 Attached all the tagged windows to the current workspace |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
131 .TP |
17829 | 132 .B Alt \+ s |
133 Show the workspace list | |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
134 .TP |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
135 .B F9 |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
136 Create a new workspace and switch to it |
15844 | 137 |
138 .SH FILES | |
139 \fI~/.gntrc\fR: configuration file for gnt applications. | |
140 .br | |
141 .TP | |
142 A sample file looks like: | |
143 .br | |
21691
3ed9b027479d
Add support for colour in gnttreerows, and colourise the blist. Fixes #1490
Richard Nelson <wabz@pidgin.im>
parents:
21682
diff
changeset
|
144 [Finch] |
3ed9b027479d
Add support for colour in gnttreerows, and colourise the blist. Fixes #1490
Richard Nelson <wabz@pidgin.im>
parents:
21682
diff
changeset
|
145 .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
|
146 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
|
147 .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
|
148 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
|
149 .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
|
150 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
|
151 .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
|
152 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
|
153 .br |
21738
e3e64d1e4869
Add color to the conversation window to indicate various message attributes
Richard Nelson <wabz@pidgin.im>
parents:
21694
diff
changeset
|
154 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
|
155 .br |
e3e64d1e4869
Add color to the conversation window to indicate various message attributes
Richard Nelson <wabz@pidgin.im>
parents:
21694
diff
changeset
|
156 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
|
157 .br |
e3e64d1e4869
Add color to the conversation window to indicate various message attributes
Richard Nelson <wabz@pidgin.im>
parents:
21694
diff
changeset
|
158 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
|
159 .br |
e3e64d1e4869
Add color to the conversation window to indicate various message attributes
Richard Nelson <wabz@pidgin.im>
parents:
21694
diff
changeset
|
160 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
|
161 .br |
e3e64d1e4869
Add color to the conversation window to indicate various message attributes
Richard Nelson <wabz@pidgin.im>
parents:
21694
diff
changeset
|
162 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
|
163 .br |
21691
3ed9b027479d
Add support for colour in gnttreerows, and colourise the blist. Fixes #1490
Richard Nelson <wabz@pidgin.im>
parents:
21682
diff
changeset
|
164 #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
|
165 .br |
21744 | 166 |
15844 | 167 [general] |
168 .br | |
169 shadow = 0 | |
170 .br | |
171 # There is experimental mouse support | |
172 .br | |
173 mouse = 1 | |
174 .br | |
175 # To use some custom window-manager | |
176 .br | |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
177 wm = /usr/local/lib/gnt/s.so |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
178 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
179 # There's also a custom window manager called irssi.so |
15844 | 180 .br |
181 # Remember window-positions based on the titles (on by default) | |
182 .br | |
183 remember_position = 1 | |
184 .br | |
18508
902685705e4e
Update the man about small buttons.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
18381
diff
changeset
|
185 # Use borderless one-line high buttons |
902685705e4e
Update the man about small buttons.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
18381
diff
changeset
|
186 .br |
902685705e4e
Update the man about small buttons.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
18381
diff
changeset
|
187 small-button = true |
15844 | 188 |
189 .br | |
17829 | 190 # Workspaces are created simply by adding Workspace-X groups as follows: |
191 .br | |
192 [Workspace-1] | |
193 .br | |
194 name = blist | |
195 .br | |
196 # window-names specifies that windows with these semi-colon separated names are placed | |
197 into this workspace | |
198 .br | |
199 window-names = buddylist;debug-window | |
200 .br | |
201 | |
202 .br | |
203 [Workspace-2] | |
204 .br | |
205 name = IM | |
206 .br | |
207 window-names = conversation-window | |
208 .br | |
209 # window-titles specifies that windows with these semi-colon separated titles are placed | |
210 into this workspace. These are matched as substrings. Window titles take precedence over | |
211 names. | |
212 .br | |
213 window-titles = Preferences;Pounce | |
214 .br | |
215 | |
216 .br | |
15844 | 217 [colors] |
218 .br | |
219 # The RGB values range in [0, 1000] | |
220 .br | |
221 black = 0; 0; 0 | |
222 .br | |
223 red = 1000; 0; 0 | |
224 .br | |
225 green = 0; 1000; 0 | |
226 .br | |
227 blue = 250; 250; 700 | |
228 .br | |
229 white = 1000; 1000; 1000 | |
230 .br | |
231 gray = 700; 700; 700 | |
232 .br | |
233 darkgray = 256; 256; 256 | |
234 .br | |
235 | |
236 .br | |
237 [colorpairs] | |
238 .br | |
239 normal = white; black | |
240 .br | |
241 highlight = white; blue | |
242 .br | |
243 highlightd = black; gray | |
244 .br | |
245 shadow = black; darkgray | |
246 .br | |
247 title = white; blue | |
248 .br | |
249 titled = white; gray | |
250 .br | |
251 text = white; blue | |
252 .br | |
253 disabled = gray; black | |
254 .br | |
255 urgent = green; black | |
256 .br | |
257 | |
258 .br | |
259 # Remap some keys for GntEntry | |
260 .br | |
261 [GntEntry::remap] | |
262 .br | |
263 # Remap the up-arrow to the left-arrow | |
264 .br | |
265 ^[[A = ^[[D | |
266 .br | |
267 # Remap the down-arrow to the right-arrow | |
268 .br | |
269 ^[[B = ^[[C | |
270 .br | |
271 # Remap 'a' to 'bcd' | |
272 .br | |
273 a = bcd | |
274 .br | |
275 # Completely ignore the key 'q' | |
276 .br | |
277 q = | |
278 .br | |
279 # But the following will NOT work | |
280 .br | |
281 #abc = bcd | |
282 .br | |
283 | |
284 # Hitting 'space' will activate a button | |
285 .br | |
286 [GntButton::remap] | |
287 .br | |
288 \\ = \\r | |
289 .br | |
290 | |
291 .SH Widget Actions | |
292 You can specifiy key-bindings for specific widgets. The following entries in | |
293 \fI~/.gntrc\fR correspond to the default keybindings for the actions: | |
294 | |
295 .br | |
296 [GntEntry::binding] | |
297 .br | |
298 c-a = cursor-home | |
299 .br | |
300 home = cursor-home | |
301 .br | |
302 c-e = cursor-end | |
303 .br | |
304 end = cursor-end | |
305 .br | |
306 backspace = delete-prev | |
307 .br | |
308 del = delete-next | |
309 .br | |
310 c-d = delete-next | |
311 .br | |
312 c-u = delete-start | |
313 .br | |
314 c-k = delete-end | |
315 .br | |
316 c-b = cursor-prev | |
317 .br | |
318 left = cursor-prev | |
319 .br | |
320 c-f = cursor-next | |
321 .br | |
322 right = cursor-next | |
323 .br | |
324 tab = suggest-show | |
325 .br | |
326 down = suggest-next | |
327 .br | |
328 up = suggest-prev | |
329 .br | |
330 c-w = delete-prev-word | |
331 .br | |
332 a-b = cursor-prev-word | |
333 .br | |
334 a-f = cursor-next-word | |
335 .br | |
336 a-d = delete-next-word | |
337 .br | |
338 c-v = clipboard-paste | |
339 | |
340 .br | |
341 [GntTree::binding] | |
342 .br | |
343 up = move-up | |
344 .br | |
345 down = move-down | |
346 .br | |
347 c-n = move-down | |
348 .br | |
349 c-p = move-up | |
350 .br | |
351 pageup = page-up | |
352 .br | |
353 pagedown = page-down | |
354 .br | |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
355 backspace = move-parent |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
356 .br |
15844 | 357 # Following is the default binding for the context-menu |
358 .br | |
359 menu = context-menu | |
360 .br | |
361 # The following will let you open the context-menu in the buddylist with c-b | |
362 .br | |
363 # c-b = context-menu | |
364 | |
365 .br | |
366 [GntWidget::binding] | |
367 .br | |
368 f11 = context-menu | |
369 | |
370 [GntWindow::binding] | |
371 .br | |
372 c-o = show-menu | |
373 .br | |
374 f10 = show-menu | |
375 | |
376 The \fBc-\fR corresponds to the \fBControl\fR key. You can also use \fBctrl-\fR | |
377 or \fBctr-\fR or \fBctl-\fR to indicate a combination. For alt-keys, you can use | |
378 one of \fBa-\fR, \fBalt-\fR, \fBm-\fR or \fBmeta-\fR. You can also use | |
379 \fBhome\fR, \fBend\fR, \fBleft\fR, \fBright\fR etc. keys. | |
380 | |
21251
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
381 .SH Menus |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
382 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
|
383 |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
384 [buddylist::menu] |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
385 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
386 c-t = send-im |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
387 |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
388 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
|
389 |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
390 send-im |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
391 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
392 join-chat |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
393 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
394 show-empty-groups |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
395 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
396 show-offline-buddies |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
397 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
398 sort-status |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
399 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
400 sort-alpha |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
401 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
402 sort-log |
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 add-buddy |
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 add-chat |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
407 .br |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
408 add-group |
0110eb27b8b1
Add the menu-binding stuff in the manpage.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
20207
diff
changeset
|
409 |
15844 | 410 .SH Mouse Support |
411 There is experimental mouse support. You can focus windows, activate buttons, | |
412 select rows in a list, scroll using the wheel-scroll etc. Selecting text in a | |
413 text-view copies it to the gnt clipboard. Mouse support is disabled by default, | |
414 so you need to enable it in \fI~/.gntrc\fR (see the sample above). | |
415 | |
416 .SH Window Management | |
417 The default window management is very limited. But it is possible to write | |
418 custom window managers to suit your needs. There is a sample window-manager | |
419 included (named \fIs.so\fR) which adds a little 'close-button' for the windows, | |
420 removes the borders from the buddylist and pops up new windows in the middle of | |
421 the screen, instead of at the upper-left corder. It is provided as a sample | |
422 simple manager, but it should be possible to write more complex managers, and | |
423 it's very possible that the window-manager API will need to be enhanced. Look at | |
424 the sample \fI~/.gntrc\fR file above to see how to select a window-manager. | |
425 | |
426 It is also possible to rebind the window-manager actions in \fI~/.gntrc\fR, eg: | |
427 | |
428 .br | |
429 [GntWM::binding] | |
430 .br | |
431 a-n = window-next | |
432 .br | |
433 a-p = window-prev | |
434 .br | |
435 a-c = window-close | |
436 .br | |
437 a-w = window-list | |
438 .br | |
439 a-d = dump-screen | |
440 .br | |
441 a-, = shift-left | |
442 .br | |
443 a-. = shift-right | |
444 .br | |
445 a-a = action-list | |
446 .br | |
447 a-m = start-move | |
448 .br | |
449 a-r = start-resize | |
450 .br | |
451 a-q = wm-quit | |
452 .br | |
453 a-l = refresh-screen | |
454 .br | |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
455 a-s = workspace-list |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
456 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
457 a-t = window-tag |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
458 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
459 a-T = place-tagged |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
460 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
461 a-C = toggle-clipboard |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
462 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
463 a-/ = help-for-widget |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
464 .br |
15844 | 465 # The following action is still incomplete, and doesn't have a default binding |
466 .br | |
467 # switch-window-n | |
468 .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
|
469 # Other actions: window-next-urgent, window-prev-urgent |
15844 | 470 |
471 # For the sample custom window manager | |
472 .br | |
473 [GntS::binding] | |
474 .br | |
475 a-b = toggle-buddylist | |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
476 |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
477 # For the irssi window manager |
15844 | 478 .br |
18381
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
479 [Irssi::binding] |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
480 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
481 a-L = move-right |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
482 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
483 a-H = move-left |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
484 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
485 a-J = move-down |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
486 .br |
76b7adc8e934
Some manpage updates.
Sadrul Habib Chowdhury <imadil@gmail.com>
parents:
17829
diff
changeset
|
487 a-K = move-up |
15844 | 488 |
489 .SH Conversation Commands | |
490 There are a few helpful commands in addition to the regular commands. You can | |
491 use these from any conversation to access other windows. | |
492 | |
493 .TP | |
494 .B accounts | |
495 for the accounts window. | |
496 | |
497 .TP | |
498 .B buddylist | |
499 for the buddylist. | |
500 | |
501 .TP | |
502 .B debugwin | |
503 for the debug window. | |
504 | |
505 .TP | |
506 .B plugins | |
507 for the plugins window. | |
508 | |
509 .TP | |
510 .B prefs | |
511 for the preferences window. | |
512 | |
513 .TP | |
514 .B status | |
515 for the status window. | |
516 | |
20207
48770cf120f1
applied changes from 11fef11dff49357783d6656f9e83bf59403163d0
Richard Laager <rlaager@wiktel.com>
parents:
19681
diff
changeset
|
517 .SH FAQ |
48770cf120f1
applied changes from 11fef11dff49357783d6656f9e83bf59403163d0
Richard Laager <rlaager@wiktel.com>
parents:
19681
diff
changeset
|
518 FAQ for \fBfinch\fR is located at |
48770cf120f1
applied changes from 11fef11dff49357783d6656f9e83bf59403163d0
Richard Laager <rlaager@wiktel.com>
parents:
19681
diff
changeset
|
519 .br |
48770cf120f1
applied changes from 11fef11dff49357783d6656f9e83bf59403163d0
Richard Laager <rlaager@wiktel.com>
parents:
19681
diff
changeset
|
520 \fIhttp://developer.pidgin.im/wiki/Using%20Finch\fR |
48770cf120f1
applied changes from 11fef11dff49357783d6656f9e83bf59403163d0
Richard Laager <rlaager@wiktel.com>
parents:
19681
diff
changeset
|
521 |
15844 | 522 .SH BUGS |
523 Known bugs are listed at | |
524 .br | |
21682 | 525 \fIhttp://developer.pidgin.im/query?status=new&status=assigned&status=reopened&component=finch+%28gnt%2Fncurses%29&order=priority\fR |
15844 | 526 |
527 Before sending a bug report, please verify that you have the latest | |
528 version of \fBfinch\fR and \fBlibpurple\fR. Many bugs (major and minor) are | |
529 fixed at each release, and if yours is out of date, the problem may already have | |
530 been solved. | |
531 | |
532 | |
533 .SH PATCHES | |
534 If you fix a bug in \fBfinch\fR (or otherwise enhance it), please submit a | |
535 patch (using \fImtn diff > my.diff\fR against the latest version from the | |
536 Monotone repository) at | |
537 .br | |
538 \fIhttp://developer.pidgin.im/newticket\fR | |
539 | |
540 You are also encouraged to drop by at \fB#pidgin\fR on \fIirc.freenode.net\fR to | |
541 discuss development. | |
542 | |
543 .SH SEE ALSO | |
544 \fIhttp://pidgin.im/\fR | |
545 | |
546 .SH LICENSE | |
547 This program is free software; you can redistribute it and/or modify | |
548 it under the terms of the GNU General Public License as published by | |
549 the Free Software Foundation; either version 2 of the License, or | |
550 (at your option) any later version. | |
551 | |
552 This program is distributed in the hope that it will be useful, but | |
553 \fBWITHOUT ANY WARRANTY\fR; without even the implied warranty of | |
554 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
555 General Public License for more details. | |
556 | |
557 You should have received a copy of the GNU General Public License | |
558 along with this program; if not, write to the Free Software | |
19681
44b4e8bd759b
The FSF changed its address a while ago; our files were out of date.
John Bailey <rekkanoryo@rekkanoryo.org>
parents:
18508
diff
changeset
|
559 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA |
15844 | 560 |
561 .SH AUTHORS | |
562 Sadrul Habib Chowdhury <\fIsadrul@users.sourceforge.net\fR> | |
563 .br | |
564 | |
565 This manpage was written by Sadrul Habib Chowdhury | |
566 <\fIsadrul@users.sourceforge.net\fR> and Dennis Ristuccia | |
567 <\fIdennis@dennisr.net\fR>. | |
568 |