comparison mcabber/doc/mcabber.1.html @ 1759:921429804e20

Update documentation
author Mikael Berthe <mikael@lilotux.net>
date Sat, 13 Mar 2010 18:05:07 +0100
parents d7f26538c24c
children cec7cbeb1c2e
comparison
equal deleted inserted replaced
1758:499d3ec34188 1759:921429804e20
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2 <html> 2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
3 <head> 4 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /> 5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
5 <meta name="generator" content="AsciiDoc 8.2.1" /> 6 <meta name="generator" content="AsciiDoc 8.5.2" />
6 <meta name="author" content="Mikael BERTHE" /> 7 <title>MCABBER(1)</title>
7 <meta name="author-email" content="mcabber@lilotux.net" /> 8 <style type="text/css">
8 <link rel="stylesheet" href="./manpage.css" type="text/css" /> 9 /* Debug borders */
9 <title>mcabber</title> 10 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
11 /*
12 border: 1px solid red;
13 */
14 }
15
16 body {
17 margin: 1em 5% 1em 5%;
18 }
19
20 a {
21 color: blue;
22 text-decoration: underline;
23 }
24 a:visited {
25 color: fuchsia;
26 }
27
28 em {
29 font-style: italic;
30 color: navy;
31 }
32
33 strong {
34 font-weight: bold;
35 color: #083194;
36 }
37
38 tt {
39 color: navy;
40 }
41
42 h1, h2, h3, h4, h5, h6 {
43 color: #527bbd;
44 font-family: sans-serif;
45 margin-top: 1.2em;
46 margin-bottom: 0.5em;
47 line-height: 1.3;
48 }
49
50 h1, h2, h3 {
51 border-bottom: 2px solid silver;
52 }
53 h2 {
54 padding-top: 0.5em;
55 }
56 h3 {
57 float: left;
58 }
59 h3 + * {
60 clear: left;
61 }
62
63 div.sectionbody {
64 font-family: serif;
65 margin-left: 0;
66 }
67
68 hr {
69 border: 1px solid silver;
70 }
71
72 p {
73 margin-top: 0.5em;
74 margin-bottom: 0.5em;
75 }
76
77 ul, ol, li > p {
78 margin-top: 0;
79 }
80
81 pre {
82 padding: 0;
83 margin: 0;
84 }
85
86 span#author {
87 color: #527bbd;
88 font-family: sans-serif;
89 font-weight: bold;
90 font-size: 1.1em;
91 }
92 span#email {
93 }
94 span#revnumber, span#revdate, span#revremark {
95 font-family: sans-serif;
96 }
97
98 div#footer {
99 font-family: sans-serif;
100 font-size: small;
101 border-top: 2px solid silver;
102 padding-top: 0.5em;
103 margin-top: 4.0em;
104 }
105 div#footer-text {
106 float: left;
107 padding-bottom: 0.5em;
108 }
109 div#footer-badges {
110 float: right;
111 padding-bottom: 0.5em;
112 }
113
114 div#preamble {
115 margin-top: 1.5em;
116 margin-bottom: 1.5em;
117 }
118 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
119 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
120 div.admonitionblock {
121 margin-top: 1.0em;
122 margin-bottom: 1.5em;
123 }
124 div.admonitionblock {
125 margin-top: 2.0em;
126 margin-bottom: 2.0em;
127 margin-right: 10%;
128 color: #606060;
129 }
130
131 div.content { /* Block element content. */
132 padding: 0;
133 }
134
135 /* Block element titles. */
136 div.title, caption.title {
137 color: #527bbd;
138 font-family: sans-serif;
139 font-weight: bold;
140 text-align: left;
141 margin-top: 1.0em;
142 margin-bottom: 0.5em;
143 }
144 div.title + * {
145 margin-top: 0;
146 }
147
148 td div.title:first-child {
149 margin-top: 0.0em;
150 }
151 div.content div.title:first-child {
152 margin-top: 0.0em;
153 }
154 div.content + div.title {
155 margin-top: 0.0em;
156 }
157
158 div.sidebarblock > div.content {
159 background: #ffffee;
160 border: 1px solid silver;
161 padding: 0.5em;
162 }
163
164 div.listingblock > div.content {
165 border: 1px solid silver;
166 background: #f4f4f4;
167 padding: 0.5em;
168 }
169
170 div.quoteblock, div.verseblock {
171 padding-left: 1.0em;
172 margin-left: 1.0em;
173 margin-right: 10%;
174 border-left: 5px solid #dddddd;
175 color: #777777;
176 }
177
178 div.quoteblock > div.attribution {
179 padding-top: 0.5em;
180 text-align: right;
181 }
182
183 div.verseblock > div.content {
184 white-space: pre;
185 }
186 div.verseblock > div.attribution {
187 padding-top: 0.75em;
188 text-align: left;
189 }
190 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
191 div.verseblock + div.attribution {
192 text-align: left;
193 }
194
195 div.admonitionblock .icon {
196 vertical-align: top;
197 font-size: 1.1em;
198 font-weight: bold;
199 text-decoration: underline;
200 color: #527bbd;
201 padding-right: 0.5em;
202 }
203 div.admonitionblock td.content {
204 padding-left: 0.5em;
205 border-left: 3px solid #dddddd;
206 }
207
208 div.exampleblock > div.content {
209 border-left: 3px solid #dddddd;
210 padding-left: 0.5em;
211 }
212
213 div.imageblock div.content { padding-left: 0; }
214 span.image img { border-style: none; }
215 a.image:visited { color: white; }
216
217 dl {
218 margin-top: 0.8em;
219 margin-bottom: 0.8em;
220 }
221 dt {
222 margin-top: 0.5em;
223 margin-bottom: 0;
224 font-style: normal;
225 color: navy;
226 }
227 dd > *:first-child {
228 margin-top: 0.1em;
229 }
230
231 ul, ol {
232 list-style-position: outside;
233 }
234 ol.arabic {
235 list-style-type: decimal;
236 }
237 ol.loweralpha {
238 list-style-type: lower-alpha;
239 }
240 ol.upperalpha {
241 list-style-type: upper-alpha;
242 }
243 ol.lowerroman {
244 list-style-type: lower-roman;
245 }
246 ol.upperroman {
247 list-style-type: upper-roman;
248 }
249
250 div.compact ul, div.compact ol,
251 div.compact p, div.compact p,
252 div.compact div, div.compact div {
253 margin-top: 0.1em;
254 margin-bottom: 0.1em;
255 }
256
257 div.tableblock > table {
258 border: 3px solid #527bbd;
259 }
260 thead, p.table.header {
261 font-family: sans-serif;
262 font-weight: bold;
263 }
264 tfoot {
265 font-weight: bold;
266 }
267 td > div.verse {
268 white-space: pre;
269 }
270 p.table {
271 margin-top: 0;
272 }
273 /* Because the table frame attribute is overriden by CSS in most browsers. */
274 div.tableblock > table[frame="void"] {
275 border-style: none;
276 }
277 div.tableblock > table[frame="hsides"] {
278 border-left-style: none;
279 border-right-style: none;
280 }
281 div.tableblock > table[frame="vsides"] {
282 border-top-style: none;
283 border-bottom-style: none;
284 }
285
286
287 div.hdlist {
288 margin-top: 0.8em;
289 margin-bottom: 0.8em;
290 }
291 div.hdlist tr {
292 padding-bottom: 15px;
293 }
294 dt.hdlist1.strong, td.hdlist1.strong {
295 font-weight: bold;
296 }
297 td.hdlist1 {
298 vertical-align: top;
299 font-style: normal;
300 padding-right: 0.8em;
301 color: navy;
302 }
303 td.hdlist2 {
304 vertical-align: top;
305 }
306 div.hdlist.compact tr {
307 margin: 0;
308 padding-bottom: 0;
309 }
310
311 .comment {
312 background: yellow;
313 }
314
315 .footnote, .footnoteref {
316 font-size: 0.8em;
317 }
318
319 span.footnote, span.footnoteref {
320 vertical-align: super;
321 }
322
323 #footnotes {
324 margin: 20px 0 20px 0;
325 padding: 7px 0 0 0;
326 }
327
328 #footnotes div.footnote {
329 margin: 0 0 5px 0;
330 }
331
332 #footnotes hr {
333 border: none;
334 border-top: 1px solid silver;
335 height: 1px;
336 text-align: left;
337 margin-left: 0;
338 width: 20%;
339 min-width: 100px;
340 }
341
342
343 @media print {
344 div#footer-badges { display: none; }
345 }
346
347 div#toc {
348 margin-bottom: 2.5em;
349 }
350
351 div#toctitle {
352 color: #527bbd;
353 font-family: sans-serif;
354 font-size: 1.1em;
355 font-weight: bold;
356 margin-top: 1.0em;
357 margin-bottom: 0.1em;
358 }
359
360 div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
361 margin-top: 0;
362 margin-bottom: 0;
363 }
364 div.toclevel2 {
365 margin-left: 2em;
366 font-size: 0.9em;
367 }
368 div.toclevel3 {
369 margin-left: 4em;
370 font-size: 0.9em;
371 }
372 div.toclevel4 {
373 margin-left: 6em;
374 font-size: 0.9em;
375 }
376 /* Overrides for manpage documents */
377 h1 {
378 padding-top: 0.5em;
379 padding-bottom: 0.5em;
380 border-top: 2px solid silver;
381 border-bottom: 2px solid silver;
382 }
383 h2 {
384 border-style: none;
385 }
386 div.sectionbody {
387 margin-left: 5%;
388 }
389
390 @media print {
391 div#toc { display: none; }
392 }
393
394 /* Workarounds for IE6's broken and incomplete CSS2. */
395
396 div.sidebar-content {
397 background: #ffffee;
398 border: 1px solid silver;
399 padding: 0.5em;
400 }
401 div.sidebar-title, div.image-title {
402 color: #527bbd;
403 font-family: sans-serif;
404 font-weight: bold;
405 margin-top: 0.0em;
406 margin-bottom: 0.5em;
407 }
408
409 div.listingblock div.content {
410 border: 1px solid silver;
411 background: #f4f4f4;
412 padding: 0.5em;
413 }
414
415 div.quoteblock-attribution {
416 padding-top: 0.5em;
417 text-align: right;
418 }
419
420 div.verseblock-content {
421 white-space: pre;
422 }
423 div.verseblock-attribution {
424 padding-top: 0.75em;
425 text-align: left;
426 }
427
428 div.exampleblock-content {
429 border-left: 3px solid #dddddd;
430 padding-left: 0.5em;
431 }
432
433 /* IE6 sets dynamically generated links as visited. */
434 div#toc a:visited { color: blue; }
435 </style>
436 <script type="text/javascript">
437 /*<![CDATA[*/
438 window.onload = function(){asciidoc.footnotes();}
439 var asciidoc = { // Namespace.
440
441 /////////////////////////////////////////////////////////////////////
442 // Table Of Contents generator
443 /////////////////////////////////////////////////////////////////////
444
445 /* Author: Mihai Bazon, September 2002
446 * http://students.infoiasi.ro/~mishoo
447 *
448 * Table Of Content generator
449 * Version: 0.4
450 *
451 * Feel free to use this script under the terms of the GNU General Public
452 * License, as long as you do not remove or alter this notice.
453 */
454
455 /* modified by Troy D. Hanson, September 2006. License: GPL */
456 /* modified by Stuart Rackham, 2006, 2009. License: GPL */
457
458 // toclevels = 1..4.
459 toc: function (toclevels) {
460
461 function getText(el) {
462 var text = "";
463 for (var i = el.firstChild; i != null; i = i.nextSibling) {
464 if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
465 text += i.data;
466 else if (i.firstChild != null)
467 text += getText(i);
468 }
469 return text;
470 }
471
472 function TocEntry(el, text, toclevel) {
473 this.element = el;
474 this.text = text;
475 this.toclevel = toclevel;
476 }
477
478 function tocEntries(el, toclevels) {
479 var result = new Array;
480 var re = new RegExp('[hH]([2-'+(toclevels+1)+'])');
481 // Function that scans the DOM tree for header elements (the DOM2
482 // nodeIterator API would be a better technique but not supported by all
483 // browsers).
484 var iterate = function (el) {
485 for (var i = el.firstChild; i != null; i = i.nextSibling) {
486 if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
487 var mo = re.exec(i.tagName);
488 if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
489 result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
490 }
491 iterate(i);
492 }
493 }
494 }
495 iterate(el);
496 return result;
497 }
498
499 var toc = document.getElementById("toc");
500 var entries = tocEntries(document.getElementById("content"), toclevels);
501 for (var i = 0; i < entries.length; ++i) {
502 var entry = entries[i];
503 if (entry.element.id == "")
504 entry.element.id = "_toc_" + i;
505 var a = document.createElement("a");
506 a.href = "#" + entry.element.id;
507 a.appendChild(document.createTextNode(entry.text));
508 var div = document.createElement("div");
509 div.appendChild(a);
510 div.className = "toclevel" + entry.toclevel;
511 toc.appendChild(div);
512 }
513 if (entries.length == 0)
514 toc.parentNode.removeChild(toc);
515 },
516
517
518 /////////////////////////////////////////////////////////////////////
519 // Footnotes generator
520 /////////////////////////////////////////////////////////////////////
521
522 /* Based on footnote generation code from:
523 * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
524 */
525
526 footnotes: function () {
527 var cont = document.getElementById("content");
528 var noteholder = document.getElementById("footnotes");
529 var spans = cont.getElementsByTagName("span");
530 var refs = {};
531 var n = 0;
532 for (i=0; i<spans.length; i++) {
533 if (spans[i].className == "footnote") {
534 n++;
535 // Use [\s\S] in place of . so multi-line matches work.
536 // Because JavaScript has no s (dotall) regex flag.
537 note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
538 noteholder.innerHTML +=
539 "<div class='footnote' id='_footnote_" + n + "'>" +
540 "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
541 n + "</a>. " + note + "</div>";
542 spans[i].innerHTML =
543 "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
544 "' title='View footnote' class='footnote'>" + n + "</a>]";
545 var id =spans[i].getAttribute("id");
546 if (id != null) refs["#"+id] = n;
547 }
548 }
549 if (n == 0)
550 noteholder.parentNode.removeChild(noteholder);
551 else {
552 // Process footnoterefs.
553 for (i=0; i<spans.length; i++) {
554 if (spans[i].className == "footnoteref") {
555 var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
556 href = href.match(/#.*/)[0]; // Because IE return full URL.
557 n = refs[href];
558 spans[i].innerHTML =
559 "[<a href='#_footnote_" + n +
560 "' title='View footnote' class='footnote'>" + n + "</a>]";
561 }
562 }
563 }
564 }
565
566 }
567 /*]]>*/
568 </script>
10 </head> 569 </head>
11 <body> 570 <body>
571 <div id="header">
572 <h1>
573 MCABBER(1) Manual Page
574 </h1>
575 <h2>NAME</h2>
576 <div class="sectionbody">
577 <p>mcabber -
578 a simple Jabber (XMPP) console client
579 </p>
580 </div>
581 </div>
12 <div id="content"> 582 <div id="content">
13 <h1>MCABBER(1) Manual Page</h1> 583 <h2 id="_synopsis">SYNOPSIS</h2>
14 <h2>NAME</h2> 584 <div class="sectionbody">
15 <p>mcabber - 585 <div class="paragraph"><p><em>mcabber</em> [ -h | -V | -f configfile ]</p></div>
16 a simple Jabber console client
17 </p>
18 <div id="synopsis">
19 <h2>SYNOPSIS</h2>
20 <p><b>mcabber</b> [ -h | -V | -f configfile ]</p>
21 </div> 586 </div>
22 <h2>DESCRIPTION</h2> 587 <h2 id="_description">DESCRIPTION</h2>
23 <p><tt>mcabber(1)</tt> is a small Jabber console client.<br /> 588 <div class="sectionbody">
589 <div class="paragraph"><p><tt>mcabber(1)</tt> is a small Jabber (XMPP) console client.<br />
24 For now it needs a configuration file to start, so please copy the sample 590 For now it needs a configuration file to start, so please copy the sample
25 mcabberrc file and adapt your connection settings.</p> 591 mcabberrc file and adapt your connection settings.</p></div>
26 <p>You also need to have an existing Jabber account to use this software, as 592 <div class="paragraph"><p>You also need to have an existing Jabber account to use this software, as
27 it cannot (un)register accounts yet.</p> 593 it cannot (un)register accounts yet.</p></div>
28 <p>Here are some of the features of <tt>mcabber</tt>:</p> 594 <div class="paragraph"><p>Here are some of the features of <tt>mcabber</tt>:</p></div>
29 <ul> 595 <div class="ulist"><ul>
30 <li> 596 <li>
31 <p> 597 <p>
32 <b>SSL/TLS support</b>. 598 <em>SASL/SSL/TLS support</em>.
33 </p> 599 </p>
34 </li> 600 </li>
35 <li> 601 <li>
36 <p> 602 <p>
37 <b>MUC support</b> (Multi-User Chat). 603 <em>MUC support</em> (Multi-User Chat).
38 </p> 604 </p>
39 </li> 605 </li>
40 <li> 606 <li>
41 <p> 607 <p>
42 <b>PGP support</b> 608 <em>PGP, OTR support</em>
43 </p> 609 </p>
44 </li> 610 </li>
45 <li> 611 <li>
46 <p> 612 <p>
47 <b>Chat States</b> support (typing notifications) 613 <em>Chat States</em> support (typing notifications)
48 </p> 614 </p>
49 </li> 615 </li>
50 <li> 616 <li>
51 <p> 617 <p>
52 <b>History logging:</b> If enabled (see the CONFIGURATION FILE section), 618 <em>History logging:</em> If enabled (see the CONFIGURATION FILE section),
53 <tt>mcabber</tt> can save discussions to history log files. 619 <tt>mcabber</tt> can save discussions to text history log files.
54 </p> 620 </p>
55 </li> 621 </li>
56 <li> 622 <li>
57 <p> 623 <p>
58 <b>Commands completion:</b> If possible, <tt>mcabber</tt> will try to complete your 624 <em>Commands completion:</em> If possible, <tt>mcabber</tt> will try to complete your
59 command line if you hit the Tab key. 625 command line if you hit the Tab key.
60 </p> 626 </p>
61 </li> 627 </li>
62 <li> 628 <li>
63 <p> 629 <p>
64 <b>Input line history:</b> Any message or command entered is in the input line 630 <em>Input line history:</em> Any message or command entered is in the input line
65 history and can be reused easily. 631 history and can be reused easily.
66 </p> 632 </p>
67 </li> 633 </li>
68 <li> 634 <li>
69 <p> 635 <p>
70 <b>External actions:</b> Some events (like receiving a message) can trigger an 636 <em>External actions:</em> Some events (like receiving a message) can trigger an
71 external action such as a shell script if you enable it in your 637 external action such as a shell script if you enable it in your
72 configuration file. A sample events script ("eventcmd") is provided with 638 configuration file. A sample events script ("eventcmd") is provided with
73 <tt>mcabber</tt> source code, in the contrib directory. 639 <tt>mcabber</tt> source code, in the contrib directory.
74 </p> 640 </p>
75 </li> 641 </li>
76 </ul> 642 <li>
77 <h2>OPTIONS</h2> 643 <p>
78 <dl> 644 <em>Modules:</em> <tt>mcabber</tt> can load modules (a.k.a. plugins) at runtime that
79 <dt><b> 645 extend its features.
80 --help, -h 646 </p>
81 </b></dt> 647 </li>
82 <dd> 648 </ul></div>
649 </div>
650 <h2 id="_options">OPTIONS</h2>
651 <div class="sectionbody">
652 <div class="dlist"><dl>
653 <dt class="hdlist1">
654 -h
655 </dt>
656 <dd>
657 <p>
83 Quick help usage message 658 Quick help usage message
84 </dd> 659 </p>
85 <dt><b> 660 </dd>
661 <dt class="hdlist1">
662 -V
663 </dt>
664 <dd>
665 <p>
666 Displays <tt>mcabber</tt> version and compile-time definitions.
667 </p>
668 </dd>
669 <dt class="hdlist1">
86 -f configfile 670 -f configfile
87 </b></dt> 671 </dt>
88 <dd> 672 <dd>
89 Use configuration file <b>configfile</b> 673 <p>
90 </dd> 674 Use configuration file <em>configfile</em>
91 </dl> 675 </p>
92 <h2>WINDOWS/PANES</h2> 676 </dd>
93 <p>The <tt>mcabber(1)</tt> screen is divided into 4 regions. 677 </dl></div>
94 The <b>roster</b>, alias <b>buddylist</b>, is on the left. The <b>chat window</b>, or chat 678 </div>
95 buffer, is on the right. The <b>input line</b> lies at the bottom of the screen, 679 <h2 id="_windows_panes">WINDOWS/PANES</h2>
96 under a small <b>log window</b>.</p> 680 <div class="sectionbody">
97 <p>Two status lines surround the log window. The bottom status line is the 681 <div class="paragraph"><p>The <tt>mcabber(1)</tt> screen is divided into 4 regions.
682 The <em>roster</em>, alias <em>buddylist</em>, is on the left. The <em>chat window</em>, or chat
683 buffer, is on the right. The <em>input line</em> lies at the bottom of the screen,
684 under a small <em>log window</em>.</p></div>
685 <div class="paragraph"><p>Two status lines surround the log window. The bottom status line is the
98 "main status line" and reflects mcabber general status. The other line 686 "main status line" and reflects mcabber general status. The other line
99 is the "chat status line" and shows the status of the currently selected 687 is the "chat status line" and shows the status of the currently selected
100 buddy.</p> 688 buddy.</p></div>
101 <p>To display buddies chat buffers, you will have to enter <b>chat mode</b>. 689 <div class="paragraph"><p>To display buddies chat buffers, you will have to enter <em>chat mode</em>.
102 You can enter chat mode by pressing enter, and leave chat mode with the ESC 690 You can enter chat mode by pressing enter, and leave chat mode with the ESC
103 key. Simply sending a message will also enable chat mode.</p> 691 key. Simply sending a message will also enable chat mode.</p></div>
104 <p>There are several advantages to the two-mode implementation: first, it allows 692 <div class="paragraph"><p>There are several advantages to the two-mode implementation: first, it allows
105 accurate "unread" message functionality, as described in the next section; 693 accurate "unread" message functionality, as described in the next section;
106 without this, merely scrolling to a specific buddy will "read" the new 694 without this, merely scrolling to a specific buddy will "read" the new
107 messages of all buddies in-between. Second, it allows quickly hiding the 695 messages of all buddies in-between. Second, it allows quickly hiding the
108 conversation with a single keystroke. Third, it allows jumping between 696 conversation with a single keystroke. Third, it allows jumping between
109 the few buddies with whom you are conversing with the <b>/roster alternate</b> 697 the few buddies with whom you are conversing with the <em>/roster alternate</em>
110 command described in another section, without having to manually scroll 698 command described in another section, without having to manually scroll
111 back and forth.</p> 699 back and forth.</p></div>
112 <h2>KEYS</h2> 700 </div>
113 <p>Text typing occurs in the <b>input line</b>; basic operations are supported 701 <h2 id="_keys">KEYS</h2>
114 (left arrow, right arrow, home/end keys, insert, delete, backspace&#8230;).</p> 702 <div class="sectionbody">
115 <p>PageUp and PageDown keys are used to move in the roster.</p> 703 <div class="paragraph"><p>Text typing occurs in the <em>input line</em>; basic operations are supported
116 <p>Up and Down arrow keys can be used to move in the input line history; they 704 (left arrow, right arrow, home/end keys, insert, delete, backspace&#8230;).</p></div>
705 <div class="paragraph"><p>PageUp and PageDown keys are used to move in the roster.</p></div>
706 <div class="paragraph"><p>Up and Down arrow keys can be used to move in the input line history; they
117 jump to the previous/next line from the history beginning with the same string 707 jump to the previous/next line from the history beginning with the same string
118 (from first column to the cursor column).</p> 708 (from first column to the cursor column).</p></div>
119 <p>To send a message, move to the choosen buddy in the buddylist, type your 709 <div class="paragraph"><p>To send a message, move to the chosen buddy in the buddylist, type your
120 message and hit enter. If the line begins with a slash, this will be 710 message and hit enter. If the line begins with a slash, this will be
121 interpreted as a command (see the COMMAND section below). Hit escape to 711 interpreted as a command (see the COMMAND section below). Hit escape to
122 leave the chat mode.</p> 712 leave the chat mode.</p></div>
123 <p>Here is a quick description of the key bindings:</p> 713 <div class="paragraph"><p>Here is a quick description of the default key bindings:</p></div>
124 <table class="hlist"> 714 <div class="dlist"><dl>
125 <tr valign="top"> 715 <dt class="hdlist1">
126 <td>
127 Esc 716 Esc
128 </td> 717 </dt>
129 <td> 718 <dd>
719 <p>
130 Disable chat mode 720 Disable chat mode
131 </td> 721 </p>
132 </tr> 722 </dd>
133 <tr valign="top"> 723 <dt class="hdlist1">
134 <td>
135 Ctrl-a 724 Ctrl-a
136 </td> 725 </dt>
137 <td> 726 <dd>
727 <p>
138 Go to the beginning of the input line 728 Go to the beginning of the input line
139 </td> 729 </p>
140 </tr> 730 </dd>
141 <tr valign="top"> 731 <dt class="hdlist1">
142 <td>
143 Ctrl-e 732 Ctrl-e
144 </td> 733 </dt>
145 <td> 734 <dd>
735 <p>
146 Go to the end of the input line 736 Go to the end of the input line
147 </td> 737 </p>
148 </tr> 738 </dd>
149 <tr valign="top"> 739 <dt class="hdlist1">
150 <td>
151 Ctrl-l 740 Ctrl-l
152 </td> 741 </dt>
153 <td> 742 <dd>
743 <p>
154 Force a refresh 744 Force a refresh
155 </td> 745 </p>
156 </tr> 746 </dd>
157 <tr valign="top"> 747 <dt class="hdlist1">
158 <td>
159 Up/Down 748 Up/Down
160 </td> 749 </dt>
161 <td> 750 <dd>
751 <p>
162 Move in the input line history 752 Move in the input line history
163 </td> 753 </p>
164 </tr> 754 </dd>
165 <tr valign="top"> 755 <dt class="hdlist1">
166 <td>
167 PgUp/PgDown 756 PgUp/PgDown
168 </td> 757 </dt>
169 <td> 758 <dd>
759 <p>
170 Move inside the roster (buddylist) 760 Move inside the roster (buddylist)
171 </td> 761 </p>
172 </tr> 762 </dd>
173 <tr valign="top"> 763 <dt class="hdlist1">
174 <td>
175 Tab 764 Tab
176 </td> 765 </dt>
177 <td> 766 <dd>
767 <p>
178 Complete current word, in the input line 768 Complete current word, in the input line
179 </td> 769 </p>
180 </tr> 770 </dd>
181 <tr valign="top"> 771 <dt class="hdlist1">
182 <td>
183 Ctrl-g 772 Ctrl-g
184 </td> 773 </dt>
185 <td> 774 <dd>
775 <p>
186 Cancel completion 776 Cancel completion
187 </td> 777 </p>
188 </tr> 778 </dd>
189 <tr valign="top"> 779 <dt class="hdlist1">
190 <td>
191 Ctrl-c 780 Ctrl-c
192 </td> 781 </dt>
193 <td> 782 <dd>
783 <p>
194 Abort multi-line messages and completions 784 Abort multi-line messages and completions
195 </td> 785 </p>
196 </tr> 786 </dd>
197 <tr valign="top"> 787 <dt class="hdlist1">
198 <td>
199 Ctrl-d 788 Ctrl-d
200 </td> 789 </dt>
201 <td> 790 <dd>
791 <p>
202 Send/terminate a multi-line message 792 Send/terminate a multi-line message
203 </td> 793 </p>
204 </tr> 794 </dd>
205 <tr valign="top"> 795 <dt class="hdlist1">
206 <td>
207 Ctrl-p/Ctrl-n 796 Ctrl-p/Ctrl-n
208 </td> 797 </dt>
209 <td> 798 <dd>
799 <p>
210 Scroll up/down half a screen in the buffer window (chat mode) 800 Scroll up/down half a screen in the buffer window (chat mode)
211 </td> 801 </p>
212 </tr> 802 </dd>
213 <tr valign="top"> 803 <dt class="hdlist1">
214 <td>
215 Ctrl-Left 804 Ctrl-Left
216 </td> 805 </dt>
217 <td> 806 <dd>
807 <p>
218 Move the cursor back to the start of the current or previous word 808 Move the cursor back to the start of the current or previous word
219 </td> 809 </p>
220 </tr> 810 </dd>
221 <tr valign="top"> 811 <dt class="hdlist1">
222 <td>
223 Ctrl-Right 812 Ctrl-Right
224 </td> 813 </dt>
225 <td> 814 <dd>
815 <p>
226 Move the cursor forward to the end of the current or next word 816 Move the cursor forward to the end of the current or next word
227 </td> 817 </p>
228 </tr> 818 </dd>
229 <tr valign="top"> 819 <dt class="hdlist1">
230 <td>
231 Ctrl-u 820 Ctrl-u
232 </td> 821 </dt>
233 <td> 822 <dd>
823 <p>
234 Delete from beginning of the line to the cursor 824 Delete from beginning of the line to the cursor
235 </td> 825 </p>
236 </tr> 826 </dd>
237 <tr valign="top"> 827 <dt class="hdlist1">
238 <td>
239 Ctrl-k 828 Ctrl-k
240 </td> 829 </dt>
241 <td> 830 <dd>
831 <p>
242 Delete from the cursor to the end of line 832 Delete from the cursor to the end of line
243 </td> 833 </p>
244 </tr> 834 </dd>
245 <tr valign="top"> 835 <dt class="hdlist1">
246 <td>
247 Ctrl-w 836 Ctrl-w
248 </td> 837 </dt>
249 <td> 838 <dd>
839 <p>
250 Backward kill word 840 Backward kill word
251 </td> 841 </p>
252 </tr> 842 </dd>
253 <tr valign="top"> 843 <dt class="hdlist1">
254 <td>
255 Ctrl-t 844 Ctrl-t
256 </td> 845 </dt>
257 <td> 846 <dd>
847 <p>
258 Transpose chars 848 Transpose chars
259 </td> 849 </p>
260 </tr> 850 </dd>
261 <tr valign="top"> 851 <dt class="hdlist1">
262 <td>
263 Ctrl-o 852 Ctrl-o
264 </td> 853 </dt>
265 <td> 854 <dd>
855 <p>
266 Accept line and put the next history line in the input line (accept-line-and-down-history) 856 Accept line and put the next history line in the input line (accept-line-and-down-history)
267 </td> 857 </p>
268 </tr> 858 </dd>
269 </table> 859 </dl></div>
270 <p>Additional key bindings may be specified using the <b>/bind</b> command described 860 <div class="paragraph"><p>Additional key bindings may be specified using the <em>/bind</em> command described
271 in the COMMANDS section.</p> 861 in the COMMANDS section.</p></div>
272 <h2>MCABBER'S ROSTER</h2> 862 </div>
273 <p>The first listed resource on the roster is <b>[status]</b>, which keeps a log of 863 <h2 id="_mcabber_8217_s_roster">MCABBER&#8217;S ROSTER</h2>
864 <div class="sectionbody">
865 <div class="paragraph"><p>The first listed resource on the roster is <em>[status]</em>, which keeps a log of
274 everything that appears in the short log window below the main chat area. 866 everything that appears in the short log window below the main chat area.
275 While the log window was designed for showing the latest few elements, the 867 While the log window was designed for showing the latest few elements, the
276 dedicated <b>[status]</b> buffer allows more comfortable viewing of the log, as 868 dedicated <em>[status]</em> buffer allows more comfortable viewing of the log, as
277 well as scrolling it in a standard manner.</p> 869 well as scrolling it in a standard manner.</p></div>
278 <p>Group names are displayed above the resources that are within them, and are 870 <div class="paragraph"><p>Group names are displayed above the resources that are within them, and are
279 indicated by <b>---</b> to the left of the name.</p> 871 indicated by <em>---</em> to the left of the name.</p></div>
280 <p>For every real Jabber resource, the roster displays four pieces of information: 872 <div class="paragraph"><p>For every real Jabber resource, the roster displays four pieces of information:
281 the resource's name or alias, its online status, its authorization status, and 873 the resource&#8217;s name or alias, its online status, its authorization status, and
282 whether there are unread messages from the resource waiting for you.</p> 874 whether there are unread messages from the resource waiting for you.</p></div>
283 <p>The online status is one of the following:</p> 875 <div class="paragraph"><p>The online status is one of the following:</p></div>
284 <table class="hlist"> 876 <div class="dlist"><dl>
285 <tr valign="top"> 877 <dt class="hdlist1">
286 <td> 878 <em>o</em>
287 <b>o</b> 879 </dt>
288 </td> 880 <dd>
289 <td> 881 <p>
290 online 882 online
291 </td> 883 </p>
292 </tr> 884 </dd>
293 <tr valign="top"> 885 <dt class="hdlist1">
294 <td> 886 <em>f</em>
295 <b>f</b> 887 </dt>
296 </td> 888 <dd>
297 <td> 889 <p>
298 free for chat 890 free for chat
299 </td> 891 </p>
300 </tr> 892 </dd>
301 <tr valign="top"> 893 <dt class="hdlist1">
302 <td> 894 <em>a</em>
303 <b>a</b> 895 </dt>
304 </td> 896 <dd>
305 <td> 897 <p>
306 away 898 away
307 </td> 899 </p>
308 </tr> 900 </dd>
309 <tr valign="top"> 901 <dt class="hdlist1">
310 <td> 902 <em>n</em>
311 <b>n</b> 903 </dt>
312 </td> 904 <dd>
313 <td> 905 <p>
314 not available (labeled <b>extended away</b> in some clients) 906 not available (labeled <em>extended away</em> in some clients)
315 </td> 907 </p>
316 </tr> 908 </dd>
317 <tr valign="top"> 909 <dt class="hdlist1">
318 <td> 910 <em>d</em>
319 <b>d</b> 911 </dt>
320 </td> 912 <dd>
321 <td> 913 <p>
322 do not disturb 914 do not disturb
323 </td> 915 </p>
324 </tr> 916 </dd>
325 <tr valign="top"> 917 <dt class="hdlist1">
326 <td> 918 <em>i</em>
327 <b>i</b> 919 </dt>
328 </td> 920 <dd>
329 <td> 921 <p>
330 invisible (displayed only for your resource) 922 invisible (displayed only for your resource)
331 </td> 923 </p>
332 </tr> 924 </dd>
333 <tr valign="top"> 925 <dt class="hdlist1">
334 <td> 926 <em>_</em>
335 <b>_</b> 927 </dt>
336 </td> 928 <dd>
337 <td> 929 <p>
338 offline (or invisible to you) 930 offline (or invisible to you)
339 </td> 931 </p>
340 </tr> 932 </dd>
341 <tr valign="top"> 933 <dt class="hdlist1">
342 <td> 934 <em>?</em>
343 <b>?</b> 935 </dt>
344 </td> 936 <dd>
345 <td> 937 <p>
346 unknown, usually meaning you are not authorized to see this resource's status 938 unknown, usually meaning you are not authorized to see this resource&#8217;s status
347 </td> 939 </p>
348 </tr> 940 </dd>
349 <tr valign="top"> 941 <dt class="hdlist1">
350 <td> 942 <em>x</em>
351 <b>x</b> 943 </dt>
352 </td> 944 <dd>
353 <td> 945 <p>
354 a conference room in which you are not participating 946 a conference room in which you are not participating
355 </td> 947 </p>
356 </tr> 948 </dd>
357 <tr valign="top"> 949 <dt class="hdlist1">
358 <td> 950 <em>C</em>
359 <b>C</b> 951 </dt>
360 </td> 952 <dd>
361 <td> 953 <p>
362 a conference room in which you are participating 954 a conference room in which you are participating
363 </td> 955 </p>
364 </tr> 956 </dd>
365 </table> 957 </dl></div>
366 <p>The authorization status indicates whether a resource is authorized to receive 958 <div class="paragraph"><p>The authorization status indicates whether a resource is authorized to receive
367 your online status updates, and is displayed by the brackets surrounding the 959 your online status updates, and is displayed by the brackets surrounding the
368 resource's online status. Square brackets, like <b>[o]</b>, indicate that this 960 resource&#8217;s online status. Square brackets, like <em>[o]</em>, indicate that this
369 resource is authorized to receive your status. Curly braces, like <b>{o}</b>, 961 resource is authorized to receive your status. Curly braces, like <em>{o}</em>,
370 indicate that they are not authorized to receive your status.</p> 962 indicate that they are not authorized to receive your status.</p></div>
371 <p>When there are unread messages from the resource which you have not looked at, 963 <div class="paragraph"><p>When there are unread messages from the resource which you have not looked at,
372 a hash mark (<b>#</b>) appears in the leftmost section of the roster for that 964 a hash mark (<em>#</em>) appears in the leftmost section of the roster for that
373 resource. The hash mark disappears once you view that resource's message log.</p> 965 resource. The hash mark disappears once you view that resource&#8217;s message log.</p></div>
374 <p>Examples:</p> 966 <div class="paragraph"><p>Examples:</p></div>
375 <table class="hlist"> 967 <div class="dlist"><dl>
376 <tr valign="top"> 968 <dt class="hdlist1">
377 <td> 969 <em>--- Buds</em>
378 <b> --- Buds</b> 970 </dt>
379 </td> 971 <dd>
380 <td> 972 <p>
381 This is a group named <b>Buds</b> 973 This is a group named <em>Buds</em>
382 </td> 974 </p>
383 </tr> 975 </dd>
384 <tr valign="top"> 976 <dt class="hdlist1">
385 <td> 977 <em>#[o] John</em>
386 <b>#[o] John</b> 978 </dt>
387 </td> 979 <dd>
388 <td> 980 <p>
389 John is online, can see your status, and sent you a message that you did not read yet 981 John is online, can see your status, and sent you a message that you did not read yet
390 </td> 982 </p>
391 </tr> 983 </dd>
392 <tr valign="top"> 984 <dt class="hdlist1">
393 <td> 985 <em>{?} Sally</em>
394 <b> {?} Sally</b> 986 </dt>
395 </td> 987 <dd>
396 <td> 988 <p>
397 Neither you nor Sally have authorized each other to see your online status 989 Neither you nor Sally have authorized each other to see your online status
398 </td> 990 </p>
399 </tr> 991 </dd>
400 <tr valign="top"> 992 <dt class="hdlist1">
401 <td> 993 <em>{a} Jane</em>
402 <b> {a} Jane</b> 994 </dt>
403 </td> 995 <dd>
404 <td> 996 <p>
405 Jane is away, but she cannot see your online status 997 Jane is away, but she cannot see your online status
406 </td> 998 </p>
407 </tr> 999 </dd>
408 <tr valign="top"> 1000 <dt class="hdlist1">
409 <td> 1001 <em>#[C] x@y.c</em>
410 <b>#[C] x@y.c</b> 1002 </dt>
411 </td> 1003 <dd>
412 <td> 1004 <p>
413 You are participating in x@y.c conference room, and there are unread messages 1005 You are participating in x@y.c conference room, and there are unread messages
414 </td> 1006 </p>
415 </tr> 1007 </dd>
416 </table> 1008 </dl></div>
417 <h2>COMMANDS</h2> 1009 </div>
418 <p>Please refer to the online help (command /help), it is probably more up-to-date than this manpage. Furthermore, help files have been translated into several languages.<br /> 1010 <h2 id="_commands">COMMANDS</h2>
419 You will find an overview of the <tt>mcabber</tt> commands in this manual.</p> 1011 <div class="sectionbody">
420 <h2>COMMANDS RELATED TO MCABBER</h2> 1012 <div class="paragraph"><p>Please refer to the online help (command /help), it is probably more up-to-date than this manpage. Furthermore, help files have been translated into several languages.<br />
421 <dl> 1013 You will find an overview of the <tt>mcabber</tt> commands in this manual.</p></div>
422 <dt><b> 1014 </div>
1015 <h2 id="_commands_related_to_mcabber">COMMANDS RELATED TO MCABBER</h2>
1016 <div class="sectionbody">
1017 <div class="dlist"><dl>
1018 <dt class="hdlist1">
1019 /add [jid [nickname]]
1020 </dt>
1021 <dd>
1022 <p>
1023 Add the "jid" Jabber user to our roster (default group), and send a notification request to this buddy. If no nickname is specified, the jid is used. If no jid (or an empty string "") is provided or if jid is ".", the current buddy is used.
1024 </p>
1025 <div class="dlist"><dl>
1026 <dt class="hdlist1">
1027 [<em>jid</em> [nickname]]
1028 </dt>
1029 <dd>
1030 <p>
1031 Add to our roster "jid" as "nickname"
1032 </p>
1033 <div class="literalblock">
1034 <div class="content">
1035 <pre><tt>Example: "/add somebody@jabber.server.com Somebody"</tt></pre>
1036 </div></div>
1037 </dd>
1038 </dl></div>
1039 </dd>
1040 <dt class="hdlist1">
423 /alias [name [= command line]] 1041 /alias [name [= command line]]
424 </b></dt> 1042 </dt>
425 <dd> 1043 <dd>
426 Add "name" as an alias for "command line". <tt> 1044 <p>
427 Aliases are expanded only once, thus they can not be chained. </tt> 1045 This command let you to add aliases which can simplify sophisticated commands.<br />
428 "/alias name" displays the value associated with the "name" alias; <tt> 1046 You can manage your aliases by:
429 "/alias name =" unsets the "name" alias. </tt> 1047 </p>
430 "/alias" displays a list of the existing aliases.<br /> 1048 <div class="dlist"><dl>
431 Example: "/alias away = status away". 1049 <dt class="hdlist1">
432 </dd> 1050 (without arguments)
433 <dt><b> 1051 </dt>
1052 <dd>
1053 <p>
1054 Print list of currently defined aliases
1055 </p>
1056 </dd>
1057 <dt class="hdlist1">
1058 <em>name</em>
1059 </dt>
1060 <dd>
1061 <p>
1062 Print the value of alias called "name"
1063 </p>
1064 </dd>
1065 <dt class="hdlist1">
1066 <em>name</em>=
1067 </dt>
1068 <dd>
1069 <p>
1070 Unset alias called "name"
1071 </p>
1072 </dd>
1073 <dt class="hdlist1">
1074 <em>name</em> = command line
1075 </dt>
1076 <dd>
1077 <p>
1078 Set alias called "name" with value "command line"
1079 </p>
1080 <div class="literalblock">
1081 <div class="content">
1082 <pre><tt>Example: "/alias away = status away"</tt></pre>
1083 </div></div>
1084 </dd>
1085 </dl></div>
1086 </dd>
1087 <dt class="hdlist1">
1088 /authorization allow|cancel|request|request_unsubscribe [jid]
1089 </dt>
1090 <dd>
1091 <p>
1092 This command manages presence subscriptions: it allows you to request presence subscriptions from others on your roster, and allows you to control who receives your presence notifications.<br />
1093 If no JID is provided, the currently-selected buddy is used.
1094 </p>
1095 <div class="dlist"><dl>
1096 <dt class="hdlist1">
1097 <em>allow</em>
1098 </dt>
1099 <dd>
1100 <p>
1101 Allow the buddy to receive your presence updates
1102 </p>
1103 </dd>
1104 <dt class="hdlist1">
1105 <em>cancel</em>
1106 </dt>
1107 <dd>
1108 <p>
1109 Cancel the buddy&#8217;s subscription to your presence updates
1110 </p>
1111 </dd>
1112 <dt class="hdlist1">
1113 <em>request</em>
1114 </dt>
1115 <dd>
1116 <p>
1117 Request a subscription to the buddy&#8217;s presence updates
1118 </p>
1119 </dd>
1120 <dt class="hdlist1">
1121 <em>request_unsubscribe</em>
1122 </dt>
1123 <dd>
1124 <p>
1125 Request unsubscription from the buddy&#8217;s presence updates
1126 </p>
1127 </dd>
1128 </dl></div>
1129 </dd>
1130 <dt class="hdlist1">
434 /bind [keycode [= command line]] 1131 /bind [keycode [= command line]]
435 </b></dt> 1132 </dt>
436 <dd> 1133 <dd>
437 Bind a command line to the key with the "keycode" code number. <tt> 1134 <p>
438 Keycodes of unused keys are displayed by <tt>mcabber</tt> in the log window 1135 Bind the command to the key given as "keycode". To examine which keys are currently not used look at <tt>mcabber</tt> log window and press examined key. For example: "Unknown key=265" means that you can bind some command to key #265.
439 when pressing the key, for example "Unknown key=265". </tt> 1136 </p>
440 "/bind keycode" displays the command line bound to the given keycode; <tt> 1137 <div class="dlist"><dl>
441 "/bind keycode =" unbinds the given keycode. </tt> 1138 <dt class="hdlist1">
442 "/bind" displays a list of the bound keycodes. <tt> 1139 (without arguments)
443 Note: aliases can be used in key bindings. </tt> 1140 </dt>
444 Example: "/bind 265 = status online" (265 is F1 for me, but it may 1141 <dd>
445 depend on your ncurses installation). 1142 <p>
446 </dd> 1143 Display list of current bindings
447 <dt><b> 1144 </p>
448 /buffer clear|close|close_all|purge 1145 </dd>
449 </b></dt> 1146 <dt class="hdlist1">
450 <dt><b> 1147 <em>keycode</em>
1148 </dt>
1149 <dd>
1150 <p>
1151 Display the command line bound to this key
1152 </p>
1153 </dd>
1154 <dt class="hdlist1">
1155 <em>keycode</em>=
1156 </dt>
1157 <dd>
1158 <p>
1159 Unbind key with code "keycode"
1160 </p>
1161 </dd>
1162 <dt class="hdlist1">
1163 <em>keycode</em> = command line
1164 </dt>
1165 <dd>
1166 <p>
1167 Bind "command line" to the key with code "keycode"
1168 </p>
1169 <div class="literalblock">
1170 <div class="content">
1171 <pre><tt>Example: "/bind 265 = status away" (265 is F1). +
1172 Note: keycodes can be different depending on your ncurses configuration. +
1173 Tip: aliases also can be used instead of commands.</tt></pre>
1174 </div></div>
1175 </dd>
1176 </dl></div>
1177 </dd>
1178 <dt class="hdlist1">
1179 /buffer clear|close|close_all|purge|list
1180 </dt>
1181 <dt class="hdlist1">
451 /buffer top|bottom|date|%|search_backward|search_forward 1182 /buffer top|bottom|date|%|search_backward|search_forward
452 </b></dt> 1183 </dt>
453 <dt><b> 1184 <dt class="hdlist1">
454 /buffer scroll_lock|scroll_unlock|scroll_toggle 1185 /buffer scroll_lock|scroll_unlock|scroll_toggle
455 </b></dt> 1186 </dt>
456 <dd> 1187 <dt class="hdlist1">
457 The <b>buffer</b> command manipulates the current buddy's buffer 1188 /buffer save filename
458 (chat window). 1189 </dt>
459 <table class="hlist"> 1190 <dd>
460 <tr valign="top"> 1191 <p>
461 <td> 1192 Buddy&#8217;s buffer manipulation command. Eg. you can search through buffer for "text", clear chat window etc.
462 <b>clear</b> 1193 </p>
463 </td> 1194 <div class="dlist"><dl>
464 <td> 1195 <dt class="hdlist1">
465 clear the current buddy chat window 1196 <em>clear</em>
466 </td> 1197 </dt>
467 </tr> 1198 <dd>
468 <tr valign="top"> 1199 <p>
469 <td> 1200 Clear the current buddy chat window
470 <b>close</b> 1201 </p>
471 </td> 1202 </dd>
472 <td> 1203 <dt class="hdlist1">
473 empty all contents of the buffer and close the current buddy chat window 1204 <em>close</em> [jid]
474 </td> 1205 </dt>
475 </tr> 1206 <dd>
476 <tr valign="top"> 1207 <p>
477 <td> 1208 Empty all contents of the buffer and close the current buddy chat window
478 <b>close_all</b> 1209 </p>
479 </td> 1210 </dd>
480 <td> 1211 <dt class="hdlist1">
481 empty all contents of the chat buffers and close the chat windows 1212 <em>close_all</em>
482 </td> 1213 </dt>
483 </tr> 1214 <dd>
484 <tr valign="top"> 1215 <p>
485 <td> 1216 Empty all contents of the chat buffers and close the chat windows
486 <b>purge</b> 1217 </p>
487 </td> 1218 </dd>
488 <td> 1219 <dt class="hdlist1">
489 clear the current buddy chat window and empty all contents of the chat buffer 1220 <em>purge</em> [jid]
490 </td> 1221 </dt>
491 </tr> 1222 <dd>
492 <tr valign="top"> 1223 <p>
493 <td> 1224 Clear the current buddy chat window and empty all contents of the chat buffer
494 <b>top</b> 1225 </p>
495 </td> 1226 </dd>
496 <td> 1227 <dt class="hdlist1">
497 jump to the top of the current buddy chat buffer 1228 <em>list</em>
498 </td> 1229 </dt>
499 </tr> 1230 <dd>
500 <tr valign="top"> 1231 <p>
501 <td> 1232 Display the list of existing buffers, with their length (lines/blocks)
502 <b>bottom</b> 1233 </p>
503 </td> 1234 </dd>
504 <td> 1235 <dt class="hdlist1">
505 jump to the bottom of the current buddy chat buffer 1236 <em>top</em>
506 </td> 1237 </dt>
507 </tr> 1238 <dd>
508 <tr valign="top"> 1239 <p>
509 <td> 1240 Jump to the top of the current buddy chat buffer
510 <b>up</b> [n] 1241 </p>
511 </td> 1242 </dd>
512 <td> 1243 <dt class="hdlist1">
513 scroll the buffer up n lines (default: half a screen) 1244 <em>bottom</em>
514 </td> 1245 </dt>
515 </tr> 1246 <dd>
516 <tr valign="top"> 1247 <p>
517 <td> 1248 Jump to the bottom of the current buddy chat buffer
518 <b>down</b> [n] 1249 </p>
519 </td> 1250 </dd>
520 <td> 1251 <dt class="hdlist1">
521 scroll the buffer down n lines (default: half a screen) 1252 <em>up</em> [n]
522 </td> 1253 </dt>
523 </tr> 1254 <dd>
524 <tr valign="top"> 1255 <p>
525 <td> 1256 Scroll the buffer up [n] lines (default: half a screen)
526 <b>date</b> date 1257 </p>
527 </td> 1258 </dd>
528 <td> 1259 <dt class="hdlist1">
529 jump to the first line after the specified date in the chat buffer (date format: "YYYY-mm-dd[THH:MM:SS]", "-" and ":" are optional) 1260 <em>down</em> [n]
530 </td> 1261 </dt>
531 </tr> 1262 <dd>
532 <tr valign="top"> 1263 <p>
533 <td> 1264 Scroll the buffer down [n] lines (default: half a screen)
534 <b>%</b> n 1265 </p>
535 </td> 1266 </dd>
536 <td> 1267 <dt class="hdlist1">
537 jump to position %n of the buddy chat buffer 1268 <em>date</em> [date]
538 </td> 1269 </dt>
539 </tr> 1270 <dd>
540 <tr valign="top"> 1271 <p>
541 <td> 1272 Jump to the first line after the specified [date] in the chat buffer (date format: "YYYY-mm-dd")
542 <b>search_backward</b> text 1273 </p>
543 </td> 1274 </dd>
544 <td> 1275 <dt class="hdlist1">
545 search for "text" in the current buddy chat buffer 1276 % n
546 </td> 1277 </dt>
547 </tr> 1278 <dd>
548 <tr valign="top"> 1279 <p>
549 <td> 1280 Jump to position %n of the buddy chat buffer
550 <b>search_forward</b> text 1281 </p>
551 </td> 1282 </dd>
552 <td> 1283 <dt class="hdlist1">
553 search for "text" in the current buddy chat buffer 1284 <em>search_backward</em> text
554 </td> 1285 </dt>
555 </tr> 1286 <dd>
556 <tr valign="top"> 1287 <p>
557 <td> 1288 Search for [text] in the current buddy chat buffer
558 <b>scroll_lock</b> 1289 </p>
559 </td> 1290 </dd>
560 <td> 1291 <dt class="hdlist1">
561 lock buffer scrolling 1292 <em>search_forward</em> text
562 </td> 1293 </dt>
563 </tr> 1294 <dd>
564 <tr valign="top"> 1295 <p>
565 <td> 1296 Search for [text] in the current buddy chat buffer
566 <b>scroll_unlock</b> 1297 </p>
567 </td> 1298 </dd>
568 <td> 1299 <dt class="hdlist1">
569 unlock buffer scrolling 1300 <em>scroll_lock</em>
570 </td> 1301 </dt>
571 </tr> 1302 <dd>
572 <tr valign="top"> 1303 <p>
573 <td> 1304 Lock buffer scrolling
574 <b>scroll_toggle</b> 1305 </p>
575 </td> 1306 </dd>
576 <td> 1307 <dt class="hdlist1">
577 toggle buffer scrolling (lock/unlock) 1308 <em>scroll_unlock</em>
578 </td> 1309 </dt>
579 </tr> 1310 <dd>
580 </table> 1311 <p>
581 </dd> 1312 Unlock buffer scrolling
582 <dt><b> 1313 </p>
1314 </dd>
1315 <dt class="hdlist1">
1316 <em>scroll_toggle</em>
1317 </dt>
1318 <dd>
1319 <p>
1320 Toggle buffer scrolling (lock/unlock)
1321 </p>
1322 </dd>
1323 <dt class="hdlist1">
1324 <em>save</em> filename
1325 </dt>
1326 <dd>
1327 <p>
1328 Save the contents of the current buffer to the file "filename"
1329 </p>
1330 </dd>
1331 </dl></div>
1332 </dd>
1333 <dt class="hdlist1">
1334 /chat_disable [--show-roster]
1335 </dt>
1336 <dd>
1337 <p>
1338 Disable chat mode.<br />
1339 With --show-roster, the fullscreen mode will be disabled.
1340 </p>
1341 </dd>
1342 <dt class="hdlist1">
583 /clear 1343 /clear
584 </b></dt> 1344 </dt>
585 <dd> 1345 <dd>
586 The <b>clear</b> command is actually an alias for "/buffer clear". 1346 <p>
587 </dd> 1347 This command is actually an alias for "/buffer clear". It clears the current buddy chat window.
588 <dt><b> 1348 </p>
589 /help [command] 1349 </dd>
590 </b></dt> 1350 <dt class="hdlist1">
591 <dd> 1351 /color roster (status wildcard (color|-)|clear)
592 Display generic help or help about a specific mcabber command. 1352 </dt>
593 </dd> 1353 <dt class="hdlist1">
594 <dt><b> 1354 /color mucnick nick (color|-)
1355 </dt>
1356 <dt class="hdlist1">
1357 /color muc (jid|.|*) [on|preset|off|-]
1358 </dt>
1359 <dd>
1360 <p>
1361 The <em>color</em> command allows setting dynamic color properties of the screen.
1362 </p>
1363 <div class="dlist"><dl>
1364 <dt class="hdlist1">
1365 <em>roster</em> clear
1366 </dt>
1367 <dd>
1368 <p>
1369 Remove all color rules for the roster. All roster items will get its default color.
1370 </p>
1371 </dd>
1372 <dt class="hdlist1">
1373 <em>roster</em> status wildcard color
1374 </dt>
1375 <dd>
1376 <p>
1377 Set a color rule (or overwrite, if it already exists). The status is string containing all statuses the roster item can have for the rule to match, or * if any status is OK. Wildcard is the file-matching wildcard that will be applied to JID. Color is the wanted color. If color is -, the rule is removed. If more than one rule matches, the color from the last created (not overwritten) is used.
1378 </p>
1379 </dd>
1380 <dt class="hdlist1">
1381 <em>mucnick</em> nick (color|-)
1382 </dt>
1383 <dd>
1384 <p>
1385 Marks the nick to be colored by given color. If a MUC has colored nicks, this one will be used. If color is -, the color is marked as chosen automatically, which means it will not be used in <em>preset</em> coloring mode, but will stay the same in <em>on</em> coloring mode.
1386 </p>
1387 </dd>
1388 <dt class="hdlist1">
1389 <em>muc</em> (jid|.|*) [on|preset|off|-]
1390 </dt>
1391 <dd>
1392 <p>
1393 Sets a MUC nick coloring mode. If a jid (. means currently selected jid) is provided, the mode will apply to this specific MUC. If * is used, it will be applied to all MUCs, except the ones set by their jid. Mode <em>on</em> colors all nicks, <em>preset</em> only the ones manually set by /color mucnick command and <em>off</em> colors none. If not specified, defaults to <em>on</em>. Mode <em>-</em> removes the mode from given JID, which means the global one will apply. You can not remove the global mode. Default global coloring mode is <em>off</em>.
1394 </p>
1395 </dd>
1396 </dl></div>
1397 </dd>
1398 <dt class="hdlist1">
1399 /connect
1400 </dt>
1401 <dd>
1402 <p>
1403 Establish connection to the Jabber server.
1404 </p>
1405 </dd>
1406 <dt class="hdlist1">
1407 /del
1408 </dt>
1409 <dd>
1410 <p>
1411 Delete the current buddy from our roster, unsubscribe from its presence notification and unsubscribe it from ours.
1412 </p>
1413 </dd>
1414 <dt class="hdlist1">
1415 /disconnect
1416 </dt>
1417 <dd>
1418 <p>
1419 Terminate the connection to the Jabber server.<br />
1420 Note: the roster is only available when the connection to the server is active, so the buddylist is empty when disconnected.
1421 </p>
1422 </dd>
1423 <dt class="hdlist1">
1424 /echo message
1425 </dt>
1426 <dd>
1427 <p>
1428 Display "message" in the log window.
1429 </p>
1430 </dd>
1431 <dt class="hdlist1">
1432 /event #n|* accept|ignore|reject [event-specific arguments]
1433 </dt>
1434 <dt class="hdlist1">
1435 /event list
1436 </dt>
1437 <dd>
1438 <p>
1439 Tell mcabber what to do about pending events.<br />
1440 If the first parameter is <em>*</em>, the command will apply to all queued events.<br />
1441 Event-specific arguments will be interpreted on event-to event basis. The only built-in case, when argument is used is MUC invitation reject - argument, if present, will be interpreted as reject reason.
1442 </p>
1443 <div class="dlist"><dl>
1444 <dt class="hdlist1">
1445 #N|* accept [event-specific arguments]
1446 </dt>
1447 <dd>
1448 <p>
1449 Event number #N/All events will be accepted
1450 </p>
1451 </dd>
1452 <dt class="hdlist1">
1453 #N|* ignore [event-specific arguments]
1454 </dt>
1455 <dd>
1456 <p>
1457 Event number #N/All events will be ignored
1458 </p>
1459 </dd>
1460 <dt class="hdlist1">
1461 #N|* reject [event-specific arguments]
1462 </dt>
1463 <dd>
1464 <p>
1465 Event number #N/All events will be rejected
1466 </p>
1467 </dd>
1468 <dt class="hdlist1">
1469 <em>list</em>
1470 </dt>
1471 <dd>
1472 <p>
1473 List all pending events
1474 </p>
1475 </dd>
1476 </dl></div>
1477 </dd>
1478 <dt class="hdlist1">
1479 /group fold|unfold|toggle [groupname]
1480 </dt>
1481 <dd>
1482 <p>
1483 This command changes the current group display.
1484 </p>
1485 <div class="dlist"><dl>
1486 <dt class="hdlist1">
1487 <em>fold</em> [groupname]
1488 </dt>
1489 <dd>
1490 <p>
1491 Fold (shrink) the current/specified group tree in the roster
1492 </p>
1493 </dd>
1494 <dt class="hdlist1">
1495 <em>unfold</em> [groupname]
1496 </dt>
1497 <dd>
1498 <p>
1499 Unfold (expand) the current/specified group tree in the roster
1500 </p>
1501 </dd>
1502 <dt class="hdlist1">
1503 <em>toggle</em> [groupname]
1504 </dt>
1505 <dd>
1506 <p>
1507 Toggle the state (fold/unfold) of the current/specified tree
1508 </p>
1509 </dd>
1510 </dl></div>
1511 </dd>
1512 <dt class="hdlist1">
1513 /help [command|+topic]
1514 </dt>
1515 <dd>
1516 <p>
1517 Display help for command "command" or topic "topic".<br />
1518 Example: "/help buffer"
1519 </p>
1520 </dd>
1521 <dt class="hdlist1">
1522 /iline fchar|bchar|char_fdel|char_bdel|char_swap
1523 </dt>
1524 <dt class="hdlist1">
1525 /iline fword|bword|word_bdel|word_fdel
1526 </dt>
1527 <dt class="hdlist1">
1528 /iline word_upcase|word_downcase|word_capit
1529 </dt>
1530 <dt class="hdlist1">
1531 /iline hist_beginning_search_bwd|hist_beginning_search_fwd
1532 </dt>
1533 <dt class="hdlist1">
1534 /iline hist_prev|hist_next
1535 </dt>
1536 <dt class="hdlist1">
1537 /iline iline_start|iline_end|iline_fdel|iline_bdel
1538 </dt>
1539 <dt class="hdlist1">
1540 /iline iline_accept|iline_accept_down_hist
1541 </dt>
1542 <dt class="hdlist1">
1543 /iline compl_do|compl_cancel
1544 </dt>
1545 <dt class="hdlist1">
1546 /iline send_multiline
1547 </dt>
1548 <dd>
1549 <p>
1550 Input line commands
1551 </p>
1552 <div class="dlist"><dl>
1553 <dt class="hdlist1">
1554 <em>fchar</em>
1555 </dt>
1556 <dd>
1557 <p>
1558 Move to the next letter
1559 </p>
1560 </dd>
1561 <dt class="hdlist1">
1562 <em>bchar</em>
1563 </dt>
1564 <dd>
1565 <p>
1566 Move to the previous letter
1567 </p>
1568 </dd>
1569 <dt class="hdlist1">
1570 <em>char_fdel</em>
1571 </dt>
1572 <dd>
1573 <p>
1574 Delete the letter at cursor position
1575 </p>
1576 </dd>
1577 <dt class="hdlist1">
1578 <em>char_bdel</em>
1579 </dt>
1580 <dd>
1581 <p>
1582 Delete the letter before cursor position
1583 </p>
1584 </dd>
1585 <dt class="hdlist1">
1586 <em>char_swap</em>
1587 </dt>
1588 <dd>
1589 <p>
1590 Transpose chars
1591 </p>
1592 </dd>
1593 <dt class="hdlist1">
1594 <em>fword</em>
1595 </dt>
1596 <dd>
1597 <p>
1598 Move the cursor forward to the end of the current or next word
1599 </p>
1600 </dd>
1601 <dt class="hdlist1">
1602 <em>bword</em>
1603 </dt>
1604 <dd>
1605 <p>
1606 Move the cursor back to the start of the current or previous word
1607 </p>
1608 </dd>
1609 <dt class="hdlist1">
1610 <em>word_bdel</em>
1611 </dt>
1612 <dd>
1613 <p>
1614 Delete the word from cursor position to its start
1615 </p>
1616 </dd>
1617 <dt class="hdlist1">
1618 <em>word_fdel</em>
1619 </dt>
1620 <dd>
1621 <p>
1622 Delete the word from cursor position to its end
1623 </p>
1624 </dd>
1625 <dt class="hdlist1">
1626 <em>word_upcase</em>
1627 </dt>
1628 <dd>
1629 <p>
1630 Convert the word from cursor position to its end to upper case
1631 </p>
1632 </dd>
1633 <dt class="hdlist1">
1634 <em>word_downcase</em>
1635 </dt>
1636 <dd>
1637 <p>
1638 Convert the word from cursor position to its end to down case
1639 </p>
1640 </dd>
1641 <dt class="hdlist1">
1642 <em>word_capit</em>
1643 </dt>
1644 <dd>
1645 <p>
1646 Capitalize the word from cursor position to its end
1647 </p>
1648 </dd>
1649 <dt class="hdlist1">
1650 <em>hist_beginning_search_bwd</em>
1651 </dt>
1652 <dd>
1653 <p>
1654 Search backward in the history for a line beginning with the current line up to the cursor (this leaves the cursor in its original position)
1655 </p>
1656 </dd>
1657 <dt class="hdlist1">
1658 <em>hist_beginning_search_fwd</em>
1659 </dt>
1660 <dd>
1661 <p>
1662 Search forward in the history for a line beginning with the current line up to the cursor (this leaves the cursor in its original position)
1663 </p>
1664 </dd>
1665 <dt class="hdlist1">
1666 <em>hist_prev</em>
1667 </dt>
1668 <dd>
1669 <p>
1670 Previous line of input line history
1671 </p>
1672 </dd>
1673 <dt class="hdlist1">
1674 <em>hist_next</em>
1675 </dt>
1676 <dd>
1677 <p>
1678 Next line of input line history
1679 </p>
1680 </dd>
1681 <dt class="hdlist1">
1682 <em>iline_start</em>
1683 </dt>
1684 <dd>
1685 <p>
1686 Go to the beginning of the input line
1687 </p>
1688 </dd>
1689 <dt class="hdlist1">
1690 <em>iline_end</em>
1691 </dt>
1692 <dd>
1693 <p>
1694 Go to the end of the input line
1695 </p>
1696 </dd>
1697 <dt class="hdlist1">
1698 <em>iline_fdel</em>
1699 </dt>
1700 <dd>
1701 <p>
1702 Delete from the cursor to the end of line
1703 </p>
1704 </dd>
1705 <dt class="hdlist1">
1706 <em>iline_bdel</em>
1707 </dt>
1708 <dd>
1709 <p>
1710 Delete from beginning of the line to the cursor
1711 </p>
1712 </dd>
1713 <dt class="hdlist1">
1714 <em>iline_accept</em>
1715 </dt>
1716 <dd>
1717 <p>
1718 Accept line
1719 </p>
1720 </dd>
1721 <dt class="hdlist1">
1722 <em>iline_accept_down_hist</em>
1723 </dt>
1724 <dd>
1725 <p>
1726 Accept line and put the next history line in the input line
1727 </p>
1728 </dd>
1729 <dt class="hdlist1">
1730 <em>compl_do</em>
1731 </dt>
1732 <dd>
1733 <p>
1734 Complete current word, in the input line
1735 </p>
1736 </dd>
1737 <dt class="hdlist1">
1738 <em>compl_cancel</em>
1739 </dt>
1740 <dd>
1741 <p>
1742 Cancel completion
1743 </p>
1744 </dd>
1745 <dt class="hdlist1">
1746 <em>send_multiline</em>
1747 </dt>
1748 <dd>
1749 <p>
1750 Send/terminate a multi-line message
1751 </p>
1752 </dd>
1753 </dl></div>
1754 </dd>
1755 <dt class="hdlist1">
1756 /info
1757 </dt>
1758 <dd>
1759 <p>
1760 Display info on the selected entry (user, agent, group&#8230;).<br />
1761 For users, resources are displayed with the status, priority and status message (if available) of each resource.
1762 </p>
1763 </dd>
1764 <dt class="hdlist1">
1765 /module load|unload [-f] module
1766 </dt>
1767 <dt class="hdlist1">
1768 /module info module
1769 </dt>
1770 <dt class="hdlist1">
1771 /module [list]
1772 </dt>
1773 <dd>
1774 <p>
1775 Load, unload or show info on module.
1776 </p>
1777 <div class="dlist"><dl>
1778 <dt class="hdlist1">
1779 <em>load</em> [-f] module
1780 </dt>
1781 <dd>
1782 <p>
1783 Loads specified module. If -f flag is specified, most of module loading errors will be ignored.
1784 </p>
1785 </dd>
1786 <dt class="hdlist1">
1787 <em>unload</em> [-f] module
1788 </dt>
1789 <dd>
1790 <p>
1791 Unloads specified module. Note: The force flag will not remove any dependent on this modules!
1792 </p>
1793 </dd>
1794 <dt class="hdlist1">
1795 <em>info</em> module
1796 </dt>
1797 <dd>
1798 <p>
1799 Shows available information about this module.
1800 </p>
1801 </dd>
1802 <dt class="hdlist1">
1803 [<em>list</em>]
1804 </dt>
1805 <dd>
1806 <p>
1807 Lists modules in a format: [modulename] [reference count] ([Manually/Automatically loaded]) [any extra info, like version or dependencies]
1808 </p>
1809 </dd>
1810 </dl></div>
1811 </dd>
1812 <dt class="hdlist1">
1813 /move [groupname]
1814 </dt>
1815 <dd>
1816 <p>
1817 Move the current buddy to the requested group. If no group is specified, then the buddy is moved to the default group. If the group "groupname" doesn&#8217;t exist, it is created.<br />
1818 Tip: if the chatmode is enabled, you can use "/roster alternate" to jump to the moved buddy.
1819 </p>
1820 </dd>
1821 <dt class="hdlist1">
1822 /msay begin|verbatim|send|send_to|toggle|toggle_verbatim|abort
1823 </dt>
1824 <dd>
1825 <p>
1826 Send a multi-line message. To write a single message with several lines, the <em>multi-line mode</em> should be used.<br />
1827 In multi-line mode, each line (except command lines) typed in the input line will be added to the multi-line message. Once the message is finished, it can be sent to the current selected buddy with the "/msay send" command.<br />
1828 The <em>begin</em> subcommand enables multi-line mode. Note that it allows a message subject to be specified.<br />
1829 The <em>verbatim</em> multi-line mode disables commands, so that it is possible to enter lines starting with a slash. Only the "/msay" command (with send or abort parameters) can be used to exit verbatim mode.<br />
1830 The <em>toggle</em> subcommand can be bound to a key to use the multi-line mode quickly (for example, "bind M13 = msay toggle" to switch using the Meta-Enter combination).
1831 </p>
1832 <div class="dlist"><dl>
1833 <dt class="hdlist1">
1834 <em>begin</em> [subject]
1835 </dt>
1836 <dd>
1837 <p>
1838 Enter multi-line mode
1839 </p>
1840 </dd>
1841 <dt class="hdlist1">
1842 <em>verbatim</em>
1843 </dt>
1844 <dd>
1845 <p>
1846 Enter verbatim multi-line mode
1847 </p>
1848 </dd>
1849 <dt class="hdlist1">
1850 <em>send</em> [-n|-h]
1851 </dt>
1852 <dd>
1853 <p>
1854 Send the current multi-line message to the currently selected buddy
1855 </p>
1856 </dd>
1857 <dt class="hdlist1">
1858 <em>send_to</em> [-n|-h] jid
1859 </dt>
1860 <dd>
1861 <p>
1862 Send the current multi-line message to "jid"
1863 </p>
1864 </dd>
1865 <dt class="hdlist1">
1866 <em>toggle</em>|<em>toggle_verbatim</em>
1867 </dt>
1868 <dd>
1869 <p>
1870 Switch to/from multi-line mode (begin/send)
1871 </p>
1872 </dd>
1873 <dt class="hdlist1">
1874 <em>abort</em>
1875 </dt>
1876 <dd>
1877 <p>
1878 Leave multi-line mode without sending the message
1879 </p>
1880 <div class="literalblock">
1881 <div class="content">
1882 <pre><tt>The -n or -h flags turn the message to "normal" or "headline" accordingly, as opposed to default "chat" message.</tt></pre>
1883 </div></div>
1884 </dd>
1885 </dl></div>
1886 </dd>
1887 <dt class="hdlist1">
1888 /otr key
1889 </dt>
1890 <dt class="hdlist1">
1891 /otr start|stop|info [jid]
1892 </dt>
1893 <dt class="hdlist1">
1894 /otr fingerprint [jid [fpr]]
1895 </dt>
1896 <dt class="hdlist1">
1897 /otr smpq|smpr [jid] secret
1898 </dt>
1899 <dt class="hdlist1">
1900 /otr smpa [jid]
1901 </dt>
1902 <dd>
1903 <p>
1904 You can use the shortcut-jid "." for the currently selected contact.
1905 </p>
1906 <div class="dlist"><dl>
1907 <dt class="hdlist1">
1908 <em>key</em>
1909 </dt>
1910 <dd>
1911 <p>
1912 Print the fingerprint of your private key to the Status Buffer
1913 </p>
1914 </dd>
1915 <dt class="hdlist1">
1916 <em>start</em> [jid]
1917 </dt>
1918 <dd>
1919 <p>
1920 Open an OTR channel to the specified jid (or the currently selected contact)
1921 </p>
1922 </dd>
1923 <dt class="hdlist1">
1924 <em>stop</em> [jid]
1925 </dt>
1926 <dd>
1927 <p>
1928 Close the OTR channel to the specified jid (or the currently selected contact)
1929 </p>
1930 </dd>
1931 <dt class="hdlist1">
1932 <em>info</em> [jid]
1933 </dt>
1934 <dd>
1935 <p>
1936 Show current OTR status for the specified jid (or the currently selected contact)
1937 </p>
1938 </dd>
1939 <dt class="hdlist1">
1940 <em>fingerprint</em> [jid [fpr]]
1941 </dt>
1942 <dd>
1943 <p>
1944 Show the active fingerprint of an OTR channel. If the fingerprint is provided instead of "fpr", the fingerprint will become trusted. If you replace "fpr" by some bogus string the fingerprint will loose the trusted status.
1945 </p>
1946 </dd>
1947 <dt class="hdlist1">
1948 <em>smpq</em> [jid] secret
1949 </dt>
1950 <dd>
1951 <p>
1952 Initiate the Socialist Millionaires Protocol with the secret and the buddy
1953 </p>
1954 </dd>
1955 <dt class="hdlist1">
1956 <em>smpr</em> [jid] secret
1957 </dt>
1958 <dd>
1959 <p>
1960 Respond to the Initiation of the jid with the secret
1961 </p>
1962 </dd>
1963 <dt class="hdlist1">
1964 <em>smpa</em> [jid]
1965 </dt>
1966 <dd>
1967 <p>
1968 Abort the running Socialist Millionaires Protocol
1969 </p>
1970 </dd>
1971 </dl></div>
1972 </dd>
1973 <dt class="hdlist1">
1974 /otrpolicy
1975 </dt>
1976 <dt class="hdlist1">
1977 /otrpolicy (default|jid) (plain|manual|opportunistic|always)
1978 </dt>
1979 <dd>
1980 <p>
1981 You can use the shortcut-jid "." for the currently selected contact.
1982 </p>
1983 <div class="dlist"><dl>
1984 <dt class="hdlist1">
1985 (without arguments)
1986 </dt>
1987 <dd>
1988 <p>
1989 Prints all OTR policies to the status buffer
1990 </p>
1991 </dd>
1992 <dt class="hdlist1">
1993 (<em>default</em>|<em>jid</em>) (plain|manual|opportunistic|always)
1994 </dt>
1995 <dd>
1996 <p>
1997 Sets either the default policy or the policy for the given jid The plain policy should never be used, because you won&#8217;t be able to receive or send any OTR encrypted messages. If you set the policy to manual, you or your chat partner have to start the OTR encryption by hand (e.g. with /otr start). The policy "opportunistic" does that itself by sending a special whitespace-sequence at the end of unencrypted messages. So the other OTR-enabled chat client knows, that you want to use OTR. Note that the first message will always be unencryted, if you use this policy. With the policy "always" no message will be sent in plain text. If you try to sent the first message unencrypted, mcabber will try to establish an OTR channel. Please resend your message, when you get the information that the channel was established. If someone sends you plaintext messages while the policy is set to "always", you&#8217;ll be able to read the message but it won&#8217;t be saved to the history.
1998 </p>
1999 </dd>
2000 </dl></div>
2001 </dd>
2002 <dt class="hdlist1">
2003 /pgp disable|enable|force|info [jid]
2004 </dt>
2005 <dt class="hdlist1">
2006 /pgp setkey [jid [key]]
2007 </dt>
2008 <dd>
2009 <p>
2010 This command manipulates PGP settings for the specified jid (by default the currently selected contact).<br />
2011 Please note that PGP encryption won&#8217;t be used if no remote PGP support is detected, even if PGP is enabled with this command. You can force PGP encryption with the "force" subcommand.
2012 </p>
2013 <div class="dlist"><dl>
2014 <dt class="hdlist1">
2015 <em>disable</em> [jid]
2016 </dt>
2017 <dd>
2018 <p>
2019 Disable PGP encryption for jid (or the currently selected contact)
2020 </p>
2021 </dd>
2022 <dt class="hdlist1">
2023 <em>enable</em> [jid]
2024 </dt>
2025 <dd>
2026 <p>
2027 Enable PGP encryption for jid (or the currently selected contact)
2028 </p>
2029 </dd>
2030 <dt class="hdlist1">
2031 <em style="color:+|-;">force</em> [jid]
2032 </dt>
2033 <dd>
2034 <p>
2035 Enforce PGP encryption, even for offline messages, and always assume the recipient has PGP support. If a message can&#8217;t be encrypted (missing key or key id), the messages won&#8217;t be sent at all. This option is ignored when PGP is disabled.
2036 </p>
2037 </dd>
2038 <dt class="hdlist1">
2039 <em>info</em> [jid]
2040 </dt>
2041 <dd>
2042 <p>
2043 Show current PGP settings for the contact
2044 </p>
2045 </dd>
2046 <dt class="hdlist1">
2047 <em>setkey</em> [jid [key]]
2048 </dt>
2049 <dd>
2050 <p>
2051 Set the PGP key to be used to encrypt message for this contact. If no key is provided, the current key is erased. You can use the shortcut-jid "." for the currently selected contact.
2052 </p>
2053 </dd>
2054 </dl></div>
2055 </dd>
2056 <dt class="hdlist1">
595 /quit 2057 /quit
596 </b></dt> 2058 </dt>
597 <dd> 2059 <dd>
598 Disconnect and leave <tt>mcabber(1)</tt>. 2060 <p>
599 </dd> 2061 This command closes all connections and quit mcabber.
600 <dt><b> 2062 </p>
601 /set option[=value] 2063 </dd>
602 </b></dt> 2064 <dt class="hdlist1">
603 <dd> 2065 /rawxml send string
2066 </dt>
2067 <dd>
2068 <p>
2069 Send "string" (raw XML format) to the Jabber server.<br />
2070 No check is done on the string provided.<br />
2071 BEWARE!
2072 Use this only if you know what you are doing, or you could terminate the connection.<br />
2073 Example: "/rawxml send &lt;presence&gt;&lt;show&gt;away&lt;/show&gt;&lt;/presence&gt;"
2074 </p>
2075 </dd>
2076 <dt class="hdlist1">
2077 /rename name
2078 </dt>
2079 <dd>
2080 <p>
2081 Rename the current buddy or group to the given "name". If "name" is -, the name is removed from the roster (and mcabber will display the JID or username).
2082 </p>
2083 </dd>
2084 <dt class="hdlist1">
2085 /request last|ping|time|vcard|version [jid]
2086 </dt>
2087 <dd>
2088 <p>
2089 Send a "IQ" query to the current buddy, or to the specified Jabber user. If the resource is not provided with the jid, mcabber will send the query to all known resources for this user.
2090 </p>
2091 <div class="dlist"><dl>
2092 <dt class="hdlist1">
2093 <em>last</em>
2094 </dt>
2095 <dd>
2096 <p>
2097 Request "last" information (usually idle time)
2098 </p>
2099 </dd>
2100 <dt class="hdlist1">
2101 <em>ping</em>
2102 </dt>
2103 <dd>
2104 <p>
2105 Send an XMPP Ping request. Note that you should use the full JID since a ping sent to a bare JID will be handled by the server.
2106 </p>
2107 </dd>
2108 <dt class="hdlist1">
2109 <em>time</em>
2110 </dt>
2111 <dd>
2112 <p>
2113 Request time from the buddy
2114 </p>
2115 </dd>
2116 <dt class="hdlist1">
2117 <em>vcard</em>
2118 </dt>
2119 <dd>
2120 <p>
2121 Request VCard from the buddy
2122 </p>
2123 </dd>
2124 <dt class="hdlist1">
2125 <em>version</em>
2126 </dt>
2127 <dd>
2128 <p>
2129 Request version from the buddy
2130 </p>
2131 </dd>
2132 </dl></div>
2133 </dd>
2134 <dt class="hdlist1">
2135 /room join|leave|names|nick|remove|topic|unlock|destroy
2136 </dt>
2137 <dt class="hdlist1">
2138 /room privmsg|invite|whois|kick|ban|unban|role|affil
2139 </dt>
2140 <dt class="hdlist1">
2141 /room setopt print_status|auto_whois [value]
2142 </dt>
2143 <dt class="hdlist1">
2144 /room bookmark [add|del] [-autojoin|+autojoin] [-|nick]
2145 </dt>
2146 <dd>
2147 <p>
2148 The <em>room</em> command handles Multi-User Chat room actions.
2149 </p>
2150 <div class="dlist"><dl>
2151 <dt class="hdlist1">
2152 <em>join</em> [room [nick [pass]]]
2153 </dt>
2154 <dd>
2155 <p>
2156 Join "room", using "nick" as nickname. If no nickname is provided (or if it is an empty string), the "nickname" option value is used (see sample configuration file). If the currently selected entry is correctly recognized as a room by mcabber, the shortcut "." can be used instead of the full room id. A password can be provided to enter protected rooms. If your nickname contains space characters, use quotes.
2157 </p>
2158 </dd>
2159 <dt class="hdlist1">
2160 <em>leave</em> [message]
2161 </dt>
2162 <dd>
2163 <p>
2164 Leave the current room
2165 </p>
2166 </dd>
2167 <dt class="hdlist1">
2168 <em>names</em> [--detail|--short|--quiet|--compact]
2169 </dt>
2170 <dd>
2171 <p>
2172 Display members of the current room
2173 </p>
2174 </dd>
2175 <dt class="hdlist1">
2176 <em>nick</em> newnick
2177 </dt>
2178 <dd>
2179 <p>
2180 Change your nickname in the current room
2181 </p>
2182 </dd>
2183 <dt class="hdlist1">
2184 <em>privmsg</em> nick msg
2185 </dt>
2186 <dd>
2187 <p>
2188 Send private message "msg" to "nick"
2189 </p>
2190 </dd>
2191 <dt class="hdlist1">
2192 <em>remove</em>
2193 </dt>
2194 <dd>
2195 <p>
2196 Remove the current room from the roster (you must have left this room before)
2197 </p>
2198 </dd>
2199 <dt class="hdlist1">
2200 <em>topic</em> -|newtopic
2201 </dt>
2202 <dd>
2203 <p>
2204 Set topic for current room
2205 </p>
2206 </dd>
2207 <dt class="hdlist1">
2208 <em>unlock</em>
2209 </dt>
2210 <dd>
2211 <p>
2212 Unlock current room (if you are the owner)
2213 </p>
2214 </dd>
2215 <dt class="hdlist1">
2216 <em>destroy</em> [reason]
2217 </dt>
2218 <dd>
2219 <p>
2220 Destroy the current room (use with care!)
2221 </p>
2222 </dd>
2223 <dt class="hdlist1">
2224 <em>whois</em> nick
2225 </dt>
2226 <dd>
2227 <p>
2228 Display MUC information about "nick"
2229 </p>
2230 </dd>
2231 <dt class="hdlist1">
2232 <em>ban</em> jid [reason]
2233 </dt>
2234 <dd>
2235 <p>
2236 Ban jid from the current room
2237 </p>
2238 </dd>
2239 <dt class="hdlist1">
2240 <em>unban</em> jid
2241 </dt>
2242 <dd>
2243 <p>
2244 Unban jid from the current room
2245 </p>
2246 </dd>
2247 <dt class="hdlist1">
2248 <em>invite</em> jid [reason]
2249 </dt>
2250 <dd>
2251 <p>
2252 Invite jid to the current room
2253 </p>
2254 </dd>
2255 <dt class="hdlist1">
2256 <em>kick</em> nick [reason]
2257 </dt>
2258 <dd>
2259 <p>
2260 Kick "nick" from the current room
2261 </p>
2262 </dd>
2263 <dt class="hdlist1">
2264 <em>role</em> jid role [reason]
2265 </dt>
2266 <dd>
2267 <p>
2268 Change jid&#8217;s role (role can be "none", "visitor", "participant", "moderator")
2269 </p>
2270 </dd>
2271 <dt class="hdlist1">
2272 <em>affil</em> jid affil [reason]
2273 </dt>
2274 <dd>
2275 <p>
2276 Change jid&#8217;s affiliation (affil can be "none", "member", "admin", "owner")
2277 </p>
2278 </dd>
2279 <dt class="hdlist1">
2280 <em>setopt</em> print_status|auto_whois [value]
2281 </dt>
2282 <dd>
2283 <p>
2284 Change settings for the current room For print_status, the possible values are "default", "none", "in_and_out", "all". For auto_whois, the possible values are "default", "off", "on". When the value is "default", the options muc_print_status / muc_auto_whois is used.
2285 </p>
2286 </dd>
2287 <dt class="hdlist1">
2288 <em>bookmark</em> [add|del] [-autojoin|+autojoin] [-|nick]
2289 </dt>
2290 <dd>
2291 <p>
2292 Add, remove or update a bookmark (default is add). If autojoin is set, mcabber will automatically join the MUC room when it connects to the server. To see the list of bookmarks, use /room bookmark in the status buffer.
2293 </p>
2294 </dd>
2295 </dl></div>
2296 </dd>
2297 <dt class="hdlist1">
2298 /roster bottom|top|up|down|group_prev|group_next
2299 </dt>
2300 <dt class="hdlist1">
2301 /roster alternate|unread_first|unread_next
2302 </dt>
2303 <dt class="hdlist1">
2304 /roster search bud
2305 </dt>
2306 <dt class="hdlist1">
2307 /roster display|hide_offline|show_offline|toggle_offline
2308 </dt>
2309 <dt class="hdlist1">
2310 /roster item_lock|item_unlock|item_toggle_lock
2311 </dt>
2312 <dt class="hdlist1">
2313 /roster hide|show|toggle
2314 </dt>
2315 <dt class="hdlist1">
2316 /roster note [-|text]
2317 </dt>
2318 <dd>
2319 <p>
2320 The <em>roster</em> command manipulates the roster/buddylist.<br />
2321 Here are the available parameters:
2322 </p>
2323 <div class="dlist"><dl>
2324 <dt class="hdlist1">
2325 <em>bottom</em>
2326 </dt>
2327 <dd>
2328 <p>
2329 Jump to the bottom of the roster
2330 </p>
2331 </dd>
2332 <dt class="hdlist1">
2333 <em>top</em>
2334 </dt>
2335 <dd>
2336 <p>
2337 Jump to the top of the roster
2338 </p>
2339 </dd>
2340 <dt class="hdlist1">
2341 <em>up</em> [n]
2342 </dt>
2343 <dd>
2344 <p>
2345 Move up [n lines] in the roster
2346 </p>
2347 </dd>
2348 <dt class="hdlist1">
2349 <em>down</em> [n]
2350 </dt>
2351 <dd>
2352 <p>
2353 Move down [n lines] in the roster
2354 </p>
2355 </dd>
2356 <dt class="hdlist1">
2357 <em>group_prev</em>
2358 </dt>
2359 <dd>
2360 <p>
2361 Jump to the previous group in the roster
2362 </p>
2363 </dd>
2364 <dt class="hdlist1">
2365 <em>group_next</em>
2366 </dt>
2367 <dd>
2368 <p>
2369 Jump to the next group in the roster
2370 </p>
2371 </dd>
2372 <dt class="hdlist1">
2373 <em>alternate</em>
2374 </dt>
2375 <dd>
2376 <p>
2377 Jump to alternate buddy. The "alternate" buddy is the last buddy left while being in chat mode. This command is thus especially useful after commands like "/roster unread_next" (Ctrl-q).
2378 </p>
2379 </dd>
2380 <dt class="hdlist1">
2381 <em>unread_first</em>
2382 </dt>
2383 <dd>
2384 <p>
2385 Jump to the first unread message
2386 </p>
2387 </dd>
2388 <dt class="hdlist1">
2389 <em>unread_next</em>
2390 </dt>
2391 <dd>
2392 <p>
2393 Jump to the next unread message
2394 </p>
2395 </dd>
2396 <dt class="hdlist1">
2397 <em>search</em> bud
2398 </dt>
2399 <dd>
2400 <p>
2401 Search for a buddy with a name or jid containing "bud" (only in the displayed buddylist)
2402 </p>
2403 </dd>
2404 <dt class="hdlist1">
2405 <em>display</em> [mask]
2406 </dt>
2407 <dd>
2408 <p>
2409 See or update the roster filter. The mask should contain the shortcut letters of the status you want to see ([o]nline, [f]ree_for_chat, [d]o_not_disturb, [n]ot_available, [a]way, [_]offline). For example "ofdna" to display only connected buddies.
2410 </p>
2411 </dd>
2412 <dt class="hdlist1">
2413 <em>hide_offline</em>
2414 </dt>
2415 <dd>
2416 <p>
2417 Hide offline buddies (same as /roster display ofdna)
2418 </p>
2419 </dd>
2420 <dt class="hdlist1">
2421 <em>show_offline</em>
2422 </dt>
2423 <dd>
2424 <p>
2425 Show offline buddies (same as /roster display ofdna_)
2426 </p>
2427 </dd>
2428 <dt class="hdlist1">
2429 <em>toggle_offline</em>
2430 </dt>
2431 <dd>
2432 <p>
2433 Toggle display of offline buddies
2434 </p>
2435 </dd>
2436 <dt class="hdlist1">
2437 <em>item_lock</em> [jid]
2438 </dt>
2439 <dd>
2440 <p>
2441 Lock the roster item so it remains visible regardless of its status
2442 </p>
2443 </dd>
2444 <dt class="hdlist1">
2445 <em>item_unlock</em> [jid]
2446 </dt>
2447 <dd>
2448 <p>
2449 Undo the effects of item_lock
2450 </p>
2451 </dd>
2452 <dt class="hdlist1">
2453 <em>item_toggle_lock</em> [jid]
2454 </dt>
2455 <dd>
2456 <p>
2457 Invert the current lock flag
2458 </p>
2459 </dd>
2460 <dt class="hdlist1">
2461 <em>hide</em>
2462 </dt>
2463 <dd>
2464 <p>
2465 Hide roster (full-width chat window)
2466 </p>
2467 </dd>
2468 <dt class="hdlist1">
2469 <em>show</em>
2470 </dt>
2471 <dd>
2472 <p>
2473 Show roster
2474 </p>
2475 </dd>
2476 <dt class="hdlist1">
2477 <em>toggle</em>
2478 </dt>
2479 <dd>
2480 <p>
2481 Toggle roster visibility
2482 </p>
2483 </dd>
2484 <dt class="hdlist1">
2485 <em>note</em> [-|text]
2486 </dt>
2487 <dd>
2488 <p>
2489 Set/update/delete an annotation. If there is no text, the current item&#8217;s annotation is displayed&#8201;&#8212;&#8201;if you are in the status buffer, all notes are displayed. If text is "-", the note is erased.
2490 </p>
2491 </dd>
2492 </dl></div>
2493 </dd>
2494 <dt class="hdlist1">
2495 /say [-n|-h|--] text
2496 </dt>
2497 <dd>
2498 <p>
2499 Send the "text" message to the currently selected buddy. It can be useful if you want to send a message beginning with a slash, for example.<br />
2500 The "-n" flag turns the message to "normal" type, "-h" to "headline". "--" can be used to send chat message beginning with -n or -h.
2501 </p>
2502 </dd>
2503 <dt class="hdlist1">
2504 /say_to [-n|-h] [-q] [-f file] jid text
2505 </dt>
2506 <dd>
2507 <p>
2508 Send the "text" message to the specified jid.<br />
2509 Please note that this command doesn&#8217;t set the default resource for a contact, so if you want to send several messages to a specific resource you will have to use "/say_to" for each message.<br />
2510 The "-n" flag turns the message to "normal" type, "-h" to "headline". "--" can be used to send chat messages beginning with -n or -h.<br />
2511 When "-q" is used, the message will be sent in the background and will not change the current active window.<br />
2512 A text file can be provided with the "-f" switch (in which case there&#8217;s no need to pass a text argument after the jid, of course).
2513 </p>
2514 </dd>
2515 <dt class="hdlist1">
2516 /screen_refresh
2517 </dt>
2518 <dd>
2519 <p>
2520 Refresh the mcabber screen.
2521 </p>
2522 </dd>
2523 <dt class="hdlist1">
2524 /set option [= value]
2525 </dt>
2526 <dd>
2527 <p>
604 Display or set an option value. 2528 Display or set an option value.
605 </dd> 2529 </p>
606 <dt><b> 2530 </dd>
607 /source [file] 2531 <dt class="hdlist1">
608 </b></dt> 2532 /source pattern
609 <dd> 2533 </dt>
610 Read a configuration file. 2534 <dd>
611 </dd> 2535 <p>
612 <dt><b> 2536 Read configuration files, that match glob pattern (sorted in alphabetical order).
2537 </p>
2538 </dd>
2539 <dt class="hdlist1">
2540 /status [online|avail|invisible|free|dnd|notavail|away [-|statusmessage]]
2541 </dt>
2542 <dt class="hdlist1">
2543 /status message -|statusmessage
2544 </dt>
2545 <dd>
2546 <p>
2547 Show or set the current status.<br />
2548 If no status is specified, display the current status.<br />
2549 If a status message is specified, it will overrride the message* variables (these variables can be set in the configuration file).<br />
2550 If no relevant message* variable is set and no status message provided, the current status message is kept.<br />
2551 If StatusMessage is "-", the current status message is cleared.<br />
2552 With the "/status message" command, mcabber will update the message while preserving the status.
2553 </p>
2554 </dd>
2555 <dt class="hdlist1">
2556 /status_to jid online|avail|invisible|free|dnd|notavail|away [statusmessage]
2557 </dt>
2558 <dt class="hdlist1">
2559 /status_to jid message statusmessage
2560 </dt>
2561 <dd>
2562 <p>
2563 Send the requested status to the specified Jabber user.<br />
2564 If the specified jid is ".", the current buddy is used.<br />
2565 Note: this status will be overridden by subsequent "/status" commands. If you are using the auto-away feature, the status will overridden too.<br />
2566 Note: The jid can include a resource (i.e. user@server/resource).
2567 </p>
2568 </dd>
2569 <dt class="hdlist1">
613 /version 2570 /version
614 </b></dt> 2571 </dt>
615 <dd> 2572 <dd>
616 Display mcabber version 2573 <p>
617 </dd> 2574 Display current version of mcabber.
618 </dl> 2575 </p>
619 <h2>COMMANDS RELATED TO THE SERVER AND CONNECTION</h2> 2576 </dd>
620 <dl> 2577 </dl></div>
621 <dt><b> 2578 </div>
622 /connect 2579 <h2 id="_configuration_file">CONFIGURATION FILE</h2>
623 </b></dt> 2580 <div class="sectionbody">
624 <dd> 2581 <div class="paragraph"><p>See the provided sample configuration file, which should be self-documenting.</p></div>
625 Establish connection to the Jabber server. 2582 </div>
626 </dd> 2583 <h2 id="_files">FILES</h2>
627 <dt><b> 2584 <div class="sectionbody">
628 /disconnect 2585 <div class="paragraph"><p>The following files can be used by <tt>mcabber(1)</tt>:</p></div>
629 </b></dt> 2586 <div class="literalblock">
630 <dd> 2587 <div class="content">
631 Terminate connection to the Jabber server. Note: the roster is only 2588 <pre><tt>$HOME/.mcabber/mcabberrc Default configuration file
632 available when the connection to the server is active, so the
633 buddylist is empty when disconnected.
634 </dd>
635 <dt><b>
636 /event #n|* accept|ignore|reject
637 </b></dt>
638 <dt><b>
639 /event list
640 </b></dt>
641 <dd>
642 Tell mcabber what to do about a pending event.<br />
643 If the first parameter is "*", the command will apply to all
644 queued events.
645 <table class="hlist">
646 <tr valign="top">
647 <td>
648 <b>accept</b>
649 </td>
650 <td>
651 accept the event #n
652 </td>
653 </tr>
654 <tr valign="top">
655 <td>
656 <b>ignore</b>
657 </td>
658 <td>
659 remove the event #n from the list
660 </td>
661 </tr>
662 <tr valign="top">
663 <td>
664 <b>reject</b>
665 </td>
666 <td>
667 reject the event #n
668 </td>
669 </tr>
670 <tr valign="top">
671 <td>
672 <b>list</b>
673 </td>
674 <td>
675 list all pending events
676 </td>
677 </tr>
678 </table>
679 </dd>
680 <dt><b>
681 /rawxml send string
682 </b></dt>
683 <dd>
684 <b>send</b> string: send string (raw XML format) to the Jabber server. No check is done on the string provided. BEWARE! Use this only if you know what you are doing, or you could terminate the connection.
685 </dd>
686 </dl>
687 <h2>COMMANDS RELATED TO THE ROSTER AND JABBER RESOURCES</h2>
688 <dl>
689 <dt><b>
690 /add [jid [nickname]]
691 </b></dt>
692 <dd>
693 Add the "jid" Jabber user to our roster (default group), and send a
694 notification request to this buddy. If no nickname is specified, the
695 jid is used. If no jid (or an empty string "") is provided or if jid
696 is ".", the current buddy is used.
697 </dd>
698 <dt><b>
699 /authorization allow|cancel|request|request_unsubscribe [jid]
700 </b></dt>
701 <dd>
702 Manage the presence subscriptions.<br />
703 If no jid is provided, the current buddy is used.
704 <table class="hlist">
705 <tr valign="top">
706 <td>
707 <b>allow</b>
708 </td>
709 <td>
710 allow the buddy to receive your presence updates
711 </td>
712 </tr>
713 <tr valign="top">
714 <td>
715 <b>cancel</b>
716 </td>
717 <td>
718 cancel the buddy' subscription to your presence updates
719 </td>
720 </tr>
721 <tr valign="top">
722 <td>
723 <b>request</b>
724 </td>
725 <td>
726 request a subscription to the buddy's presence updates
727 </td>
728 </tr>
729 <tr valign="top">
730 <td>
731 <b>request_unsubscribe</b>
732 </td>
733 <td>
734 request unsubscription from the buddy's presence updates
735 </td>
736 </tr>
737 </table>
738 </dd>
739 <dt><b>
740 /del
741 </b></dt>
742 <dd>
743 Delete the current buddy from our roster, unsubscribe from its presence
744 notification and unsubscribe it from ours.
745 </dd>
746 <dt><b>
747 /group fold|unfold|toggle
748 </b></dt>
749 <dd>
750 The <b>group</b> command changes the current group display.
751 <table class="hlist">
752 <tr valign="top">
753 <td>
754 <b>fold</b>
755 </td>
756 <td>
757 fold (shrink) the current group tree in the roster
758 </td>
759 </tr>
760 <tr valign="top">
761 <td>
762 <b>unfold</b>
763 </td>
764 <td>
765 unfold (expand) the current group tree in the roster
766 </td>
767 </tr>
768 <tr valign="top">
769 <td>
770 <b>toggle</b>
771 </td>
772 <td>
773 toggle the state (fold/unfold) of the current tree
774 </td>
775 </tr>
776 </table>
777 </dd>
778 <dt><b>
779 /info
780 </b></dt>
781 <dd>
782 Display info on the selected entry (user, agent, group&#8230;).<br />
783 For users, resources are displayed with the status, priority and
784 status message (if available) of each resource.
785 </dd>
786 <dt><b>
787 /move [groupname]
788 </b></dt>
789 <dd>
790 Move the current buddy to the requested group. If no group is
791 specified, then the buddy is moved to the default group.
792 If the group groupname doesn't exist, it is created.<br />
793 Tip: if the chatmode is enabled, you can use "/roster alternate"
794 to jump to the moved buddy.
795 </dd>
796 <dt><b>
797 /msay begin|verbatim|send|send_to|toggle|toggle_verbatim|abort
798 </b></dt>
799 <dd>
800 Send a multi-line message. To write a single message with several
801 lines, the <b>multi-line mode</b> should be used. <tt>
802 In multi-line mode, each line (except command lines) typed in the input
803 line will be added to the multi-line message. Once the message is
804 finished, it can be sent to the current selected buddy with the "/msay
805 send" command (or Ctrl-d). </tt>
806 The <b>begin</b> subcommand enables multi-line mode. Note that it allows
807 a message subject to be specified. <tt>
808 The <b>verbatim</b> multi-line mode disables commands, so that it is
809 possible to enter lines starting with a slash. Only the "/msay"
810 command (with send or abort parameters) can be used to exit verbatim
811 mode. </tt>
812 The <b>toggle</b> and <b>toggle_verbatim</b> subcommands can be bound to a key to
813 use the multi-line mode quickly (for example, "bind M109 = msay toggle"
814 to switch using the Meta-m combination).
815 <table class="hlist">
816 <tr valign="top">
817 <td>
818 <b>begin</b> [subject]
819 </td>
820 <td>
821 enter multi-line mode
822 </td>
823 </tr>
824 <tr valign="top">
825 <td>
826 <b>verbatim</b>
827 </td>
828 <td>
829 enter verbatim multi-line mode
830 </td>
831 </tr>
832 <tr valign="top">
833 <td>
834 <b>send</b>
835 </td>
836 <td>
837 send the current multi-line message to the currently selected buddy
838 </td>
839 </tr>
840 <tr valign="top">
841 <td>
842 <b>send_to</b> jid
843 </td>
844 <td>
845 send the current multi-line message to "jid"
846 </td>
847 </tr>
848 <tr valign="top">
849 <td>
850 <b>toggle</b>
851 </td>
852 <td>
853 switch to/from multi-line mode (begin/send)
854 </td>
855 </tr>
856 <tr valign="top">
857 <td>
858 <b>toggle_verbatim</b>
859 </td>
860 <td>
861 same with verbatim multi-line mode
862 </td>
863 </tr>
864 <tr valign="top">
865 <td>
866 <b>abort</b>
867 </td>
868 <td>
869 leave multi-line mode without sending the message
870 </td>
871 </tr>
872 </table>
873 </dd>
874 <dt><b>
875 /pgp disable|enable|force|info [jid]
876 </b></dt>
877 <dt><b>
878 /pgp setkey [jid [key]]
879 </b></dt>
880 <dd>
881 Manipulate PGP settings for the specified jid (by default the currently selected contact). Please note that PGP encryption won't be used if no remote PGP support is detected, even if PGP is enabled with this command.
882 <table class="hlist">
883 <tr valign="top">
884 <td>
885 <b>disable</b> [jid]
886 </td>
887 <td>
888 disable PGP encryption for jid (or the currently selected contact)
889 </td>
890 </tr>
891 <tr valign="top">
892 <td>
893 <b>enable</b> [jid]
894 </td>
895 <td>
896 enable PGP encryption for jid (or the currently selected contact)
897 </td>
898 </tr>
899 <tr valign="top">
900 <td>
901 <b>force</b> [jid]
902 </td>
903 <td>
904 enforce PGP encryption, even for offline messages, and always assume the recipient has PGP support
905 </td>
906 </tr>
907 <tr valign="top">
908 <td>
909 <b>info</b> [jid]
910 </td>
911 <td>
912 show current PGP settings for the contact
913 </td>
914 </tr>
915 <tr valign="top">
916 <td>
917 <b>setkey</b> [jid [key]]
918 </td>
919 <td>
920 set the PGP key to be used to encrypt message for this contact. If no key is provided, the current key is erased. You can use the shortcut-jid "." for the currently selected contact.
921 </td>
922 </tr>
923 </table>
924 </dd>
925 <dt><b>
926 /rename name
927 </b></dt>
928 <dd>
929 Rename current buddy or group to the given name.
930 Please note that a group name change is only done when the server's
931 acknowledgment is received, so a slight delay can be noticed.
932 </dd>
933 <dt><b>
934 /request last|time|vcard|version [jid]
935 </b></dt>
936 <dd>
937 Send a "IQ" query to the current buddy, or to the specified Jabber
938 user. If the resource is not provided with the jid, mcabber will
939 send the query to all known resources for this user.
940 </dd>
941 <dt><b>
942 /room join|leave|names|nick|privmsg|remove|topic|unlock|destroy
943 </b></dt>
944 <dt><b>
945 /room invite|kick|ban|role|affil
946 </b></dt>
947 <dt><b>
948 /room bookmark [add|del] [-autojoin|+autojoin]
949 </b></dt>
950 <dd>
951 The <b>room</b> command handles Multi-User Chat room actions.
952 <table class="hlist">
953 <tr valign="top">
954 <td>
955 <b>join</b> [room [nick [pass]]]
956 </td>
957 <td>
958 join "room", using "nick" as nickname. If no nickname is provided (or if it is an empty string), the "nickname" option value is used (see sample configuration file). If the currently selected entry is correctly recognized as a room by mcabber, the shortcut "." can be used instead of the full room id. A password can be provided to enter protected rooms. If your nickname contains space characters, use quotes.
959 </td>
960 </tr>
961 <tr valign="top">
962 <td>
963 <b>leave</b> [message]
964 </td>
965 <td>
966 leave the current room
967 </td>
968 </tr>
969 <tr valign="top">
970 <td>
971 <b>names</b> [--detail|--short|--quiet]
972 </td>
973 <td>
974 display the members of the current room
975 </td>
976 </tr>
977 <tr valign="top">
978 <td>
979 <b>nick</b> nick
980 </td>
981 <td>
982 change your nickname in the current room
983 </td>
984 </tr>
985 <tr valign="top">
986 <td>
987 <b>privmsg</b> nick msg
988 </td>
989 <td>
990 send private message "msg" to "nick"
991 </td>
992 </tr>
993 <tr valign="top">
994 <td>
995 <b>remove</b>
996 </td>
997 <td>
998 remove the current room from the roster (you must have left this room before)
999 </td>
1000 </tr>
1001 <tr valign="top">
1002 <td>
1003 <b>topic</b>
1004 </td>
1005 <td>
1006 set topic for current room
1007 </td>
1008 </tr>
1009 <tr valign="top">
1010 <td>
1011 <b>unlock</b>
1012 </td>
1013 <td>
1014 unlock current room (if you are the owner)
1015 </td>
1016 </tr>
1017 <tr valign="top">
1018 <td>
1019 <b>destroy</b> [reason]
1020 </td>
1021 <td>
1022 destroy the current room (use with care!)
1023 </td>
1024 </tr>
1025 <tr valign="top">
1026 <td>
1027 <b>whois</b> nick
1028 </td>
1029 <td>
1030 display MUC information about "nick"
1031 </td>
1032 </tr>
1033 <tr valign="top">
1034 <td>
1035 <b>ban</b> jid [reason]
1036 </td>
1037 <td>
1038 ban jid from the current room
1039 </td>
1040 </tr>
1041 <tr valign="top">
1042 <td>
1043 <b>invite</b> jid [reason]
1044 </td>
1045 <td>
1046 invite jid to the current room
1047 </td>
1048 </tr>
1049 <tr valign="top">
1050 <td>
1051 <b>kick</b> nick [reason]
1052 </td>
1053 <td>
1054 kick "nick" from the current room
1055 </td>
1056 </tr>
1057 <tr valign="top">
1058 <td>
1059 <b>role</b> jid role [reason]
1060 </td>
1061 <td>
1062 change jid's role (role can be "none", "visitor", "participant", "moderator")
1063 </td>
1064 </tr>
1065 <tr valign="top">
1066 <td>
1067 <b>affil</b> jid affil [reason]
1068 </td>
1069 <td>
1070 change jid's affiliation (affil can be "none", "member", "admin", "owner")
1071 <b>bookmark</b> add/update/remove a room bookmark, set/unset autojoin
1072 </td>
1073 </tr>
1074 </table>
1075 </dd>
1076 <dt><b>
1077 /roster bottom|top|up|down|group_prev|group_next
1078 </b></dt>
1079 <dt><b>
1080 /roster alternate|unread_first|unread_next
1081 </b></dt>
1082 <dt><b>
1083 /roster search bud
1084 </b></dt>
1085 <dt><b>
1086 /roster hide_offline|show_offline|toggle_offline
1087 </b></dt>
1088 <dt><b>
1089 /roster item_lock|item_unlock
1090 </b></dt>
1091 <dt><b>
1092 /roster hide|show|toggle
1093 </b></dt>
1094 <dt><b>
1095 /roster note [-|text]
1096 </b></dt>
1097 <dd>
1098 The <b>roster</b> command manipulates the roster/buddylist. Here are the available parameters:
1099 <table class="hlist">
1100 <tr valign="top">
1101 <td>
1102 <b>bottom</b>
1103 </td>
1104 <td>
1105 jump to the bottom of the roster
1106 </td>
1107 </tr>
1108 <tr valign="top">
1109 <td>
1110 <b>top</b>
1111 </td>
1112 <td>
1113 jump to the top of the roster
1114 </td>
1115 </tr>
1116 <tr valign="top">
1117 <td>
1118 <b>up</b>
1119 </td>
1120 <td>
1121 move up in the roster
1122 </td>
1123 </tr>
1124 <tr valign="top">
1125 <td>
1126 <b>down</b>
1127 </td>
1128 <td>
1129 move down in the roster
1130 </td>
1131 </tr>
1132 <tr valign="top">
1133 <td>
1134 <b>group_prev</b>
1135 </td>
1136 <td>
1137 jump to the previous group in the roster
1138 </td>
1139 </tr>
1140 <tr valign="top">
1141 <td>
1142 <b>group_next</b>
1143 </td>
1144 <td>
1145 jump to the next group in the roster
1146 </td>
1147 </tr>
1148 <tr valign="top">
1149 <td>
1150 <b>alternate</b>
1151 </td>
1152 <td>
1153 jump to alternate buddy. The "alternate" buddy is the last buddy left while being in chat mode (this command is thus especially useful after commands like "/roster unread_first")
1154 </td>
1155 </tr>
1156 <tr valign="top">
1157 <td>
1158 <b>unread_first</b>
1159 </td>
1160 <td>
1161 jump to the first unread message
1162 </td>
1163 </tr>
1164 <tr valign="top">
1165 <td>
1166 <b>unread_next</b>
1167 </td>
1168 <td>
1169 jump to the next unread message
1170 </td>
1171 </tr>
1172 <tr valign="top">
1173 <td>
1174 <b>search</b> bud
1175 </td>
1176 <td>
1177 search for a buddy with a name or jid containing "bud" (only in the displayed buddylist)
1178 </td>
1179 </tr>
1180 <tr valign="top">
1181 <td>
1182 <b>hide_offline</b>
1183 </td>
1184 <td>
1185 hide offline buddies
1186 </td>
1187 </tr>
1188 <tr valign="top">
1189 <td>
1190 <b>show_offline</b>
1191 </td>
1192 <td>
1193 show offline buddies
1194 </td>
1195 </tr>
1196 <tr valign="top">
1197 <td>
1198 <b>toggle_offline</b>
1199 </td>
1200 <td>
1201 toggle display of offline buddies
1202 </td>
1203 </tr>
1204 <tr valign="top">
1205 <td>
1206 <b>item_lock</b> jid
1207 </td>
1208 <td>
1209 lock the roster item so it remains visible regardless of its status
1210 </td>
1211 </tr>
1212 <tr valign="top">
1213 <td>
1214 <b>item_unlock</b> jid
1215 </td>
1216 <td>
1217 undo the effects of item_lock
1218 </td>
1219 </tr>
1220 <tr valign="top">
1221 <td>
1222 <b>hide</b>
1223 </td>
1224 <td>
1225 hide roster (full-width chat window)
1226 </td>
1227 </tr>
1228 <tr valign="top">
1229 <td>
1230 <b>show</b>
1231 </td>
1232 <td>
1233 show roster
1234 </td>
1235 </tr>
1236 <tr valign="top">
1237 <td>
1238 <b>toggle</b>
1239 </td>
1240 <td>
1241 toggle roster visibility
1242 </td>
1243 </tr>
1244 <tr valign="top">
1245 <td>
1246 <b>note</b> [text]
1247 </td>
1248 <td>
1249 display or set an annotation (if text is "-", the annotation is deleted). In the "status" buffer, it will display all annotations.
1250 </td>
1251 </tr>
1252 </table>
1253 </dd>
1254 <dt><b>
1255 /say text
1256 </b></dt>
1257 <dd>
1258 Send the "text" message to the currently selected buddy. Can be useful
1259 if you want to send a message beginning with a slash, for example.
1260 </dd>
1261 <dt><b>
1262 /say_to jid text
1263 </b></dt>
1264 <dd>
1265 Send the "text" message to the specified jid.
1266 Please note that this command doesn't set the default resource for
1267 a contact, so if you want to send several messages to a specific
1268 resource you will have to use "/say_to" for each message.
1269 </dd>
1270 <dt><b>
1271 /status [online|avail|invisible|free|dnd|notavail|away [-|StatusMessage]]
1272 </b></dt>
1273 <dd>
1274 Show or set the current status. <tt>
1275 If no status is specified, display the current status. </tt>
1276 If a status message is specified, it will overrride the message*
1277 variables (these variables can be set in the configuration file).
1278 If no relevant message* variable is set and no status message provided,
1279 the current status message is kept. If StatusMessage is "-", the
1280 current status message is cleared.
1281 </dd>
1282 <dt><b>
1283 /status_to jid online|avail|invisible|free|dnd|notavail|away [StatusMessage]
1284 </b></dt>
1285 <dd>
1286 Send the requested status to the specified Jabber user. <tt>
1287 If the specified jid is ".", the current buddy is used. </tt>
1288 Note: this status will be overridden by subsequent "/status" commands.
1289 If you are using the auto-away feature, the status will overridden
1290 too.<br />
1291 Note: The jid can include a resource (i.e. user@server/resource).
1292 </dd>
1293 </dl>
1294 <h2>CONFIGURATION FILE</h2>
1295 <p>See the provided sample configuration file, which should be self-documenting.</p>
1296 <h2>FILES</h2>
1297 <p>The following files can be used by <tt>mcabber(1)</tt>:</p>
1298 <div class="literalparagraph"><pre>$HOME/.mcabber/mcabberrc Default configuration file
1299 $HOME/.mcabberrc Configuration file used if no other has been found 2589 $HOME/.mcabberrc Configuration file used if no other has been found
1300 $HOME/.mcabber/histo/ Default directory for storing chat history files, if enabled</pre></div> 2590 $HOME/.mcabber/histo/ Default directory for storing chat history files, if enabled
1301 <h2>BUGS</h2> 2591 /usr/share/mcabber/help/ Default directory for online help files
1302 <p>Certainly. Please tell me if you find one! :-)</p> 2592 /usr/lib/mcabber/ Default directory for modules</tt></pre>
1303 <h2>AUTHOR</h2> 2593 </div></div>
1304 <p>Written by <a href="mailto:mcabber@lilotux.net">Mikael BERTHE</a>.<br /> 2594 </div>
1305 Originally based on <a href="http://cabber.sourceforge.net">Cabber</a>, please 2595 <h2 id="_bugs">BUGS</h2>
1306 consult the AUTHORS file for details.</p> 2596 <div class="sectionbody">
1307 <h2>RESOURCES</h2> 2597 <div class="paragraph"><p>Certainly. Please tell me if you find one! :-)<br />
1308 <p><a href="http://www.lilotux.net/~mikael/mcabber/">Main web site</a></p> 2598 Please visit our website to find out about the MUC room and the bug tracker.</p></div>
1309 <h2>COPYING</h2> 2599 </div>
1310 <p>Copyright (C) 2005, 2006, 2007, 2008 Mikael Berthe.<br /> 2600 <h2 id="_author">AUTHOR</h2>
1311 Some portions are Copyright (C) 2002-2004 <a href="mailto:cabber@ajmacias.com">cabber@ajmacias.com</a>.</p> 2601 <div class="sectionbody">
1312 <p>Free use of this software is granted under the terms of the GNU General Public 2602 <div class="paragraph"><p>Written by <a href="mailto:mikael@lilotux.net">Mikael BERTHE</a> and others
1313 License (GPL).</p> 2603 (see AUTHORS file).<br /></p></div>
2604 </div>
2605 <h2 id="_resources">RESOURCES</h2>
2606 <div class="sectionbody">
2607 <div class="paragraph"><p><a href="http://mcabber.com/">Main web site</a></p></div>
2608 </div>
2609 <h2 id="_copying">COPYING</h2>
2610 <div class="sectionbody">
2611 <div class="paragraph"><p>Copyright (C) 2005-2010 Mikael Berthe and others.<br /></p></div>
2612 <div class="paragraph"><p>Free use of this software is granted under the terms of the GNU General Public
2613 License (GPL).</p></div>
2614 </div>
2615 </div>
2616 <div id="footnotes"><hr /></div>
1314 <div id="footer"> 2617 <div id="footer">
1315 <p> 2618 <div id="footer-text">
1316 Version 0.10.0-dev<br /> 2619 Version 0.10.0-dev<br />
1317 Last updated 27-Jun-2007 22:11:34 CEST 2620 Last updated 2010-03-13 17:43:30 CEST
1318 </p>
1319 </div> 2621 </div>
1320 </div> 2622 </div>
1321 </body> 2623 </body>
1322 </html> 2624 </html>