annotate mcabber/doc/mcabber.1.txt @ 1838:d10c291d31a7

Do not call hk_unread_list_change() too frequently
author Mikael Berthe <mikael@lilotux.net>
date Sat, 27 Mar 2010 18:09:29 +0100
parents 921429804e20
children cec7cbeb1c2e
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
198
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
1 MCABBER(1)
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
2 ===========
222
882029ebd052 [/trunk] Changeset 234 by mikael
mikael
parents: 210
diff changeset
3 Mikael BERTHE <mcabber@lilotux.net>
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
4 v0.10.0-dev, March 2010
198
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
5
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
6 NAME
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
7 ----
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
8 mcabber - a simple Jabber (XMPP) console client
198
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
9
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
10 SYNOPSIS
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
11 --------
1259
c5c09f8f60b0 Change command line option -v to -V
Mikael Berthe <mikael@lilotux.net>
parents: 1257
diff changeset
12 'mcabber' [ -h | -V | -f configfile ]
198
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
13
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
14 DESCRIPTION
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
15 -----------
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
16 `mcabber(1)` is a small Jabber (XMPP) console client. +
200
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
17 For now it needs a configuration file to start, so please copy the sample
208
8b08f34922c5 [/trunk] Changeset 220 by mikael
mikael
parents: 206
diff changeset
18 mcabberrc file and adapt your connection settings.
200
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
19
360
20283b69db99 Doc: Say a Jabber account should already exist for using mcabber
Mikael Berthe <mikael@lilotux.net>
parents: 349
diff changeset
20 You also need to have an existing Jabber account to use this software, as
20283b69db99 Doc: Say a Jabber account should already exist for using mcabber
Mikael Berthe <mikael@lilotux.net>
parents: 349
diff changeset
21 it cannot (un)register accounts yet.
20283b69db99 Doc: Say a Jabber account should already exist for using mcabber
Mikael Berthe <mikael@lilotux.net>
parents: 349
diff changeset
22
854
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
23 Here are some of the features of `mcabber`:
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
24
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
25 - 'SASL/SSL/TLS support'.
854
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
26 - 'MUC support' (Multi-User Chat).
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
27 - 'PGP, OTR support'
1062
9207f2efb921 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1037
diff changeset
28 - 'Chat States' support (typing notifications)
854
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
29 - 'History logging:' If enabled (see the CONFIGURATION FILE section),
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
30 `mcabber` can save discussions to text history log files.
854
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
31 - 'Commands completion:' If possible, `mcabber` will try to complete your
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
32 command line if you hit the Tab key.
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
33 - 'Input line history:' Any message or command entered is in the input line
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
34 history and can be reused easily.
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
35 - 'External actions:' Some events (like receiving a message) can trigger an
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
36 external action such as a shell script if you enable it in your
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
37 configuration file. A sample events script ("eventcmd") is provided with
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
38 `mcabber` source code, in the contrib directory.
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
39 - 'Modules:' `mcabber` can load modules (a.k.a. plugins) at runtime that
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
40 extend its features.
854
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
41
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
42 OPTIONS
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
43 -------
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
44 -h::
854
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
45 Quick help usage message
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
46
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
47 -V::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
48 Displays `mcabber` version and compile-time definitions.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
49
854
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
50 -f configfile::
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
51 Use configuration file 'configfile'
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
52
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
53 WINDOWS/PANES
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
54 -------------
202
9bdc6d9996f6 [/trunk] Changeset 214 by mikael
mikael
parents: 200
diff changeset
55 The `mcabber(1)` screen is divided into 4 regions.
200
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
56 The 'roster', alias 'buddylist', is on the left. The 'chat window', or chat
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
57 buffer, is on the right. The 'input line' lies at the bottom of the screen,
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
58 under a small 'log window'.
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
59
775
b4befb3052e5 Update NEWS, ChangeLog and documentation
Mikael Berthe <mikael@lilotux.net>
parents: 710
diff changeset
60 Two status lines surround the log window. The bottom status line is the
b4befb3052e5 Update NEWS, ChangeLog and documentation
Mikael Berthe <mikael@lilotux.net>
parents: 710
diff changeset
61 "main status line" and reflects mcabber general status. The other line
b4befb3052e5 Update NEWS, ChangeLog and documentation
Mikael Berthe <mikael@lilotux.net>
parents: 710
diff changeset
62 is the "chat status line" and shows the status of the currently selected
b4befb3052e5 Update NEWS, ChangeLog and documentation
Mikael Berthe <mikael@lilotux.net>
parents: 710
diff changeset
63 buddy.
b4befb3052e5 Update NEWS, ChangeLog and documentation
Mikael Berthe <mikael@lilotux.net>
parents: 710
diff changeset
64
204
dcb5ed79f719 [/trunk] Changeset 216 by mikael
mikael
parents: 203
diff changeset
65 To display buddies chat buffers, you will have to enter 'chat mode'.
dcb5ed79f719 [/trunk] Changeset 216 by mikael
mikael
parents: 203
diff changeset
66 You can enter chat mode by pressing enter, and leave chat mode with the ESC
229
bfc14cfb068e [/trunk] Changeset 241 by mikael
mikael
parents: 222
diff changeset
67 key. Simply sending a message will also enable chat mode.
204
dcb5ed79f719 [/trunk] Changeset 216 by mikael
mikael
parents: 203
diff changeset
68
854
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
69 There are several advantages to the two-mode implementation: first, it allows
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
70 accurate "unread" message functionality, as described in the next section;
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
71 without this, merely scrolling to a specific buddy will "read" the new
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
72 messages of all buddies in-between. Second, it allows quickly hiding the
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
73 conversation with a single keystroke. Third, it allows jumping between
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
74 the few buddies with whom you are conversing with the '/roster alternate'
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
75 command described in another section, without having to manually scroll
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
76 back and forth.
200
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
77
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
78 KEYS
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
79 ----
229
bfc14cfb068e [/trunk] Changeset 241 by mikael
mikael
parents: 222
diff changeset
80 Text typing occurs in the 'input line'; basic operations are supported
bfc14cfb068e [/trunk] Changeset 241 by mikael
mikael
parents: 222
diff changeset
81 (left arrow, right arrow, home/end keys, insert, delete, backspace...).
200
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
82
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
83 PageUp and PageDown keys are used to move in the roster.
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
84
618
341568185492 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 601
diff changeset
85 Up and Down arrow keys can be used to move in the input line history; they
341568185492 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 601
diff changeset
86 jump to the previous/next line from the history beginning with the same string
341568185492 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 601
diff changeset
87 (from first column to the cursor column).
341568185492 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 601
diff changeset
88
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
89 To send a message, move to the chosen buddy in the buddylist, type your
200
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
90 message and hit enter. If the line begins with a slash, this will be
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
91 interpreted as a command (see the COMMAND section below). Hit escape to
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
92 leave the chat mode.
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
93
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
94 Here is a quick description of the default key bindings:
200
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
95
1062
9207f2efb921 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1037
diff changeset
96 Esc:: Disable chat mode
200
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
97 Ctrl-a:: Go to the beginning of the input line
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
98 Ctrl-e:: Go to the end of the input line
618
341568185492 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 601
diff changeset
99 Ctrl-l:: Force a refresh
341568185492 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 601
diff changeset
100 Up/Down:: Move in the input line history
200
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
101 PgUp/PgDown:: Move inside the roster (buddylist)
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
102 Tab:: Complete current word, in the input line
1083
07941d7feee9 Ctrl-d sends a multi-line message
Mikael Berthe <mikael@lilotux.net>
parents: 1062
diff changeset
103 Ctrl-g:: Cancel completion
07941d7feee9 Ctrl-d sends a multi-line message
Mikael Berthe <mikael@lilotux.net>
parents: 1062
diff changeset
104 Ctrl-c:: Abort multi-line messages and completions
07941d7feee9 Ctrl-d sends a multi-line message
Mikael Berthe <mikael@lilotux.net>
parents: 1062
diff changeset
105 Ctrl-d:: Send/terminate a multi-line message
200
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
106 Ctrl-p/Ctrl-n:: Scroll up/down half a screen in the buffer window (chat mode)
775
b4befb3052e5 Update NEWS, ChangeLog and documentation
Mikael Berthe <mikael@lilotux.net>
parents: 710
diff changeset
107 Ctrl-Left:: Move the cursor back to the start of the current or previous word
b4befb3052e5 Update NEWS, ChangeLog and documentation
Mikael Berthe <mikael@lilotux.net>
parents: 710
diff changeset
108 Ctrl-Right:: Move the cursor forward to the end of the current or next word
200
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
109 Ctrl-u:: Delete from beginning of the line to the cursor
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
110 Ctrl-k:: Delete from the cursor to the end of line
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
111 Ctrl-w:: Backward kill word
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
112 Ctrl-t:: Transpose chars
263
1bcc3eec08f0 Add Ctrl-o: accept-line-and-down-history
mikael@frmp8452
parents: 260
diff changeset
113 Ctrl-o:: Accept line and put the next history line in the input line (accept-line-and-down-history)
198
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
114
1096
3d92e648a8db Update manpage
Mikael Berthe <mikael@lilotux.net>
parents: 1086
diff changeset
115 Additional key bindings may be specified using the '/bind' command described
854
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
116 in the COMMANDS section.
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
117
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
118 MCABBER'S ROSTER
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
119 ----------------
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
120 The first listed resource on the roster is '[status]', which keeps a log of
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
121 everything that appears in the short log window below the main chat area.
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
122 While the log window was designed for showing the latest few elements, the
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
123 dedicated '[status]' buffer allows more comfortable viewing of the log, as
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
124 well as scrolling it in a standard manner.
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
125
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
126 Group names are displayed above the resources that are within them, and are
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
127 indicated by '---' to the left of the name.
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
128
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
129 For every real Jabber resource, the roster displays four pieces of information:
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
130 the resource's name or alias, its online status, its authorization status, and
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
131 whether there are unread messages from the resource waiting for you.
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
132
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
133 The online status is one of the following:
199
e574c859190a [/trunk] Changeset 211 by mikael
mikael
parents: 198
diff changeset
134
854
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
135 'o';; online
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
136 'f';; free for chat
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
137 'a';; away
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
138 'n';; not available (labeled 'extended away' in some clients)
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
139 'd';; do not disturb
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
140 'i';; invisible (displayed only for your resource)
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
141 '_';; offline (or invisible to you)
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
142 '?';; unknown, usually meaning you are not authorized to see this resource's status
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
143 'x';; a conference room in which you are not participating
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
144 'C';; a conference room in which you are participating
199
e574c859190a [/trunk] Changeset 211 by mikael
mikael
parents: 198
diff changeset
145
854
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
146 The authorization status indicates whether a resource is authorized to receive
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
147 your online status updates, and is displayed by the brackets surrounding the
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
148 resource's online status. Square brackets, like '[o]', indicate that this
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
149 resource is authorized to receive your status. Curly braces, like '\{o\}',
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
150 indicate that they are not authorized to receive your status.
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
151
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
152 When there are unread messages from the resource which you have not looked at,
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
153 a hash mark ('#') appears in the leftmost section of the roster for that
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
154 resource. The hash mark disappears once you view that resource's message log.
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
155
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
156 Examples:
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
157
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
158 ' --- Buds';; This is a group named 'Buds'
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
159 '#[o] John';; John is online, can see your status, and sent you a message that you did not read yet
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
160 ' \{?\} Sally';; Neither you nor Sally have authorized each other to see your online status
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
161 ' \{a\} Jane';; Jane is away, but she cannot see your online status
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
162 '#[C] \x@y.c';; You are participating in \x@y.c conference room, and there are unread messages
854
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
163
1242
b335d30881bd Update manpage
Mikael Berthe <mikael@lilotux.net>
parents: 1233
diff changeset
164 COMMANDS
b335d30881bd Update manpage
Mikael Berthe <mikael@lilotux.net>
parents: 1233
diff changeset
165 --------
b335d30881bd Update manpage
Mikael Berthe <mikael@lilotux.net>
parents: 1233
diff changeset
166 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. +
b335d30881bd Update manpage
Mikael Berthe <mikael@lilotux.net>
parents: 1233
diff changeset
167 You will find an overview of the `mcabber` commands in this manual.
b335d30881bd Update manpage
Mikael Berthe <mikael@lilotux.net>
parents: 1233
diff changeset
168
854
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
169 COMMANDS RELATED TO MCABBER
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
170 ---------------------------
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
171 /add [jid [nickname]]::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
172 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.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
173
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
174 ['jid' [nickname]];; Add to our roster "jid" as "nickname"
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
175
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
176 Example: "/add somebody@jabber.server.com Somebody"
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
177
870
4b77a2ab18e5 Update manpage
Mikael Berthe <mikael@lilotux.net>
parents: 854
diff changeset
178 /alias [name [= command line]]::
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
179 This command let you to add aliases which can simplify sophisticated commands. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
180 You can manage your aliases by:
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
181
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
182 (without arguments);; Print list of currently defined aliases
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
183 'name';; Print the value of alias called "name"
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
184 'name'=;; Unset alias called "name"
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
185 'name' = command line;; Set alias called "name" with value "command line"
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
186
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
187 Example: "/alias away = status away"
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
188
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
189 /authorization allow|cancel|request|request_unsubscribe [jid]::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
190 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. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
191 If no JID is provided, the currently-selected buddy is used.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
192
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
193 'allow';; Allow the buddy to receive your presence updates
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
194 'cancel';; Cancel the buddy's subscription to your presence updates
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
195 'request';; Request a subscription to the buddy's presence updates
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
196 'request_unsubscribe';; Request unsubscription from the buddy's presence updates
289
72fa52203651 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 286
diff changeset
197
870
4b77a2ab18e5 Update manpage
Mikael Berthe <mikael@lilotux.net>
parents: 854
diff changeset
198 /bind [keycode [= command line]]::
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
199 Bind the command to the key given as "keycode". To examine which keys are currently not used look at `mcabber` log window and press examined key. For example: "Unknown key=265" means that you can bind some command to key #265.
286
a3d65d7f0bc3 Add /alias documentation
Mikael Berthe <mikael@lilotux.net>
parents: 277
diff changeset
200
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
201 (without arguments);; Display list of current bindings
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
202 'keycode';; Display the command line bound to this key
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
203 'keycode'=;; Unbind key with code "keycode"
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
204 'keycode' = command line;; Bind "command line" to the key with code "keycode"
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
205
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
206 Example: "/bind 265 = status away" (265 is F1). +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
207 Note: keycodes can be different depending on your ncurses configuration. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
208 Tip: aliases also can be used instead of commands.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
209
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
210 /buffer clear|close|close_all|purge|list::
1139
104676e3389b Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1131
diff changeset
211 /buffer top|bottom|date|%|search_backward|search_forward::
876
e583d617838a Update manpage
Mikael Berthe <mikael@lilotux.net>
parents: 870
diff changeset
212 /buffer scroll_lock|scroll_unlock|scroll_toggle::
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
213 /buffer save filename::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
214 Buddy's buffer manipulation command. Eg. you can search through buffer for "text", clear chat window etc.
199
e574c859190a [/trunk] Changeset 211 by mikael
mikael
parents: 198
diff changeset
215
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
216 'clear';; Clear the current buddy chat window
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
217 'close' [jid];; Empty all contents of the buffer and close the current buddy chat window
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
218 'close_all';; Empty all contents of the chat buffers and close the chat windows
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
219 'purge' [jid];; Clear the current buddy chat window and empty all contents of the chat buffer
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
220 'list';; Display the list of existing buffers, with their length (lines/blocks)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
221 'top';; Jump to the top of the current buddy chat buffer
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
222 'bottom';; Jump to the bottom of the current buddy chat buffer
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
223 'up' [n];; Scroll the buffer up [n] lines (default: half a screen)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
224 'down' [n];; Scroll the buffer down [n] lines (default: half a screen)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
225 'date' [date];; Jump to the first line after the specified [date] in the chat buffer (date format: "YYYY-mm-dd")
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
226 % n;; Jump to position %n of the buddy chat buffer
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
227 'search_backward' text;; Search for [text] in the current buddy chat buffer
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
228 'search_forward' text;; Search for [text] in the current buddy chat buffer
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
229 'scroll_lock';; Lock buffer scrolling
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
230 'scroll_unlock';; Unlock buffer scrolling
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
231 'scroll_toggle';; Toggle buffer scrolling (lock/unlock)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
232 'save' filename;; Save the contents of the current buffer to the file "filename"
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
233
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
234 /chat_disable [--show-roster]::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
235 Disable chat mode. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
236 With --show-roster, the fullscreen mode will be disabled.
199
e574c859190a [/trunk] Changeset 211 by mikael
mikael
parents: 198
diff changeset
237
e574c859190a [/trunk] Changeset 211 by mikael
mikael
parents: 198
diff changeset
238 /clear::
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
239 This command is actually an alias for "/buffer clear". It clears the current buddy chat window.
854
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
240
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
241 /color roster (status wildcard (color|-)|clear)::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
242 /color mucnick nick (color|-)::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
243 /color muc (jid|.|*) [on|preset|off|-]::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
244 The 'color' command allows setting dynamic color properties of the screen.
1242
b335d30881bd Update manpage
Mikael Berthe <mikael@lilotux.net>
parents: 1233
diff changeset
245
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
246 'roster' clear;; Remove all color rules for the roster. All roster items will get its default color.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
247 'roster' status wildcard color;; 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.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
248 'mucnick' nick (color|-);; 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 'preset' coloring mode, but will stay the same in 'on' coloring mode.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
249 'muc' (jid|.|*) [on|preset|off|-];; 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 'on' colors all nicks, 'preset' only the ones manually set by /color mucnick command and 'off' colors none. If not specified, defaults to 'on'. Mode '-' 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 'off'.
854
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
250
298
35cda94e570d Add /connect and /disconnect commands
Mikael Berthe <mikael@lilotux.net>
parents: 290
diff changeset
251 /connect::
35cda94e570d Add /connect and /disconnect commands
Mikael Berthe <mikael@lilotux.net>
parents: 290
diff changeset
252 Establish connection to the Jabber server.
35cda94e570d Add /connect and /disconnect commands
Mikael Berthe <mikael@lilotux.net>
parents: 290
diff changeset
253
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
254 /del::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
255 Delete the current buddy from our roster, unsubscribe from its presence notification and unsubscribe it from ours.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
256
298
35cda94e570d Add /connect and /disconnect commands
Mikael Berthe <mikael@lilotux.net>
parents: 290
diff changeset
257 /disconnect::
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
258 Terminate the connection to the Jabber server. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
259 Note: the roster is only available when the connection to the server is active, so the buddylist is empty when disconnected.
298
35cda94e570d Add /connect and /disconnect commands
Mikael Berthe <mikael@lilotux.net>
parents: 290
diff changeset
260
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
261 /echo message::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
262 Display "message" in the log window.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
263
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
264 /event #n|* accept|ignore|reject [event-specific arguments]::
775
b4befb3052e5 Update NEWS, ChangeLog and documentation
Mikael Berthe <mikael@lilotux.net>
parents: 710
diff changeset
265 /event list::
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
266 Tell mcabber what to do about pending events. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
267 If the first parameter is '*', the command will apply to all queued events. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
268 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.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
269
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
270 #N|* accept [event-specific arguments];; Event number #N/All events will be accepted
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
271 #N|* ignore [event-specific arguments];; Event number #N/All events will be ignored
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
272 #N|* reject [event-specific arguments];; Event number #N/All events will be rejected
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
273 'list';; List all pending events
775
b4befb3052e5 Update NEWS, ChangeLog and documentation
Mikael Berthe <mikael@lilotux.net>
parents: 710
diff changeset
274
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
275 /group fold|unfold|toggle [groupname]::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
276 This command changes the current group display.
775
b4befb3052e5 Update NEWS, ChangeLog and documentation
Mikael Berthe <mikael@lilotux.net>
parents: 710
diff changeset
277
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
278 'fold' [groupname];; Fold (shrink) the current/specified group tree in the roster
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
279 'unfold' [groupname];; Unfold (expand) the current/specified group tree in the roster
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
280 'toggle' [groupname];; Toggle the state (fold/unfold) of the current/specified tree
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
281
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
282 /help [command|+topic]::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
283 Display help for command "command" or topic "topic". +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
284 Example: "/help buffer"
854
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
285
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
286 /iline fchar|bchar|char_fdel|char_bdel|char_swap::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
287 /iline fword|bword|word_bdel|word_fdel::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
288 /iline word_upcase|word_downcase|word_capit::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
289 /iline hist_beginning_search_bwd|hist_beginning_search_fwd::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
290 /iline hist_prev|hist_next::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
291 /iline iline_start|iline_end|iline_fdel|iline_bdel::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
292 /iline iline_accept|iline_accept_down_hist::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
293 /iline compl_do|compl_cancel::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
294 /iline send_multiline::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
295 Input line commands
854
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
296
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
297 'fchar';; Move to the next letter
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
298 'bchar';; Move to the previous letter
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
299 'char_fdel';; Delete the letter at cursor position
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
300 'char_bdel';; Delete the letter before cursor position
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
301 'char_swap';; Transpose chars
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
302 'fword';; Move the cursor forward to the end of the current or next word
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
303 'bword';; Move the cursor back to the start of the current or previous word
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
304 'word_bdel';; Delete the word from cursor position to its start
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
305 'word_fdel';; Delete the word from cursor position to its end
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
306 'word_upcase';; Convert the word from cursor position to its end to upper case
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
307 'word_downcase';; Convert the word from cursor position to its end to down case
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
308 'word_capit';; Capitalize the word from cursor position to its end
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
309 'hist_beginning_search_bwd';; 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)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
310 'hist_beginning_search_fwd';; 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)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
311 'hist_prev';; Previous line of input line history
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
312 'hist_next';; Next line of input line history
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
313 'iline_start';; Go to the beginning of the input line
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
314 'iline_end';; Go to the end of the input line
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
315 'iline_fdel';; Delete from the cursor to the end of line
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
316 'iline_bdel';; Delete from beginning of the line to the cursor
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
317 'iline_accept';; Accept line
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
318 'iline_accept_down_hist';; Accept line and put the next history line in the input line
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
319 'compl_do';; Complete current word, in the input line
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
320 'compl_cancel';; Cancel completion
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
321 'send_multiline';; Send/terminate a multi-line message
199
e574c859190a [/trunk] Changeset 211 by mikael
mikael
parents: 198
diff changeset
322
e574c859190a [/trunk] Changeset 211 by mikael
mikael
parents: 198
diff changeset
323 /info::
440
264f40222872 Update documentation (/info command)
Mikael Berthe <mikael@lilotux.net>
parents: 436
diff changeset
324 Display info on the selected entry (user, agent, group...). +
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
325 For users, resources are displayed with the status, priority and status message (if available) of each resource.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
326
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
327 /module load|unload [-f] module::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
328 /module info module::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
329 /module [list]::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
330 Load, unload or show info on module.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
331
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
332 'load' [-f] module;; Loads specified module. If -f flag is specified, most of module loading errors will be ignored.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
333 'unload' [-f] module;; Unloads specified module. Note: The force flag will not remove any dependent on this modules!
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
334 'info' module;; Shows available information about this module.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
335 ['list'];; Lists modules in a format: [modulename] [reference count] ([Manually/Automatically loaded]) [any extra info, like version or dependencies]
199
e574c859190a [/trunk] Changeset 211 by mikael
mikael
parents: 198
diff changeset
336
210
f64818ba3503 [/trunk] Changeset 222 by mikael
mikael
parents: 208
diff changeset
337 /move [groupname]::
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
338 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't exist, it is created. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
339 Tip: if the chatmode is enabled, you can use "/roster alternate" to jump to the moved buddy.
210
f64818ba3503 [/trunk] Changeset 222 by mikael
mikael
parents: 208
diff changeset
340
839
5759770c1968 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 836
diff changeset
341 /msay begin|verbatim|send|send_to|toggle|toggle_verbatim|abort::
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
342 Send a multi-line message. To write a single message with several lines, the 'multi-line mode' should be used. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
343 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. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
344 The 'begin' subcommand enables multi-line mode. Note that it allows a message subject to be specified. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
345 The 'verbatim' 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. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
346 The 'toggle' 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).
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
347
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
348 'begin' [subject];; Enter multi-line mode
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
349 'verbatim';; Enter verbatim multi-line mode
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
350 'send' [-n|-h];; Send the current multi-line message to the currently selected buddy
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
351 'send_to' [-n|-h] jid;; Send the current multi-line message to "jid"
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
352 'toggle'|'toggle_verbatim';; Switch to/from multi-line mode (begin/send)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
353 'abort';; Leave multi-line mode without sending the message
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
354
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
355 The -n or -h flags turn the message to "normal" or "headline" accordingly, as opposed to default "chat" message.
238
8e30b2bb380e [/trunk] Changeset 251 by mikael
mikael
parents: 236
diff changeset
356
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
357 /otr key::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
358 /otr start|stop|info [jid]::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
359 /otr fingerprint [jid [fpr]]::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
360 /otr smpq|smpr [jid] secret::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
361 /otr smpa [jid]::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
362 You can use the shortcut-jid "." for the currently selected contact.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
363
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
364 'key';; Print the fingerprint of your private key to the Status Buffer
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
365 'start' [jid];; Open an OTR channel to the specified jid (or the currently selected contact)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
366 'stop' [jid];; Close the OTR channel to the specified jid (or the currently selected contact)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
367 'info' [jid];; Show current OTR status for the specified jid (or the currently selected contact)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
368 'fingerprint' [jid [fpr]];; 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.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
369 'smpq' [jid] secret;; Initiate the Socialist Millionaires Protocol with the secret and the buddy
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
370 'smpr' [jid] secret;; Respond to the Initiation of the jid with the secret
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
371 'smpa' [jid];; Abort the running Socialist Millionaires Protocol
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
372
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
373 /otrpolicy::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
374 /otrpolicy (default|jid) (plain|manual|opportunistic|always)::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
375 You can use the shortcut-jid "." for the currently selected contact.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
376
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
377 (without arguments);; Prints all OTR policies to the status buffer
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
378 ('default'|'jid') (plain|manual|opportunistic|always);; Sets either the default policy or the policy for the given jid The plain policy should never be used, because you won'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'll be able to read the message but it won't be saved to the history.
238
8e30b2bb380e [/trunk] Changeset 251 by mikael
mikael
parents: 236
diff changeset
379
1242
b335d30881bd Update manpage
Mikael Berthe <mikael@lilotux.net>
parents: 1233
diff changeset
380 /pgp disable|enable|force|info [jid]::
1096
3d92e648a8db Update manpage
Mikael Berthe <mikael@lilotux.net>
parents: 1086
diff changeset
381 /pgp setkey [jid [key]]::
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
382 This command manipulates PGP settings for the specified jid (by default the currently selected contact). +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
383 Please note that PGP encryption won'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.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
384
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
385 'disable' [jid];; Disable PGP encryption for jid (or the currently selected contact)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
386 'enable' [jid];; Enable PGP encryption for jid (or the currently selected contact)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
387 [+|-]'force' [jid];; Enforce PGP encryption, even for offline messages, and always assume the recipient has PGP support. If a message can't be encrypted (missing key or key id), the messages won't be sent at all. This option is ignored when PGP is disabled.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
388 'info' [jid];; Show current PGP settings for the contact
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
389 'setkey' [jid [key]];; 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.
1096
3d92e648a8db Update manpage
Mikael Berthe <mikael@lilotux.net>
parents: 1086
diff changeset
390
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
391 /quit::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
392 This command closes all connections and quit mcabber.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
393
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
394 /rawxml send string::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
395 Send "string" (raw XML format) to the Jabber server. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
396 No check is done on the string provided. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
397 BEWARE!
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
398 Use this only if you know what you are doing, or you could terminate the connection. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
399 Example: "/rawxml send <presence><show>away</show></presence>"
1096
3d92e648a8db Update manpage
Mikael Berthe <mikael@lilotux.net>
parents: 1086
diff changeset
400
886
e58ae191a25c Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 876
diff changeset
401 /rename name::
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
402 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).
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
403
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
404 /request last|ping|time|vcard|version [jid]::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
405 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.
450
fa93f47a08fe Update manual page
Mikael Berthe <mikael@lilotux.net>
parents: 440
diff changeset
406
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
407 'last';; Request "last" information (usually idle time)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
408 'ping';; 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.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
409 'time';; Request time from the buddy
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
410 'vcard';; Request VCard from the buddy
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
411 'version';; Request version from the buddy
700
3f3c5765a459 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 674
diff changeset
412
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
413 /room join|leave|names|nick|remove|topic|unlock|destroy::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
414 /room privmsg|invite|whois|kick|ban|unban|role|affil::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
415 /room setopt print_status|auto_whois [value]::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
416 /room bookmark [add|del] [-autojoin|+autojoin] [-|nick]::
450
fa93f47a08fe Update manual page
Mikael Berthe <mikael@lilotux.net>
parents: 440
diff changeset
417 The 'room' command handles Multi-User Chat room actions.
fa93f47a08fe Update manual page
Mikael Berthe <mikael@lilotux.net>
parents: 440
diff changeset
418
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
419 'join' [room [nick [pass]]];; 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.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
420 'leave' [message];; Leave the current room
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
421 'names' [--detail|--short|--quiet|--compact];; Display members of the current room
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
422 'nick' newnick;; Change your nickname in the current room
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
423 'privmsg' nick msg;; Send private message "msg" to "nick"
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
424 'remove';; Remove the current room from the roster (you must have left this room before)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
425 'topic' -|newtopic;; Set topic for current room
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
426 'unlock';; Unlock current room (if you are the owner)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
427 'destroy' [reason];; Destroy the current room (use with care!)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
428 'whois' nick;; Display MUC information about "nick"
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
429 'ban' jid [reason];; Ban jid from the current room
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
430 'unban' jid;; Unban jid from the current room
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
431 'invite' jid [reason];; Invite jid to the current room
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
432 'kick' nick [reason];; Kick "nick" from the current room
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
433 'role' jid role [reason];; Change jid's role (role can be "none", "visitor", "participant", "moderator")
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
434 'affil' jid affil [reason];; Change jid's affiliation (affil can be "none", "member", "admin", "owner")
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
435 'setopt' print_status|auto_whois [value];; 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.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
436 'bookmark' [add|del] [-autojoin|+autojoin] [-|nick];; 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.
199
e574c859190a [/trunk] Changeset 211 by mikael
mikael
parents: 198
diff changeset
437
1086
5e2e647e781b Add command /roster group_prev|group_next and update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1083
diff changeset
438 /roster bottom|top|up|down|group_prev|group_next::
330
a9013124ede6 Add "/roster alternate"
Mikael Berthe <mikael@lilotux.net>
parents: 320
diff changeset
439 /roster alternate|unread_first|unread_next::
265
49e9e02dd6d0 Add "/roster search" command
mikael@frmp8452
parents: 263
diff changeset
440 /roster search bud::
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
441 /roster display|hide_offline|show_offline|toggle_offline::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
442 /roster item_lock|item_unlock|item_toggle_lock::
1086
5e2e647e781b Add command /roster group_prev|group_next and update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1083
diff changeset
443 /roster hide|show|toggle::
1062
9207f2efb921 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1037
diff changeset
444 /roster note [-|text]::
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
445 The 'roster' command manipulates the roster/buddylist. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
446 Here are the available parameters:
199
e574c859190a [/trunk] Changeset 211 by mikael
mikael
parents: 198
diff changeset
447
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
448 'bottom';; Jump to the bottom of the roster
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
449 'top';; Jump to the top of the roster
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
450 'up' [n];; Move up [n lines] in the roster
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
451 'down' [n];; Move down [n lines] in the roster
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
452 'group_prev';; Jump to the previous group in the roster
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
453 'group_next';; Jump to the next group in the roster
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
454 'alternate';; 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).
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
455 'unread_first';; Jump to the first unread message
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
456 'unread_next';; Jump to the next unread message
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
457 'search' bud;; Search for a buddy with a name or jid containing "bud" (only in the displayed buddylist)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
458 'display' [mask];; 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.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
459 'hide_offline';; Hide offline buddies (same as /roster display ofdna)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
460 'show_offline';; Show offline buddies (same as /roster display ofdna_)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
461 'toggle_offline';; Toggle display of offline buddies
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
462 'item_lock' [jid];; Lock the roster item so it remains visible regardless of its status
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
463 'item_unlock' [jid];; Undo the effects of item_lock
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
464 'item_toggle_lock' [jid];; Invert the current lock flag
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
465 'hide';; Hide roster (full-width chat window)
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
466 'show';; Show roster
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
467 'toggle';; Toggle roster visibility
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
468 'note' [-|text];; Set/update/delete an annotation. If there is no text, the current item's annotation is displayed -- if you are in the status buffer, all notes are displayed. If text is "-", the note is erased.
199
e574c859190a [/trunk] Changeset 211 by mikael
mikael
parents: 198
diff changeset
469
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
470 /say [-n|-h|--] text::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
471 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. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
472 The "-n" flag turns the message to "normal" type, "-h" to "headline". "--" can be used to send chat message beginning with -n or -h.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
473
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
474 /say_to [-n|-h] [-q] [-f file] jid text::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
475 Send the "text" message to the specified jid. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
476 Please note that this command doesn'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. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
477 The "-n" flag turns the message to "normal" type, "-h" to "headline". "--" can be used to send chat messages beginning with -n or -h. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
478 When "-q" is used, the message will be sent in the background and will not change the current active window. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
479 A text file can be provided with the "-f" switch (in which case there's no need to pass a text argument after the jid, of course).
199
e574c859190a [/trunk] Changeset 211 by mikael
mikael
parents: 198
diff changeset
480
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
481 /screen_refresh::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
482 Refresh the mcabber screen.
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
483
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
484 /set option [= value]::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
485 Display or set an option value.
480
882e1acae422 Add /say_to command
Mikael Berthe <mikael@lilotux.net>
parents: 475
diff changeset
486
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
487 /source pattern::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
488 Read configuration files, that match glob pattern (sorted in alphabetical order).
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
489
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
490 /status [online|avail|invisible|free|dnd|notavail|away [-|statusmessage]]::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
491 /status message -|statusmessage::
522
fdd1637db7f3 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 511
diff changeset
492 Show or set the current status. +
fdd1637db7f3 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 511
diff changeset
493 If no status is specified, display the current status. +
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
494 If a status message is specified, it will overrride the message* variables (these variables can be set in the configuration file). +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
495 If no relevant message* variable is set and no status message provided, the current status message is kept. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
496 If StatusMessage is "-", the current status message is cleared. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
497 With the "/status message" command, mcabber will update the message while preserving the status.
199
e574c859190a [/trunk] Changeset 211 by mikael
mikael
parents: 198
diff changeset
498
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
499 /status_to jid online|avail|invisible|free|dnd|notavail|away [statusmessage]::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
500 /status_to jid message statusmessage::
450
fa93f47a08fe Update manual page
Mikael Berthe <mikael@lilotux.net>
parents: 440
diff changeset
501 Send the requested status to the specified Jabber user. +
660
ef7f0b58a159 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 639
diff changeset
502 If the specified jid is ".", the current buddy is used. +
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
503 Note: this status will be overridden by subsequent "/status" commands. If you are using the auto-away feature, the status will overridden too. +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
504 Note: The jid can include a resource (i.e. \user@server/resource).
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
505
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
506 /version::
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
507 Display current version of mcabber.
450
fa93f47a08fe Update manual page
Mikael Berthe <mikael@lilotux.net>
parents: 440
diff changeset
508
199
e574c859190a [/trunk] Changeset 211 by mikael
mikael
parents: 198
diff changeset
509 CONFIGURATION FILE
e574c859190a [/trunk] Changeset 211 by mikael
mikael
parents: 198
diff changeset
510 ------------------
854
bfaab692a683 Update manpage (pmw)
Mikael Berthe <mikael@lilotux.net>
parents: 841
diff changeset
511 See the provided sample configuration file, which should be self-documenting.
198
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
512
200
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
513 FILES
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
514 -----
202
9bdc6d9996f6 [/trunk] Changeset 214 by mikael
mikael
parents: 200
diff changeset
515 The following files can be used by `mcabber(1)`:
200
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
516
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
517 $HOME/.mcabber/mcabberrc Default configuration file
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
518 $HOME/.mcabberrc Configuration file used if no other has been found
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
519 $HOME/.mcabber/histo/ Default directory for storing chat history files, if enabled
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
520 /usr/share/mcabber/help/ Default directory for online help files
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
521 /usr/lib/mcabber/ Default directory for modules
200
f042a2400809 [/trunk] Changeset 212 by mikael
mikael
parents: 199
diff changeset
522
198
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
523 BUGS
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
524 ----
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
525 Certainly. Please tell me if you find one! :-) +
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
526 Please visit our website to find out about the MUC room and the bug tracker.
198
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
527
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
528 AUTHOR
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
529 ------
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
530 Written by mailto:mikael@lilotux.net[Mikael BERTHE] and others
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
531 (see AUTHORS file). +
198
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
532
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
533 RESOURCES
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
534 ---------
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
535 http://mcabber.com/[Main web site]
198
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
536
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
537 COPYING
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
538 -------
1759
921429804e20 Update documentation
Mikael Berthe <mikael@lilotux.net>
parents: 1606
diff changeset
539 Copyright \(C) 2005-2010 Mikael Berthe and others. +
198
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
540
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
541 Free use of this software is granted under the terms of the GNU General Public
4cfea50155bf [/trunk] Changeset 210 by mikael
mikael
parents:
diff changeset
542 License (GPL).