Mercurial > ~mikael > mcabber > hg
comparison mcabber/doc/mcabber.1.txt @ 2304:fa8365fb6ac2
[PATCH 1/3] New option: vi_mode
If the new vi_mode option is set to 1, let MCabber's non-chat mode
accept a few commands loosely based on those available in vi(1)'s normal
mode, e.g.:
A Call "/roster unread_first".
a Call "/roster unread_next".
F Call "/roster group_prev".
f Call "/roster group_next".
G Call "/roster bottom".
gg Call "/roster top".
i Enter chat mode.
[<n>]j Call "/roster down [<n>]".
[<n>]k Call "/roster up [<n>]".
n Repeat the previous search (if any).
O Call "/roster unread_first" and open chat window.
o Call "/roster unread_next" and open chat window.
ZZ Call "/quit".
zM Call "/group fold" for all groups.
zR Call "/group unfold" for all groups.
<Space> Call "/group toggle" for the current group.
'' Call "/roster alternate".
! Toggle attention flag for current buddy.
# Toggle unread messages flag for current buddy.
/<str> Call "/roster search <str>".
:q Call "/quit".
:wq Call "/quit".
:x Call "/quit".
:<n> Jump to line <n> in the roster.
:<cmd> Call "/<cmd>" (unless <cmd> matches one of the above commands).
author | Holger Weiß <holger@zedat.fu-berlin.de> |
---|---|
date | Wed, 22 Jul 2015 19:25:22 +0200 |
parents | 245ec6d73380 |
children | 0d5660c6b4aa |
comparison
equal
deleted
inserted
replaced
2303:4f3821bda633 | 2304:fa8365fb6ac2 |
---|---|
61 "main status line" and reflects mcabber general status. The other line | 61 "main status line" and reflects mcabber general status. The other line |
62 is the "chat status line" and shows the status of the currently selected | 62 is the "chat status line" and shows the status of the currently selected |
63 buddy. | 63 buddy. |
64 | 64 |
65 To display buddies chat buffers, you will have to enter 'chat mode'. | 65 To display buddies chat buffers, you will have to enter 'chat mode'. |
66 You can enter chat mode by pressing enter, and leave chat mode with the ESC | 66 You can enter chat mode by pressing enter (unless 'vi mode' is enabled), and |
67 key. Simply sending a message will also enable chat mode. | 67 leave chat mode with the ESC key. Simply sending a message will also enable |
68 chat mode (unless 'vi mode' is enabled). | |
68 | 69 |
69 There are several advantages to the two-mode implementation: first, it allows | 70 There are several advantages to the two-mode implementation: first, it allows |
70 accurate "unread" message functionality, as described in the next section; | 71 accurate "unread" message functionality, as described in the next section; |
71 without this, merely scrolling to a specific buddy will "read" the new | 72 without this, merely scrolling to a specific buddy will "read" the new |
72 messages of all buddies in-between. Second, it allows quickly hiding the | 73 messages of all buddies in-between. Second, it allows quickly hiding the |
112 Ctrl-t:: Transpose chars | 113 Ctrl-t:: Transpose chars |
113 Ctrl-o:: Accept line and put the next history line in the input line (accept-line-and-down-history) | 114 Ctrl-o:: Accept line and put the next history line in the input line (accept-line-and-down-history) |
114 | 115 |
115 Additional key bindings may be specified using the '/bind' command described | 116 Additional key bindings may be specified using the '/bind' command described |
116 in the COMMANDS section. | 117 in the COMMANDS section. |
118 | |
119 VI MODE | |
120 ------- | |
121 If the 'vi_mode' option is set to 1, `mcabber(1)` accepts a few commands | |
122 loosely based on those available in `vi(1)`'s normal mode. In this case, chat | |
123 mode is not entered by pressing enter, and messages cannot be composed outside | |
124 of the chat mode. The following commands are accepted: | |
125 | |
126 A:: Call "/roster unread_first". | |
127 a:: Call "/roster unread_next". | |
128 F:: Call "/roster group_prev". | |
129 f:: Call "/roster group_next". | |
130 G:: Call "/roster bottom". | |
131 gg:: Call "/roster top". | |
132 i:: Enter chat mode. | |
133 ['n']j:: Call "/roster down ['n']". | |
134 ['n']k:: Call "/roster up ['n']". | |
135 n:: Repeat the previous search (if any). | |
136 O:: Call "/roster unread_first" and open chat window. | |
137 o:: Call "/roster unread_next" and open chat window. | |
138 ZZ:: Call "/quit". | |
139 zM:: Call "/group fold" for all groups. | |
140 zR:: Call "/group unfold" for all groups. | |
141 \'':: Call "/roster alternate". | |
142 !:: Toggle attention flag for current buddy. | |
143 #:: Toggle unread messages flag for current buddy. | |
144 <Space>:: Call "/group toggle" for the current group. | |
145 | |
146 A leading slash enables search mode: | |
147 | |
148 /'string':: Call "/roster search 'string'". | |
149 | |
150 A leading colon enabled command-line mode: | |
151 | |
152 :q:: Call "/quit". | |
153 :'n':: Jump to line 'n' in the roster. | |
154 :'cmd-line':: Call "/'cmd-line'" (unless the 'cmd-line' matches one of the | |
155 above commands). | |
156 | |
157 Commands entered with a leading colon and searches are either submitted by | |
158 pressing enter or aborted by hitting escape. In either case, `mcabber(1)` | |
159 returns to the normal (non-chat) mode. History editing is supported in | |
160 command-line mode and in search mode. In command-line mode, tab completion is | |
161 supported as well. | |
117 | 162 |
118 MCABBER'S ROSTER | 163 MCABBER'S ROSTER |
119 ---------------- | 164 ---------------- |
120 The first listed item on the roster is '[status]', which keeps a log of | 165 The first listed item on the roster is '[status]', which keeps a log of |
121 everything that appears in the short log window below the main chat area. | 166 everything that appears in the short log window below the main chat area. |