Mercurial > hg
annotate mcabber/doc/mcabber.1.html @ 286:a3d65d7f0bc3
Add /alias documentation
author | Mikael Berthe <mikael@lilotux.net> |
---|---|
date | Fri, 08 Jul 2005 07:27:56 +0100 |
parents | 4d7040cff8ee |
children | 72fa52203651 |
rev | line source |
---|---|
229 | 1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
2 <html> | |
3 <head> | |
4 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /> | |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
5 <meta name="generator" content="AsciiDoc 7.0.0" /> |
229 | 6 <meta name="author" content="Mikael BERTHE" /> |
7 <meta name="author-email" content="mcabber@lilotux.net" /> | |
8 <link rel="stylesheet" href="./manpage.css" type="text/css" /> | |
9 <title>mcabber</title> | |
10 </head> | |
11 <body> | |
12 <div id="content"> | |
13 <h1>MCABBER(1) Manual Page</h1> | |
14 <h2>NAME</h2> | |
15 <p>mcabber - | |
16 a simple Jabber console client | |
17 </p> | |
18 <div id="synopsis"> | |
19 <h2>SYNOPSIS</h2> | |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
20 <p><b>mcabber</b> [ -f configfile ] [ --help | -h ]</p> |
229 | 21 </div> |
22 <h2>DESCRIPTION</h2> | |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
23 <p><tt>mcabber(1)</tt> is a small Jabber console client.<br /> |
229 | 24 For now it needs a configuration file to start, so please copy the sample |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
25 mcabberrc file and adapt your connection settings.</p> |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
26 <p>The <tt>mcabber(1)</tt> screen is divided into 4 regions. |
229 | 27 The <b>roster</b>, alias <b>buddylist</b>, is on the left. The <b>chat window</b>, or chat |
28 buffer, is on the right. The <b>input line</b> lies at the bottom of the screen, | |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
29 under a small <b>log window</b>.</p> |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
30 <p>To display buddies chat buffers, you will have to enter <b>chat mode</b>. |
229 | 31 You can enter chat mode by pressing enter, and leave chat mode with the ESC |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
32 key. Simply sending a message will also enable chat mode.</p> |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
33 <p>Here are some of the features of <tt>mcabber</tt>:</p> |
229 | 34 <ul> |
35 <li> | |
36 <p> | |
37 <b>SSL support</b>. | |
38 </p> | |
39 </li> | |
40 <li> | |
41 <p> | |
42 <b>History logging:</b> If enabled (see the CONFIGURATION FILE section), | |
43 <tt>mcabber(1)</tt> can save discussions to history log files. | |
44 </p> | |
45 </li> | |
46 <li> | |
47 <p> | |
48 <b>Commands completion:</b> If possible, <tt>mcabber(1)</tt> will try to complete your | |
49 command line if you hit the Tab key. | |
50 </p> | |
51 </li> | |
52 <li> | |
53 <p> | |
54 <b>External actions:</b> Some events (like receiving a message) can trigger an | |
55 external action, for example a shell script (you need to enable it in your | |
56 configuration file). | |
57 </p> | |
58 </li> | |
59 </ul> | |
60 <h2>OPTIONS</h2> | |
61 <dl> | |
62 <dt><b> | |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
63 --help, -h |
229 | 64 </b></dt> |
65 <dd> | |
66 Quick help usage message | |
67 </dd> | |
68 <dt><b> | |
69 -f configfile | |
70 </b></dt> | |
71 <dd> | |
72 Use configuration file <b>configfile</b> | |
73 </dd> | |
74 </dl> | |
75 <h2>KEYS</h2> | |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
76 <p>Text typing occurs in the <b>input line</b>; basic operations are supported |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
77 (left arrow, right arrow, home/end keys, insert, delete, backspace…).</p> |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
78 <p>PageUp and PageDown keys are used to move in the roster.</p> |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
79 <p>To send a message, move to the choosen buddy in the buddylist, type your |
229 | 80 message and hit enter. If the line begins with a slash, this will be |
81 interpreted as a command (see the COMMAND section below). Hit escape to | |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
82 leave the chat mode.</p> |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
83 <p>Here is a quick description of the key bindings:</p> |
229 | 84 <table class="hlist"> |
85 <tr valign="top"> | |
86 <td> | |
87 Ctrl-a | |
88 </td> | |
89 <td> | |
90 Go to the beginning of the input line | |
91 </td> | |
92 </tr> | |
93 <tr valign="top"> | |
94 <td> | |
95 Ctrl-e | |
96 </td> | |
97 <td> | |
98 Go to the end of the input line | |
99 </td> | |
100 </tr> | |
101 <tr valign="top"> | |
102 <td> | |
103 Ctrl-l | |
104 </td> | |
105 <td> | |
106 Force a resize | |
107 </td> | |
108 </tr> | |
109 <tr valign="top"> | |
110 <td> | |
111 PgUp/PgDown | |
112 </td> | |
113 <td> | |
114 Move inside the roster (buddylist) | |
115 </td> | |
116 </tr> | |
117 <tr valign="top"> | |
118 <td> | |
119 Tab | |
120 </td> | |
121 <td> | |
122 Complete current word, in the input line | |
123 </td> | |
124 </tr> | |
125 <tr valign="top"> | |
126 <td> | |
127 Ctrl-g | |
128 </td> | |
129 <td> | |
130 Cancel completion / ctrl-g | |
131 </td> | |
132 </tr> | |
133 <tr valign="top"> | |
134 <td> | |
135 Ctrl-p/Ctrl-n | |
136 </td> | |
137 <td> | |
138 Scroll up/down half a screen in the buffer window (chat mode) | |
139 </td> | |
140 </tr> | |
141 <tr valign="top"> | |
142 <td> | |
143 Ctrl-u | |
144 </td> | |
145 <td> | |
146 Delete from beginning of the line to the cursor | |
147 </td> | |
148 </tr> | |
149 <tr valign="top"> | |
150 <td> | |
151 Ctrl-k | |
152 </td> | |
153 <td> | |
154 Delete from the cursor to the end of line | |
155 </td> | |
156 </tr> | |
157 <tr valign="top"> | |
158 <td> | |
159 Ctrl-w | |
160 </td> | |
161 <td> | |
162 Backward kill word | |
163 </td> | |
164 </tr> | |
165 <tr valign="top"> | |
166 <td> | |
167 Ctrl-t | |
168 </td> | |
169 <td> | |
170 Transpose chars | |
171 </td> | |
172 </tr> | |
173 <tr valign="top"> | |
174 <td> | |
263 | 175 Ctrl-o |
176 </td> | |
177 <td> | |
178 Accept line and put the next history line in the input line (accept-line-and-down-history) | |
179 </td> | |
180 </tr> | |
181 <tr valign="top"> | |
182 <td> | |
229 | 183 Ctrl-q |
184 </td> | |
185 <td> | |
236 | 186 Jump to the next unread message |
229 | 187 </td> |
188 </tr> | |
189 </table> | |
190 <h2>COMMANDS</h2> | |
191 <dl> | |
192 <dt><b> | |
245 | 193 /add jid [nickname] |
229 | 194 </b></dt> |
195 <dd> | |
245 | 196 Add the <b>jid</b> Jabber user to our roster (default group), and send a |
197 notification request to this buddy. If no nickname is specified, the | |
198 jid is used. | |
229 | 199 </dd> |
200 <dt><b> | |
286
a3d65d7f0bc3
Add /alias documentation
Mikael Berthe <mikael@lilotux.net>
parents:
277
diff
changeset
|
201 /alias name = command line |
a3d65d7f0bc3
Add /alias documentation
Mikael Berthe <mikael@lilotux.net>
parents:
277
diff
changeset
|
202 </b></dt> |
a3d65d7f0bc3
Add /alias documentation
Mikael Berthe <mikael@lilotux.net>
parents:
277
diff
changeset
|
203 <dd> |
a3d65d7f0bc3
Add /alias documentation
Mikael Berthe <mikael@lilotux.net>
parents:
277
diff
changeset
|
204 Add "name" as an alias for "command line". |
a3d65d7f0bc3
Add /alias documentation
Mikael Berthe <mikael@lilotux.net>
parents:
277
diff
changeset
|
205 Example: "/alias away = status away". |
a3d65d7f0bc3
Add /alias documentation
Mikael Berthe <mikael@lilotux.net>
parents:
277
diff
changeset
|
206 Aliases are expanded only once, thus they can not be chained. |
a3d65d7f0bc3
Add /alias documentation
Mikael Berthe <mikael@lilotux.net>
parents:
277
diff
changeset
|
207 </dd> |
a3d65d7f0bc3
Add /alias documentation
Mikael Berthe <mikael@lilotux.net>
parents:
277
diff
changeset
|
208 <dt><b> |
229 | 209 /buffer clear|top|bottom |
210 </b></dt> | |
211 <dd> | |
212 The <b>buffer</b> command manipulates the current buddy's buffer | |
213 (chat window). | |
214 <table class="hlist"> | |
215 <tr valign="top"> | |
216 <td> | |
217 <b>clear</b> | |
218 </td> | |
219 <td> | |
220 clear the current buddy chat window | |
221 </td> | |
222 </tr> | |
223 <tr valign="top"> | |
224 <td> | |
225 <b>top</b> | |
226 </td> | |
227 <td> | |
228 jump to the top of the current buddy chat buffer | |
229 </td> | |
230 </tr> | |
231 <tr valign="top"> | |
232 <td> | |
233 <b>bottom</b> | |
234 </td> | |
235 <td> | |
236 jump to the bottom of the current buddy chat buffer | |
237 </td> | |
238 </tr> | |
239 </table> | |
240 </dd> | |
241 <dt><b> | |
242 /clear | |
243 </b></dt> | |
244 <dd> | |
245 The <b>clear</b> command is actually an alias for "/buffer clear". | |
246 </dd> | |
247 <dt><b> | |
248 /del | |
249 </b></dt> | |
250 <dd> | |
251 Delete the current buddy from our roster, unsubscribe from its presence | |
252 notification and unsubscribe it from ours. | |
253 </dd> | |
254 <dt><b> | |
240 | 255 /group fold|unfold|toggle |
229 | 256 </b></dt> |
257 <dd> | |
240 | 258 The <b>group</b> command changes the current group display. |
229 | 259 <table class="hlist"> |
260 <tr valign="top"> | |
261 <td> | |
240 | 262 <b>fold</b> |
229 | 263 </td> |
264 <td> | |
240 | 265 fold (shrink) the current group tree in the roster |
229 | 266 </td> |
267 </tr> | |
268 <tr valign="top"> | |
269 <td> | |
240 | 270 <b>unfold</b> |
229 | 271 </td> |
272 <td> | |
240 | 273 unfold (expand) the current group tree in the roster |
229 | 274 </td> |
275 </tr> | |
276 <tr valign="top"> | |
277 <td> | |
278 <b>toggle</b> | |
279 </td> | |
280 <td> | |
240 | 281 toggle the state (fold/unfold) of the current tree |
229 | 282 </td> |
283 </tr> | |
284 </table> | |
285 </dd> | |
286 <dt><b> | |
287 /info | |
288 </b></dt> | |
289 <dd> | |
290 Display info on the selected entry (user, agent, group…). | |
291 </dd> | |
292 <dt><b> | |
293 /move [groupname] | |
294 </b></dt> | |
295 <dd> | |
296 Move the current buddy to the requested group. If no group is | |
297 specified, then the buddy is moved to the default group. | |
298 This command only works with users (not agents), at the moment. | |
299 </dd> | |
300 <dt><b> | |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
301 /msay begin|verbatim|send|abort |
238 | 302 </b></dt> |
303 <dd> | |
304 Send a multi-line message. To write a single message with several | |
305 lines, the <b>multi-line mode</b> should be used. In multi-line mode, | |
306 each line (except command lines) typed in the input line will | |
307 be added to the multi-line message. Once the message is finished, it | |
308 can be sent to the current selected buddy with the "msay /send" | |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
309 command. The <b>verbatim</b> multi-line mode disables commands, so that it |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
310 is possible to enter lines starting with a slash. Only the "/msay" |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
311 command (with send or abort parameters) can be used to exit verbatim mode. |
238 | 312 <table class="hlist"> |
313 <tr valign="top"> | |
314 <td> | |
315 <b>begin</b> | |
316 </td> | |
317 <td> | |
318 enter multi-line mode | |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
319 </td> |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
320 </tr> |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
321 <tr valign="top"> |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
322 <td> |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
323 <b>verbatim</b> |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
324 </td> |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
325 <td> |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
326 enter verbatim multi-line mode |
238 | 327 </td> |
328 </tr> | |
329 <tr valign="top"> | |
330 <td> | |
331 <b>send</b> | |
332 </td> | |
333 <td> | |
334 send the current multi-line message to the currently selected buddy | |
335 </td> | |
336 </tr> | |
337 <tr valign="top"> | |
338 <td> | |
339 <b>abort</b> | |
340 </td> | |
341 <td> | |
342 leave multi-line mode without sending the message | |
343 </td> | |
344 </tr> | |
345 </table> | |
346 </dd> | |
347 <dt><b> | |
229 | 348 /quit |
349 </b></dt> | |
350 <dd> | |
351 Disconnect and leave <tt>mcabber(1)</tt>. | |
352 </dd> | |
353 <dt><b> | |
354 /rename nickname | |
355 </b></dt> | |
356 <dd> | |
357 Rename current buddy to the given nickname. | |
358 This command does not work for groups, at the moment (but you can move | |
359 the buddies to another group with the /move command). | |
360 </dd> | |
361 <dt><b> | |
265 | 362 /roster bottom|top|hide_offline|show_offline|unread_first|unread_next |
363 </b></dt> | |
364 <dt><b> | |
365 /roster search bud | |
229 | 366 </b></dt> |
367 <dd> | |
265 | 368 The <b>roster</b> command manipulates the roster/buddylist. Here are the available parameters: |
229 | 369 <table class="hlist"> |
370 <tr valign="top"> | |
371 <td> | |
265 | 372 <b>bottom</b> |
373 </td> | |
374 <td> | |
375 jump to the bottom of the roster | |
376 </td> | |
377 </tr> | |
378 <tr valign="top"> | |
379 <td> | |
380 <b>top</b> | |
381 </td> | |
382 <td> | |
383 jump to the top of the roster | |
384 </td> | |
385 </tr> | |
386 <tr valign="top"> | |
387 <td> | |
229 | 388 <b>hide_offline</b> |
389 </td> | |
390 <td> | |
391 hide offline buddies | |
392 </td> | |
393 </tr> | |
394 <tr valign="top"> | |
395 <td> | |
396 <b>show_offline</b> | |
397 </td> | |
398 <td> | |
399 show offline buddies | |
400 </td> | |
401 </tr> | |
402 <tr valign="top"> | |
403 <td> | |
265 | 404 <b>search</b> bud |
229 | 405 </td> |
406 <td> | |
265 | 407 search for a buddy with a name or buddy containing "bud" (only in the displayed buddylist) |
229 | 408 </td> |
409 </tr> | |
236 | 410 <tr valign="top"> |
411 <td> | |
412 <b>unread_first</b> | |
413 </td> | |
414 <td> | |
415 jump to the first unread message | |
416 </td> | |
417 </tr> | |
418 <tr valign="top"> | |
419 <td> | |
420 <b>unread_next</b> | |
421 </td> | |
422 <td> | |
423 jump to the next unread message | |
424 </td> | |
425 </tr> | |
229 | 426 </table> |
427 </dd> | |
428 <dt><b> | |
429 /say text | |
430 </b></dt> | |
431 <dd> | |
432 Send the text message to the currently selected buddy. Can be useful | |
433 if you want to send a message beginning with a slash, for example. | |
434 </dd> | |
435 <dt><b> | |
277
4d7040cff8ee
Remove busy/occupied status, which does not really exist
Mikael Berthe <mikael@lilotux.net>
parents:
265
diff
changeset
|
436 /status [online|avail|invisible|free|dnd|notavail|away] |
229 | 437 </b></dt> |
438 <dd> | |
439 Set the current status. If no status is specified, display the | |
440 current status. | |
441 </dd> | |
442 </dl> | |
443 <h2>CONFIGURATION FILE</h2> | |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
444 <p>See the provided sample configuration file, which should be self-documented.</p> |
229 | 445 <h2>FILES</h2> |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
446 <p>The following files can be used by <tt>mcabber(1)</tt>:</p> |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
447 <div class="literalparagraph"><pre>$HOME/.mcabber/mcabberrc Default configuration file |
229 | 448 $HOME/.mcabberrc Configuration file used if no other has been found |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
449 $HOME/.mcabber/histo/ Default directory for storing chat history files, if enabled</pre></div> |
229 | 450 <h2>BUGS</h2> |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
451 <p>Certainly a lot. Please tell me if you find one! :-)</p> |
229 | 452 <h2>AUTHOR</h2> |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
453 <p>Written by <a href="mailto:mcabber@lilotux.net">Mikael BERTHE</a>.<br /> |
229 | 454 Originally based on <a href="http://cabber.sourceforge.net">Cabber</a>, please |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
455 consult the AUTHORS file for details.</p> |
229 | 456 <h2>RESOURCES</h2> |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
457 <p><a href="http://www.lilotux.net/~mikael/mcabber/">Main web site</a></p> |
229 | 458 <h2>COPYING</h2> |
260
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
459 <p>Copyright © 2005 Mikael Berthe.<br /> |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
460 Some portions are Copyright © 2002-2004 <a href="mailto:cabber@ajmacias.com">cabber@ajmacias.com</a>.</p> |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
461 <p>Free use of this software is granted under the terms of the GNU General Public |
33e1a05864a6
Add "verbatim multi-line" mode, with commands disabled
mikael@frmp8452
parents:
254
diff
changeset
|
462 License (GPL).</p> |
229 | 463 <div id="footer"> |
464 <p> | |
254 | 465 Version 0.6.2<br /> |
286
a3d65d7f0bc3
Add /alias documentation
Mikael Berthe <mikael@lilotux.net>
parents:
277
diff
changeset
|
466 Last updated 08-Jul-2005 08:18:39 CEST |
229 | 467 </p> |
468 </div> | |
469 </div> | |
470 </body> | |
471 </html> |