Mercurial > vim
annotate runtime/doc/term.txt @ 10640:27be410d6d29 v8.0.0210
patch 8.0.0210: no support for bracketed paste
commit https://github.com/vim/vim/commit/ec2da36ca48b40c0654b32a8d2c9f52e796daa5e
Author: Bram Moolenaar <Bram@vim.org>
Date: Sat Jan 21 20:04:22 2017 +0100
patch 8.0.0210: no support for bracketed paste
Problem: Vim does not support bracketed paste, as implemented by xterm and
other terminals.
Solution: Add t_BE, t_BD, t_PS and t_PE.
author | Christian Brabandt <cb@256bit.org> |
---|---|
date | Sat, 21 Jan 2017 20:15:04 +0100 |
parents | 9f48eab77d62 |
children | 523cd59d6db0 |
rev | line source |
---|---|
10198
9f48eab77d62
commit https://github.com/vim/vim/commit/bb76f24af2010943387ce696a7092175b4ecccf2
Christian Brabandt <cb@256bit.org>
parents:
10140
diff
changeset
|
1 *term.txt* For Vim version 8.0. Last change: 2016 Sep 02 |
7 | 2 |
3 | |
4 VIM REFERENCE MANUAL by Bram Moolenaar | |
5 | |
6 | |
7 Terminal information *terminal-info* | |
8 | |
9 Vim uses information about the terminal you are using to fill the screen and | |
10 recognize what keys you hit. If this information is not correct, the screen | |
11 may be messed up or keys may not be recognized. The actions which have to be | |
12 performed on the screen are accomplished by outputting a string of | |
13 characters. Special keys produce a string of characters. These strings are | |
14 stored in the terminal options, see |terminal-options|. | |
15 | |
16 NOTE: Most of this is not used when running the |GUI|. | |
17 | |
18 1. Startup |startup-terminal| | |
19 2. Terminal options |terminal-options| | |
20 3. Window size |window-size| | |
21 4. Slow and fast terminals |slow-fast-terminal| | |
22 5. Using the mouse |mouse-using| | |
23 | |
24 ============================================================================== | |
25 1. Startup *startup-terminal* | |
26 | |
27 When Vim is started a default terminal type is assumed. For the Amiga this is | |
28 a standard CLI window, for MS-DOS the pc terminal, for Unix an ansi terminal. | |
29 A few other terminal types are always available, see below |builtin-terms|. | |
30 | |
31 You can give the terminal name with the '-T' Vim argument. If it is not given | |
32 Vim will try to get the name from the TERM environment variable. | |
33 | |
34 *termcap* *terminfo* *E557* *E558* *E559* | |
35 On Unix the terminfo database or termcap file is used. This is referred to as | |
36 "termcap" in all the documentation. At compile time, when running configure, | |
37 the choice whether to use terminfo or termcap is done automatically. When | |
38 running Vim the output of ":version" will show |+terminfo| if terminfo is | |
39 used. Also see |xterm-screens|. | |
40 | |
41 On non-Unix systems a termcap is only available if Vim was compiled with | |
42 TERMCAP defined. | |
43 | |
44 *builtin-terms* *builtin_terms* | |
45 Which builtin terminals are available depends on a few defines in feature.h, | |
46 which need to be set at compile time: | |
47 define output of ":version" terminals builtin ~ | |
48 NO_BUILTIN_TCAPS -builtin_terms none | |
49 SOME_BUILTIN_TCAPS +builtin_terms most common ones (default) | |
50 ALL_BUILTIN_TCAPS ++builtin_terms all available | |
51 | |
52 You can see a list of available builtin terminals with ":set term=xxx" (when | |
53 not running the GUI). Also see |+builtin_terms|. | |
54 | |
55 If the termcap code is included Vim will try to get the strings for the | |
56 terminal you are using from the termcap file and the builtin termcaps. Both | |
57 are always used, if an entry for the terminal you are using is present. Which | |
58 one is used first depends on the 'ttybuiltin' option: | |
59 | |
60 'ttybuiltin' on 1: builtin termcap 2: external termcap | |
61 'ttybuiltin' off 1: external termcap 2: builtin termcap | |
62 | |
63 If an option is missing in one of them, it will be obtained from the other | |
64 one. If an option is present in both, the one first encountered is used. | |
65 | |
66 Which external termcap file is used varies from system to system and may | |
67 depend on the environment variables "TERMCAP" and "TERMPATH". See "man | |
68 tgetent". | |
69 | |
70 Settings depending on terminal *term-dependent-settings* | |
71 | |
72 If you want to set options or mappings, depending on the terminal name, you | |
73 can do this best in your .vimrc. Example: > | |
74 | |
75 if &term == "xterm" | |
76 ... xterm maps and settings ... | |
77 elseif &term =~ "vt10." | |
78 ... vt100, vt102 maps and settings ... | |
79 endif | |
80 < | |
81 *raw-terminal-mode* | |
82 For normal editing the terminal will be put into "raw" mode. The strings | |
83 defined with 't_ti' and 't_ks' will be sent to the terminal. Normally this | |
84 puts the terminal in a state where the termcap codes are valid and activates | |
85 the cursor and function keys. When Vim exits the terminal will be put back | |
86 into the mode it was before Vim started. The strings defined with 't_te' and | |
87 't_ke' will be sent to the terminal. On the Amiga, with commands that execute | |
88 an external command (e.g., "!!"), the terminal will be put into Normal mode | |
89 for a moment. This means that you can stop the output to the screen by | |
90 hitting a printing key. Output resumes when you hit <BS>. | |
91 | |
10640
27be410d6d29
patch 8.0.0210: no support for bracketed paste
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
92 *xterm-bracketed-paste* |
27be410d6d29
patch 8.0.0210: no support for bracketed paste
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
93 When the 't_BE' option is set then 't_BE' will be sent to the |
27be410d6d29
patch 8.0.0210: no support for bracketed paste
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
94 terminal when entering "raw" mode and 't_BD' when leaving "raw" mode. The |
27be410d6d29
patch 8.0.0210: no support for bracketed paste
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
95 terminal is then expected to put 't_PS' before pasted text and 't_PE' after |
27be410d6d29
patch 8.0.0210: no support for bracketed paste
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
96 pasted text. This way Vim can separate text that is pasted from characters |
27be410d6d29
patch 8.0.0210: no support for bracketed paste
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
97 that are typed. The pasted text is handled like when the middle mouse button |
27be410d6d29
patch 8.0.0210: no support for bracketed paste
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
98 is used. |
27be410d6d29
patch 8.0.0210: no support for bracketed paste
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
99 |
27be410d6d29
patch 8.0.0210: no support for bracketed paste
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
100 Note that in some situations Vim will not recognize the bracketed paste and |
27be410d6d29
patch 8.0.0210: no support for bracketed paste
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
101 you will get the raw text. In other situations Vim will only get the first |
27be410d6d29
patch 8.0.0210: no support for bracketed paste
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
102 pasted character and drop the rest, e.g. when using the "r" command. |
27be410d6d29
patch 8.0.0210: no support for bracketed paste
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
103 |
7 | 104 *cs7-problem* |
105 Note: If the terminal settings are changed after running Vim, you might have | |
106 an illegal combination of settings. This has been reported on Solaris 2.5 | |
107 with "stty cs8 parenb", which is restored as "stty cs7 parenb". Use | |
108 "stty cs8 -parenb -istrip" instead, this is restored correctly. | |
109 | |
110 Some termcap entries are wrong in the sense that after sending 't_ks' the | |
111 cursor keys send codes different from the codes defined in the termcap. To | |
112 avoid this you can set 't_ks' (and 't_ke') to empty strings. This must be | |
113 done during initialization (see |initialization|), otherwise it's too late. | |
114 | |
115 Some termcap entries assume that the highest bit is always reset. For | |
116 example: The cursor-up entry for the Amiga could be ":ku=\E[A:". But the | |
117 Amiga really sends "\233A". This works fine if the highest bit is reset, | |
118 e.g., when using an Amiga over a serial line. If the cursor keys don't work, | |
119 try the entry ":ku=\233A:". | |
120 | |
121 Some termcap entries have the entry ":ku=\E[A:". But the Amiga really sends | |
122 "\233A". On output "\E[" and "\233" are often equivalent, on input they | |
123 aren't. You will have to change the termcap entry, or change the key code with | |
124 the :set command to fix this. | |
125 | |
126 Many cursor key codes start with an <Esc>. Vim must find out if this is a | |
127 single hit of the <Esc> key or the start of a cursor key sequence. It waits | |
128 for a next character to arrive. If it does not arrive within one second a | |
129 single <Esc> is assumed. On very slow systems this may fail, causing cursor | |
130 keys not to work sometimes. If you discover this problem reset the 'timeout' | |
131 option. Vim will wait for the next character to arrive after an <Esc>. If | |
132 you want to enter a single <Esc> you must type it twice. Resetting the | |
133 'esckeys' option avoids this problem in Insert mode, but you lose the | |
134 possibility to use cursor and function keys in Insert mode. | |
135 | |
136 On the Amiga the recognition of window resizing is activated only when the | |
137 terminal name is "amiga" or "builtin_amiga". | |
138 | |
139 Some terminals have confusing codes for the cursor keys. The televideo 925 is | |
140 such a terminal. It sends a CTRL-H for cursor-left. This would make it | |
141 impossible to distinguish a backspace and cursor-left. To avoid this problem | |
142 CTRL-H is never recognized as cursor-left. | |
143 | |
144 *vt100-cursor-keys* *xterm-cursor-keys* | |
145 Other terminals (e.g., vt100 and xterm) have cursor keys that send <Esc>OA, | |
146 <Esc>OB, etc. Unfortunately these are valid commands in insert mode: Stop | |
147 insert, Open a new line above the new one, start inserting 'A', 'B', etc. | |
148 Instead of performing these commands Vim will erroneously recognize this typed | |
149 key sequence as a cursor key movement. To avoid this and make Vim do what you | |
150 want in either case you could use these settings: > | |
151 :set notimeout " don't timeout on mappings | |
152 :set ttimeout " do timeout on terminal key codes | |
153 :set timeoutlen=100 " timeout after 100 msec | |
1621 | 154 This requires the key-codes to be sent within 100 msec in order to recognize |
7 | 155 them as a cursor key. When you type you normally are not that fast, so they |
156 are recognized as individual typed commands, even though Vim receives the same | |
157 sequence of bytes. | |
158 | |
159 *vt100-function-keys* *xterm-function-keys* | |
160 An xterm can send function keys F1 to F4 in two modes: vt100 compatible or | |
179 | 161 not. Because Vim may not know what the xterm is sending, both types of keys |
7 | 162 are recognized. The same happens for the <Home> and <End> keys. |
163 normal vt100 ~ | |
164 <F1> t_k1 <Esc>[11~ <xF1> <Esc>OP *<xF1>-xterm* | |
165 <F2> t_k2 <Esc>[12~ <xF2> <Esc>OQ *<xF2>-xterm* | |
166 <F3> t_k3 <Esc>[13~ <xF3> <Esc>OR *<xF3>-xterm* | |
167 <F4> t_k4 <Esc>[14~ <xF4> <Esc>OS *<xF4>-xterm* | |
168 <Home> t_kh <Esc>[7~ <xHome> <Esc>OH *<xHome>-xterm* | |
169 <End> t_@7 <Esc>[4~ <xEnd> <Esc>OF *<xEnd>-xterm* | |
170 | |
171 When Vim starts, <xF1> is mapped to <F1>, <xF2> to <F2> etc. This means that | |
172 by default both codes do the same thing. If you make a mapping for <xF2>, | |
173 because your terminal does have two keys, the default mapping is overwritten, | |
174 thus you can use the <F2> and <xF2> keys for something different. | |
175 | |
176 *xterm-shifted-keys* | |
177 Newer versions of xterm support shifted function keys and special keys. Vim | |
178 recognizes most of them. Use ":set termcap" to check which are supported and | |
179 what the codes are. Mostly these are not in a termcap, they are only | |
180 supported by the builtin_xterm termcap. | |
181 | |
179 | 182 *xterm-modifier-keys* |
183 Newer versions of xterm support Alt and Ctrl for most function keys. To avoid | |
184 having to add all combinations of Alt, Ctrl and Shift for every key a special | |
185 sequence is recognized at the end of a termcap entry: ";*X". The "X" can be | |
186 any character, often '~' is used. The ";*" stands for an optional modifier | |
187 argument. ";2" is Shift, ";3" is Alt, ";5" is Ctrl and ";9" is Meta (when | |
188 it's different from Alt). They can be combined. Examples: > | |
189 :set <F8>=^[[19;*~ | |
190 :set <Home>=^[[1;*H | |
191 Another speciality about these codes is that they are not overwritten by | |
192 another code. That is to avoid that the codes obtained from xterm directly | |
193 |t_RV| overwrite them. | |
7 | 194 *xterm-scroll-region* |
195 The default termcap entry for xterm on Sun and other platforms does not | |
196 contain the entry for scroll regions. Add ":cs=\E[%i%d;%dr:" to the xterm | |
197 entry in /etc/termcap and everything should work. | |
198 | |
199 *xterm-end-home-keys* | |
200 On some systems (at least on FreeBSD with XFree86 3.1.2) the codes that the | |
201 <End> and <Home> keys send contain a <Nul> character. To make these keys send | |
202 the proper key code, add these lines to your ~/.Xdefaults file: | |
203 | |
204 *VT100.Translations: #override \n\ | |
205 <Key>Home: string("0x1b") string("[7~") \n\ | |
206 <Key>End: string("0x1b") string("[8~") | |
207 | |
208 *xterm-8bit* *xterm-8-bit* | |
209 Xterm can be run in a mode where it uses 8-bit escape sequences. The CSI code | |
210 is used instead of <Esc>[. The advantage is that an <Esc> can quickly be | |
211 recognized in Insert mode, because it can't be confused with the start of a | |
212 special key. | |
213 For the builtin termcap entries, Vim checks if the 'term' option contains | |
214 "8bit" anywhere. It then uses 8-bit characters for the termcap entries, the | |
215 mouse and a few other things. You would normally set $TERM in your shell to | |
216 "xterm-8bit" and Vim picks this up and adjusts to the 8-bit setting | |
217 automatically. | |
218 When Vim receives a response to the |t_RV| (request version) sequence and it | |
219 starts with CSI, it assumes that the terminal is in 8-bit mode and will | |
220 convert all key sequences to their 8-bit variants. | |
221 | |
222 ============================================================================== | |
667 | 223 2. Terminal options *terminal-options* *termcap-options* *E436* |
7 | 224 |
225 The terminal options can be set just like normal options. But they are not | |
226 shown with the ":set all" command. Instead use ":set termcap". | |
227 | |
228 It is always possible to change individual strings by setting the | |
229 appropriate option. For example: > | |
230 :set t_ce=^V^[[K (CTRL-V, <Esc>, [, K) | |
231 | |
232 {Vi: no terminal options. You have to exit Vi, edit the termcap entry and | |
233 try again} | |
234 | |
235 The options are listed below. The associated termcap code is always equal to | |
236 the last two characters of the option name. Only one termcap code is | |
237 required: Cursor motion, 't_cm'. | |
238 | |
6602 | 239 The options 't_da', 't_db', 't_ms', 't_xs', 't_xn' represent flags in the |
240 termcap. When the termcap flag is present, the option will be set to "y". | |
241 But any non-empty string means that the flag is set. An empty string means | |
242 that the flag is not set. 't_CS' works like this too, but it isn't a termcap | |
243 flag. | |
7 | 244 |
245 OUTPUT CODES | |
246 option meaning ~ | |
247 | |
248 t_AB set background color (ANSI) *t_AB* *'t_AB'* | |
249 t_AF set foreground color (ANSI) *t_AF* *'t_AF'* | |
250 t_AL add number of blank lines *t_AL* *'t_AL'* | |
251 t_al add new blank line *t_al* *'t_al'* | |
252 t_bc backspace character *t_bc* *'t_bc'* | |
253 t_cd clear to end of screen *t_cd* *'t_cd'* | |
254 t_ce clear to end of line *t_ce* *'t_ce'* | |
255 t_cl clear screen *t_cl* *'t_cl'* | |
256 t_cm cursor motion (required!) *E437* *t_cm* *'t_cm'* | |
257 t_Co number of colors *t_Co* *'t_Co'* | |
258 t_CS if non-empty, cursor relative to scroll region *t_CS* *'t_CS'* | |
259 t_cs define scrolling region *t_cs* *'t_cs'* | |
260 t_CV define vertical scrolling region *t_CV* *'t_CV'* | |
261 t_da if non-empty, lines from above scroll down *t_da* *'t_da'* | |
262 t_db if non-empty, lines from below scroll up *t_db* *'t_db'* | |
263 t_DL delete number of lines *t_DL* *'t_DL'* | |
264 t_dl delete line *t_dl* *'t_dl'* | |
265 t_fs set window title end (from status line) *t_fs* *'t_fs'* | |
266 t_ke exit "keypad transmit" mode *t_ke* *'t_ke'* | |
267 t_ks start "keypad transmit" mode *t_ks* *'t_ks'* | |
268 t_le move cursor one char left *t_le* *'t_le'* | |
269 t_mb blinking mode *t_mb* *'t_mb'* | |
270 t_md bold mode *t_md* *'t_md'* | |
271 t_me Normal mode (undoes t_mr, t_mb, t_md and color) *t_me* *'t_me'* | |
272 t_mr reverse (invert) mode *t_mr* *'t_mr'* | |
273 *t_ms* *'t_ms'* | |
274 t_ms if non-empty, cursor can be moved in standout/inverse mode | |
275 t_nd non destructive space character *t_nd* *'t_nd'* | |
276 t_op reset to original color pair *t_op* *'t_op'* | |
277 t_RI cursor number of chars right *t_RI* *'t_RI'* | |
278 t_Sb set background color *t_Sb* *'t_Sb'* | |
279 t_Sf set foreground color *t_Sf* *'t_Sf'* | |
280 t_se standout end *t_se* *'t_se'* | |
281 t_so standout mode *t_so* *'t_so'* | |
282 t_sr scroll reverse (backward) *t_sr* *'t_sr'* | |
283 t_te out of "termcap" mode *t_te* *'t_te'* | |
284 t_ti put terminal in "termcap" mode *t_ti* *'t_ti'* | |
285 t_ts set window title start (to status line) *t_ts* *'t_ts'* | |
286 t_ue underline end *t_ue* *'t_ue'* | |
287 t_us underline mode *t_us* *'t_us'* | |
204 | 288 t_Ce undercurl end *t_Ce* *'t_Ce'* |
289 t_Cs undercurl mode *t_Cs* *'t_Cs'* | |
7 | 290 t_ut clearing uses the current background color *t_ut* *'t_ut'* |
291 t_vb visual bell *t_vb* *'t_vb'* | |
292 t_ve cursor visible *t_ve* *'t_ve'* | |
293 t_vi cursor invisible *t_vi* *'t_vi'* | |
294 t_vs cursor very visible *t_vs* *'t_vs'* | |
295 *t_xs* *'t_xs'* | |
296 t_xs if non-empty, standout not erased by overwriting (hpterm) | |
6602 | 297 *t_xn* *'t_xn'* |
6647 | 298 t_xn if non-empty, writing a character at the last screen cell |
299 does not cause scrolling | |
7 | 300 t_ZH italics mode *t_ZH* *'t_ZH'* |
301 t_ZR italics end *t_ZR* *'t_ZR'* | |
302 | |
303 Added by Vim (there are no standard codes for these): | |
304 t_IS set icon text start *t_IS* *'t_IS'* | |
305 t_IE set icon text end *t_IE* *'t_IE'* | |
306 t_WP set window position (Y, X) in pixels *t_WP* *'t_WP'* | |
307 t_WS set window size (height, width) in characters *t_WS* *'t_WS'* | |
856 | 308 t_SI start insert mode (bar cursor shape) *t_SI* *'t_SI'* |
6727 | 309 t_SR start replace mode (underline cursor shape) *t_SR* *'t_SR'* |
310 t_EI end insert or replace mode (block cursor shape) *t_EI* *'t_EI'* | |
500 | 311 |termcap-cursor-shape| |
7 | 312 t_RV request terminal version string (for xterm) *t_RV* *'t_RV'* |
313 |xterm-8bit| |v:termresponse| |'ttymouse'| |xterm-codes| | |
4229 | 314 t_u7 request cursor position (for xterm) *t_u7* *'t_u7'* |
315 see |'ambiwidth'| | |
6884 | 316 t_RB request terminal background color *t_RB* *'t_RB'* |
8969
c83e2c1e7f2b
commit https://github.com/vim/vim/commit/8a633e3427b47286869aa4b96f2bfc1fe65b25cd
Christian Brabandt <cb@256bit.org>
parents:
8951
diff
changeset
|
317 t_8f set foreground color (R, G, B) *t_8f* *'t_8f'* |
c83e2c1e7f2b
commit https://github.com/vim/vim/commit/8a633e3427b47286869aa4b96f2bfc1fe65b25cd
Christian Brabandt <cb@256bit.org>
parents:
8951
diff
changeset
|
318 |xterm-true-color| |
c83e2c1e7f2b
commit https://github.com/vim/vim/commit/8a633e3427b47286869aa4b96f2bfc1fe65b25cd
Christian Brabandt <cb@256bit.org>
parents:
8951
diff
changeset
|
319 t_8b set background color (R, G, B) *t_8b* *'t_8b'* |
c83e2c1e7f2b
commit https://github.com/vim/vim/commit/8a633e3427b47286869aa4b96f2bfc1fe65b25cd
Christian Brabandt <cb@256bit.org>
parents:
8951
diff
changeset
|
320 |xterm-true-color| |
10640
27be410d6d29
patch 8.0.0210: no support for bracketed paste
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
321 t_BE enable bracketed paste mode *t_BE* *'t_BE'* |
27be410d6d29
patch 8.0.0210: no support for bracketed paste
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
322 |xterm-bracketed-paste| |
27be410d6d29
patch 8.0.0210: no support for bracketed paste
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
323 t_BD disable bracketed paste mode *t_BD* *'t_BD'* |
27be410d6d29
patch 8.0.0210: no support for bracketed paste
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
324 |xterm-bracketed-paste| |
7 | 325 |
326 KEY CODES | |
327 Note: Use the <> form if possible | |
328 | |
329 option name meaning ~ | |
330 | |
331 t_ku <Up> arrow up *t_ku* *'t_ku'* | |
332 t_kd <Down> arrow down *t_kd* *'t_kd'* | |
333 t_kr <Right> arrow right *t_kr* *'t_kr'* | |
334 t_kl <Left> arrow left *t_kl* *'t_kl'* | |
180 | 335 <xUp> alternate arrow up *<xUp>* |
336 <xDown> alternate arrow down *<xDown>* | |
337 <xRight> alternate arrow right *<xRight>* | |
338 <xLeft> alternate arrow left *<xLeft>* | |
7 | 339 <S-Up> shift arrow up |
340 <S-Down> shift arrow down | |
341 t_%i <S-Right> shift arrow right *t_%i* *'t_%i'* | |
342 t_#4 <S-Left> shift arrow left *t_#4* *'t_#4'* | |
343 t_k1 <F1> function key 1 *t_k1* *'t_k1'* | |
344 <xF1> alternate F1 *<xF1>* | |
345 t_k2 <F2> function key 2 *<F2>* *t_k2* *'t_k2'* | |
346 <xF2> alternate F2 *<xF2>* | |
347 t_k3 <F3> function key 3 *<F3>* *t_k3* *'t_k3'* | |
348 <xF3> alternate F3 *<xF3>* | |
349 t_k4 <F4> function key 4 *<F4>* *t_k4* *'t_k4'* | |
350 <xF4> alternate F4 *<xF4>* | |
351 t_k5 <F5> function key 5 *<F5>* *t_k5* *'t_k5'* | |
352 t_k6 <F6> function key 6 *<F6>* *t_k6* *'t_k6'* | |
353 t_k7 <F7> function key 7 *<F7>* *t_k7* *'t_k7'* | |
354 t_k8 <F8> function key 8 *<F8>* *t_k8* *'t_k8'* | |
355 t_k9 <F9> function key 9 *<F9>* *t_k9* *'t_k9'* | |
356 t_k; <F10> function key 10 *<F10>* *t_k;* *'t_k;'* | |
4437 | 357 t_F1 <F11> function key 11 *<F11>* *t_F1* *'t_F1'* |
7 | 358 t_F2 <F12> function key 12 *<F12>* *t_F2* *'t_F2'* |
359 t_F3 <F13> function key 13 *<F13>* *t_F3* *'t_F3'* | |
360 t_F4 <F14> function key 14 *<F14>* *t_F4* *'t_F4'* | |
361 t_F5 <F15> function key 15 *<F15>* *t_F5* *'t_F5'* | |
362 t_F6 <F16> function key 16 *<F16>* *t_F6* *'t_F6'* | |
363 t_F7 <F17> function key 17 *<F17>* *t_F7* *'t_F7'* | |
364 t_F8 <F18> function key 18 *<F18>* *t_F8* *'t_F8'* | |
365 t_F9 <F19> function key 19 *<F19>* *t_F9* *'t_F9'* | |
366 <S-F1> shifted function key 1 | |
367 <S-xF1> alternate <S-F1> *<S-xF1>* | |
368 <S-F2> shifted function key 2 *<S-F2>* | |
369 <S-xF2> alternate <S-F2> *<S-xF2>* | |
370 <S-F3> shifted function key 3 *<S-F3>* | |
371 <S-xF3> alternate <S-F3> *<S-xF3>* | |
372 <S-F4> shifted function key 4 *<S-F4>* | |
373 <S-xF4> alternate <S-F4> *<S-xF4>* | |
374 <S-F5> shifted function key 5 *<S-F5>* | |
375 <S-F6> shifted function key 6 *<S-F6>* | |
376 <S-F7> shifted function key 7 *<S-F7>* | |
377 <S-F8> shifted function key 8 *<S-F8>* | |
378 <S-F9> shifted function key 9 *<S-F9>* | |
379 <S-F10> shifted function key 10 *<S-F10>* | |
380 <S-F11> shifted function key 11 *<S-F11>* | |
381 <S-F12> shifted function key 12 *<S-F12>* | |
382 t_%1 <Help> help key *t_%1* *'t_%1'* | |
383 t_&8 <Undo> undo key *t_&8* *'t_&8'* | |
384 t_kI <Insert> insert key *t_kI* *'t_kI'* | |
385 t_kD <Del> delete key *t_kD* *'t_kD'* | |
386 t_kb <BS> backspace key *t_kb* *'t_kb'* | |
4437 | 387 t_kB <S-Tab> back-tab (shift-tab) *<S-Tab>* *t_kB* *'t_kB'* |
7 | 388 t_kh <Home> home key *t_kh* *'t_kh'* |
4437 | 389 t_#2 <S-Home> shifted home key *<S-Home>* *t_#2* *'t_#2'* |
7 | 390 <xHome> alternate home key *<xHome>* |
391 t_@7 <End> end key *t_@7* *'t_@7'* | |
392 t_*7 <S-End> shifted end key *<S-End>* *t_star7* *'t_star7'* | |
393 <xEnd> alternate end key *<xEnd>* | |
394 t_kP <PageUp> page-up key *t_kP* *'t_kP'* | |
395 t_kN <PageDown> page-down key *t_kN* *'t_kN'* | |
396 t_K1 <kHome> keypad home key *t_K1* *'t_K1'* | |
397 t_K4 <kEnd> keypad end key *t_K4* *'t_K4'* | |
398 t_K3 <kPageUp> keypad page-up key *t_K3* *'t_K3'* | |
399 t_K5 <kPageDown> keypad page-down key *t_K5* *'t_K5'* | |
400 t_K6 <kPlus> keypad plus key *<kPlus>* *t_K6* *'t_K6'* | |
401 t_K7 <kMinus> keypad minus key *<kMinus>* *t_K7* *'t_K7'* | |
4437 | 402 t_K8 <kDivide> keypad divide *<kDivide>* *t_K8* *'t_K8'* |
403 t_K9 <kMultiply> keypad multiply *<kMultiply>* *t_K9* *'t_K9'* | |
7 | 404 t_KA <kEnter> keypad enter key *<kEnter>* *t_KA* *'t_KA'* |
405 t_KB <kPoint> keypad decimal point *<kPoint>* *t_KB* *'t_KB'* | |
406 t_KC <k0> keypad 0 *<k0>* *t_KC* *'t_KC'* | |
407 t_KD <k1> keypad 1 *<k1>* *t_KD* *'t_KD'* | |
408 t_KE <k2> keypad 2 *<k2>* *t_KE* *'t_KE'* | |
409 t_KF <k3> keypad 3 *<k3>* *t_KF* *'t_KF'* | |
410 t_KG <k4> keypad 4 *<k4>* *t_KG* *'t_KG'* | |
411 t_KH <k5> keypad 5 *<k5>* *t_KH* *'t_KH'* | |
412 t_KI <k6> keypad 6 *<k6>* *t_KI* *'t_KI'* | |
413 t_KJ <k7> keypad 7 *<k7>* *t_KJ* *'t_KJ'* | |
414 t_KK <k8> keypad 8 *<k8>* *t_KK* *'t_KK'* | |
415 t_KL <k9> keypad 9 *<k9>* *t_KL* *'t_KL'* | |
416 <Mouse> leader of mouse code *<Mouse>* | |
10640
27be410d6d29
patch 8.0.0210: no support for bracketed paste
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
417 t_PS start of brackted paste |xterm-bracketed-paste| *t_PS* 't_PS' |
27be410d6d29
patch 8.0.0210: no support for bracketed paste
Christian Brabandt <cb@256bit.org>
parents:
10198
diff
changeset
|
418 t_PE end of bracketed paste |xterm-bracketed-paste| *t_PE* 't_PE' |
7 | 419 |
420 Note about t_so and t_mr: When the termcap entry "so" is not present the | |
421 entry for "mr" is used. And vice versa. The same is done for "se" and "me". | |
422 If your terminal supports both inversion and standout mode, you can see two | |
423 different modes. If your terminal supports only one of the modes, both will | |
424 look the same. | |
425 | |
33 | 426 *keypad-comma* |
7 | 427 The keypad keys, when they are not mapped, behave like the equivalent normal |
33 | 428 key. There is one exception: if you have a comma on the keypad instead of a |
429 decimal point, Vim will use a dot anyway. Use these mappings to fix that: > | |
430 :noremap <kPoint> , | |
431 :noremap! <kPoint> , | |
432 < *xterm-codes* | |
7 | 433 There is a special trick to obtain the key codes which currently only works |
434 for xterm. When |t_RV| is defined and a response is received which indicates | |
435 an xterm with patchlevel 141 or higher, Vim uses special escape sequences to | |
436 request the key codes directly from the xterm. The responses are used to | |
437 adjust the various t_ codes. This avoids the problem that the xterm can | |
438 produce different codes, depending on the mode it is in (8-bit, VT102, | |
439 VT220, etc.). The result is that codes like <xF1> are no longer needed. | |
440 Note: This is only done on startup. If the xterm options are changed after | |
6530 | 441 Vim has started, the escape sequences may not be recognized anymore. |
7 | 442 |
8969
c83e2c1e7f2b
commit https://github.com/vim/vim/commit/8a633e3427b47286869aa4b96f2bfc1fe65b25cd
Christian Brabandt <cb@256bit.org>
parents:
8951
diff
changeset
|
443 *xterm-true-color* |
c83e2c1e7f2b
commit https://github.com/vim/vim/commit/8a633e3427b47286869aa4b96f2bfc1fe65b25cd
Christian Brabandt <cb@256bit.org>
parents:
8951
diff
changeset
|
444 Vim supports using true colors in the terminal (taken from |highlight-guifg| |
9027
773d627cac0b
commit https://github.com/vim/vim/commit/61be73bb0f965a895bfb064ea3e55476ac175162
Christian Brabandt <cb@256bit.org>
parents:
8969
diff
changeset
|
445 and |highlight-guibg|), given that the terminal supports this. To make this |
773d627cac0b
commit https://github.com/vim/vim/commit/61be73bb0f965a895bfb064ea3e55476ac175162
Christian Brabandt <cb@256bit.org>
parents:
8969
diff
changeset
|
446 work the 'termguicolors' option needs to be set. |
10140
b11ceef7116e
commit https://github.com/vim/vim/commit/64d8e25bf6efe5f18b032563521c3ce278c316ab
Christian Brabandt <cb@256bit.org>
parents:
9027
diff
changeset
|
447 See https://gist.github.com/XVilka/8346728 for a list of terminals that |
b11ceef7116e
commit https://github.com/vim/vim/commit/64d8e25bf6efe5f18b032563521c3ce278c316ab
Christian Brabandt <cb@256bit.org>
parents:
9027
diff
changeset
|
448 support true colors. |
8969
c83e2c1e7f2b
commit https://github.com/vim/vim/commit/8a633e3427b47286869aa4b96f2bfc1fe65b25cd
Christian Brabandt <cb@256bit.org>
parents:
8951
diff
changeset
|
449 |
9027
773d627cac0b
commit https://github.com/vim/vim/commit/61be73bb0f965a895bfb064ea3e55476ac175162
Christian Brabandt <cb@256bit.org>
parents:
8969
diff
changeset
|
450 Sometimes setting 'termguicolors' is not enough and one has to set the |t_8f| |
773d627cac0b
commit https://github.com/vim/vim/commit/61be73bb0f965a895bfb064ea3e55476ac175162
Christian Brabandt <cb@256bit.org>
parents:
8969
diff
changeset
|
451 and |t_8b| options explicitly. Default values of these options are |
773d627cac0b
commit https://github.com/vim/vim/commit/61be73bb0f965a895bfb064ea3e55476ac175162
Christian Brabandt <cb@256bit.org>
parents:
8969
diff
changeset
|
452 "^[[38;2;%lu;%lu;%lum" and "^[[48;2;%lu;%lu;%lum" respectively, but it is only |
773d627cac0b
commit https://github.com/vim/vim/commit/61be73bb0f965a895bfb064ea3e55476ac175162
Christian Brabandt <cb@256bit.org>
parents:
8969
diff
changeset
|
453 set when `$TERM` is `xterm`. Some terminals accept the same sequences, but |
773d627cac0b
commit https://github.com/vim/vim/commit/61be73bb0f965a895bfb064ea3e55476ac175162
Christian Brabandt <cb@256bit.org>
parents:
8969
diff
changeset
|
454 with all semicolons replaced by colons (this is actually more compatible, but |
773d627cac0b
commit https://github.com/vim/vim/commit/61be73bb0f965a895bfb064ea3e55476ac175162
Christian Brabandt <cb@256bit.org>
parents:
8969
diff
changeset
|
455 less widely supported): > |
10140
b11ceef7116e
commit https://github.com/vim/vim/commit/64d8e25bf6efe5f18b032563521c3ce278c316ab
Christian Brabandt <cb@256bit.org>
parents:
9027
diff
changeset
|
456 let &t_8f = "\<Esc>[38:2:%lu:%lu:%lum" |
b11ceef7116e
commit https://github.com/vim/vim/commit/64d8e25bf6efe5f18b032563521c3ce278c316ab
Christian Brabandt <cb@256bit.org>
parents:
9027
diff
changeset
|
457 let &t_8b = "\<Esc>[48:2:%lu:%lu:%lum" |
9027
773d627cac0b
commit https://github.com/vim/vim/commit/61be73bb0f965a895bfb064ea3e55476ac175162
Christian Brabandt <cb@256bit.org>
parents:
8969
diff
changeset
|
458 |
773d627cac0b
commit https://github.com/vim/vim/commit/61be73bb0f965a895bfb064ea3e55476ac175162
Christian Brabandt <cb@256bit.org>
parents:
8969
diff
changeset
|
459 These options contain printf strings, with |printf()| (actually, its C |
773d627cac0b
commit https://github.com/vim/vim/commit/61be73bb0f965a895bfb064ea3e55476ac175162
Christian Brabandt <cb@256bit.org>
parents:
8969
diff
changeset
|
460 equivalent hence `l` modifier) invoked with the t_ option value and three |
773d627cac0b
commit https://github.com/vim/vim/commit/61be73bb0f965a895bfb064ea3e55476ac175162
Christian Brabandt <cb@256bit.org>
parents:
8969
diff
changeset
|
461 unsigned long integers that may have any value between 0 and 255 (inclusive) |
773d627cac0b
commit https://github.com/vim/vim/commit/61be73bb0f965a895bfb064ea3e55476ac175162
Christian Brabandt <cb@256bit.org>
parents:
8969
diff
changeset
|
462 representing red, green and blue colors respectively. |
8969
c83e2c1e7f2b
commit https://github.com/vim/vim/commit/8a633e3427b47286869aa4b96f2bfc1fe65b25cd
Christian Brabandt <cb@256bit.org>
parents:
8951
diff
changeset
|
463 |
2033
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
464 *xterm-resize* |
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
465 Window resizing with xterm only works if the allowWindowOps resource is |
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
466 enabled. On some systems and versions of xterm it's disabled by default |
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
467 because someone thought it would be a security issue. It's not clear if this |
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
468 is actually the case. |
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
469 |
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
470 To overrule the default, put this line in your ~/.Xdefaults or |
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
471 ~/.Xresources: |
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
472 > |
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
473 XTerm*allowWindowOps: true |
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
474 |
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
475 And run "xrdb -merge .Xresources" to make it effective. You can check the |
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
476 value with the context menu (right mouse button while CTRL key is pressed), |
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
477 there should be a tick at allow-window-ops. |
de5a43c5eedc
Update documentation files.
Bram Moolenaar <bram@zimbu.org>
parents:
1702
diff
changeset
|
478 |
7 | 479 *termcap-colors* |
480 Note about colors: The 't_Co' option tells Vim the number of colors available. | |
481 When it is non-zero, the 't_AB' and 't_AF' options are used to set the color. | |
482 If one of these is not available, 't_Sb' and 't_Sf' are used. 't_me' is used | |
483 to reset to the default colors. | |
484 | |
36 | 485 *termcap-cursor-shape* *termcap-cursor-color* |
6727 | 486 When Vim enters Insert mode the 't_SI' escape sequence is sent. When Vim |
487 enters Replace mode the 't_SR' escape sequence is sent if it is set, otherwise | |
488 't_SI' is sent. When leaving Insert mode or Replace mode 't_EI' is used. This | |
489 can be used to change the shape or color of the cursor in Insert or Replace | |
490 mode. These are not standard termcap/terminfo entries, you need to set them | |
491 yourself. | |
36 | 492 Example for an xterm, this changes the color of the cursor: > |
493 if &term =~ "xterm" | |
494 let &t_SI = "\<Esc>]12;purple\x7" | |
6727 | 495 let &t_SR = "\<Esc>]12;red\x7" |
36 | 496 let &t_EI = "\<Esc>]12;blue\x7" |
497 endif | |
498 NOTE: When Vim exits the shape for Normal mode will remain. The shape from | |
499 before Vim started will not be restored. | |
2570
71b56b4e7785
Make the references to features in the help more consistent. (Sylvain Hitier)
Bram Moolenaar <bram@vim.org>
parents:
2561
diff
changeset
|
500 {not available when compiled without the |+cursorshape| feature} |
36 | 501 |
7 | 502 *termcap-title* |
503 The 't_ts' and 't_fs' options are used to set the window title if the terminal | |
504 allows title setting via sending strings. They are sent before and after the | |
505 title string, respectively. Similar 't_IS' and 't_IE' are used to set the | |
506 icon text. These are Vim-internal extensions of the Unix termcap, so they | |
507 cannot be obtained from an external termcap. However, the builtin termcap | |
508 contains suitable entries for xterm and iris-ansi, so you don't need to set | |
509 them here. | |
510 *hpterm* | |
511 If inversion or other highlighting does not work correctly, try setting the | |
512 't_xs' option to a non-empty string. This makes the 't_ce' code be used to | |
513 remove highlighting from a line. This is required for "hpterm". Setting the | |
514 'weirdinvert' option has the same effect as making 't_xs' non-empty, and vice | |
515 versa. | |
516 | |
517 *scroll-region* | |
518 Some termcaps do not include an entry for 'cs' (scroll region), although the | |
519 terminal does support it. For example: xterm on a Sun. You can use the | |
520 builtin_xterm or define t_cs yourself. For example: > | |
521 :set t_cs=^V^[[%i%d;%dr | |
522 Where ^V is CTRL-V and ^[ is <Esc>. | |
523 | |
524 The vertical scroll region t_CV is not a standard termcap code. Vim uses it | |
525 internally in the GUI. But it can also be defined for a terminal, if you can | |
526 find one that supports it. The two arguments are the left and right column of | |
527 the region which to restrict the scrolling to. Just like t_cs defines the top | |
528 and bottom lines. Defining t_CV will make scrolling in vertically split | |
529 windows a lot faster. Don't set t_CV when t_da or t_db is set (text isn't | |
530 cleared when scrolling). | |
531 | |
532 Unfortunately it is not possible to deduce from the termcap how cursor | |
533 positioning should be done when using a scrolling region: Relative to the | |
534 beginning of the screen or relative to the beginning of the scrolling region. | |
535 Most terminals use the first method. A known exception is the MS-DOS console | |
536 (pcterm). The 't_CS' option should be set to any string when cursor | |
537 positioning is relative to the start of the scrolling region. It should be | |
538 set to an empty string otherwise. It defaults to "yes" when 'term' is | |
539 "pcterm". | |
540 | |
541 Note for xterm users: The shifted cursor keys normally don't work. You can | |
542 make them work with the xmodmap command and some mappings in Vim. | |
543 | |
544 Give these commands in the xterm: | |
545 xmodmap -e "keysym Up = Up F13" | |
546 xmodmap -e "keysym Down = Down F16" | |
547 xmodmap -e "keysym Left = Left F18" | |
548 xmodmap -e "keysym Right = Right F19" | |
549 | |
550 And use these mappings in Vim: | |
551 :map <t_F3> <S-Up> | |
552 :map! <t_F3> <S-Up> | |
553 :map <t_F6> <S-Down> | |
554 :map! <t_F6> <S-Down> | |
555 :map <t_F8> <S-Left> | |
556 :map! <t_F8> <S-Left> | |
557 :map <t_F9> <S-Right> | |
558 :map! <t_F9> <S-Right> | |
559 | |
560 Instead of, say, <S-Up> you can use any other command that you want to use the | |
561 shift-cursor-up key for. (Note: To help people that have a Sun keyboard with | |
562 left side keys F14 is not used because it is confused with the undo key; F15 | |
563 is not used, because it does a window-to-front; F17 is not used, because it | |
564 closes the window. On other systems you can probably use them.) | |
565 | |
566 ============================================================================== | |
567 3. Window size *window-size* | |
568 | |
569 [This is about the size of the whole window Vim is using, not a window that is | |
570 created with the ":split" command.] | |
571 | |
572 If you are running Vim on an Amiga and the terminal name is "amiga" or | |
573 "builtin_amiga", the amiga-specific window resizing will be enabled. On Unix | |
574 systems three methods are tried to get the window size: | |
575 | |
576 - an ioctl call (TIOCGSIZE or TIOCGWINSZ, depends on your system) | |
577 - the environment variables "LINES" and "COLUMNS" | |
578 - from the termcap entries "li" and "co" | |
579 | |
580 If everything fails a default size of 24 lines and 80 columns is assumed. If | |
581 a window-resize signal is received the size will be set again. If the window | |
582 size is wrong you can use the 'lines' and 'columns' options to set the | |
583 correct values. | |
584 | |
585 One command can be used to set the screen size: | |
586 | |
8951
0bdeaf7092bc
commit https://github.com/vim/vim/commit/aa3b15dbebf333282503d6031e2f9ba6ee4398ed
Christian Brabandt <cb@256bit.org>
parents:
7272
diff
changeset
|
587 *:mod* *:mode* *E359* |
7 | 588 :mod[e] [mode] |
589 | |
590 Without argument this only detects the screen size and redraws the screen. | |
591 With MS-DOS it is possible to switch screen mode. [mode] can be one of these | |
592 values: | |
593 "bw40" 40 columns black&white | |
594 "c40" 40 columns color | |
595 "bw80" 80 columns black&white | |
596 "c80" 80 columns color (most people use this) | |
597 "mono" 80 columns monochrome | |
598 "c4350" 43 or 50 lines EGA/VGA mode | |
599 number mode number to use, depends on your video card | |
600 | |
601 ============================================================================== | |
602 4. Slow and fast terminals *slow-fast-terminal* | |
603 *slow-terminal* | |
604 | |
605 If you have a fast terminal you may like to set the 'ruler' option. The | |
606 cursor position is shown in the status line. If you are using horizontal | |
607 scrolling ('wrap' option off) consider setting 'sidescroll' to a small | |
608 number. | |
609 | |
610 If you have a slow terminal you may want to reset the 'showcmd' option. | |
611 The command characters will not be shown in the status line. If the terminal | |
612 scrolls very slowly, set the 'scrolljump' to 5 or so. If the cursor is moved | |
613 off the screen (e.g., with "j") Vim will scroll 5 lines at a time. Another | |
614 possibility is to reduce the number of lines that Vim uses with the command | |
615 "z{height}<CR>". | |
616 | |
617 If the characters from the terminal are arriving with more than 1 second | |
618 between them you might want to set the 'timeout' and/or 'ttimeout' option. | |
619 See the "Options" chapter |options|. | |
620 | |
621 If your terminal does not support a scrolling region, but it does support | |
622 insert/delete line commands, scrolling with multiple windows may make the | |
623 lines jump up and down. If you don't want this set the 'ttyfast' option. | |
624 This will redraw the window instead of scroll it. | |
625 | |
626 If your terminal scrolls very slowly, but redrawing is not slow, set the | |
627 'ttyscroll' option to a small number, e.g., 3. This will make Vim redraw the | |
628 screen instead of scrolling, when there are more than 3 lines to be scrolled. | |
629 | |
630 If you are using a color terminal that is slow, use this command: > | |
631 hi NonText cterm=NONE ctermfg=NONE | |
632 This avoids that spaces are sent when they have different attributes. On most | |
633 terminals you can't see this anyway. | |
634 | |
635 If you are using Vim over a slow serial line, you might want to try running | |
636 Vim inside the "screen" program. Screen will optimize the terminal I/O quite | |
637 a bit. | |
638 | |
639 If you are testing termcap options, but you cannot see what is happening, | |
640 you might want to set the 'writedelay' option. When non-zero, one character | |
641 is sent to the terminal at a time (does not work for MS-DOS). This makes the | |
642 screen updating a lot slower, making it possible to see what is happening. | |
643 | |
644 ============================================================================== | |
645 5. Using the mouse *mouse-using* | |
646 | |
647 This section is about using the mouse on a terminal or a terminal window. How | |
648 to use the mouse in a GUI window is explained in |gui-mouse|. For scrolling | |
649 with a mouse wheel see |scroll-mouse-wheel|. | |
650 | |
2207
b17bbfa96fa0
Add the settabvar() and gettabvar() functions.
Bram Moolenaar <bram@vim.org>
parents:
2154
diff
changeset
|
651 Don't forget to enable the mouse with this command: > |
7 | 652 :set mouse=a |
653 Otherwise Vim won't recognize the mouse in all modes (See 'mouse'). | |
654 | |
1621 | 655 Currently the mouse is supported for Unix in an xterm window, in a *BSD |
656 console with |sysmouse|, in a Linux console (with GPM |gpm-mouse|), for | |
657 MS-DOS and in a Windows console. | |
7 | 658 Mouse clicks can be used to position the cursor, select an area and paste. |
659 | |
660 These characters in the 'mouse' option tell in which situations the mouse will | |
661 be used by Vim: | |
662 n Normal mode | |
663 v Visual mode | |
664 i Insert mode | |
665 c Command-line mode | |
666 h all previous modes when in a help file | |
667 a all previous modes | |
668 r for |hit-enter| prompt | |
669 | |
670 The default for 'mouse' is empty, the mouse is not used. Normally you would | |
671 do: > | |
672 :set mouse=a | |
673 to start using the mouse (this is equivalent to setting 'mouse' to "nvich"). | |
674 If you only want to use the mouse in a few modes or also want to use it for | |
675 the two questions you will have to concatenate the letters for those modes. | |
676 For example: > | |
677 :set mouse=nv | |
678 Will make the mouse work in Normal mode and Visual mode. > | |
679 :set mouse=h | |
680 Will make the mouse work in help files only (so you can use "g<LeftMouse>" to | |
681 jump to tags). | |
682 | |
683 Whether the selection that is started with the mouse is in Visual mode or | |
684 Select mode depends on whether "mouse" is included in the 'selectmode' | |
685 option. | |
686 | |
687 In an xterm, with the currently active mode included in the 'mouse' option, | |
688 normal mouse clicks are used by Vim, mouse clicks with the shift or ctrl key | |
689 pressed go to the xterm. With the currently active mode not included in | |
690 'mouse' all mouse clicks go to the xterm. | |
691 | |
692 *xterm-clipboard* | |
693 In the Athena and Motif GUI versions, when running in a terminal and there is | |
694 access to the X-server (DISPLAY is set), the copy and paste will behave like | |
695 in the GUI. If not, the middle mouse button will insert the unnamed register. | |
696 In that case, here is how you copy and paste a piece of text: | |
697 | |
698 Copy/paste with the mouse and Visual mode ('mouse' option must be set, see | |
699 above): | |
700 1. Press left mouse button on first letter of text, move mouse pointer to last | |
701 letter of the text and release the button. This will start Visual mode and | |
702 highlight the selected area. | |
703 2. Press "y" to yank the Visual text in the unnamed register. | |
704 3. Click the left mouse button at the insert position. | |
705 4. Click the middle mouse button. | |
706 | |
707 Shortcut: If the insert position is on the screen at the same time as the | |
708 Visual text, you can do 2, 3 and 4 all in one: Click the middle mouse button | |
709 at the insert position. | |
710 | |
711 Note: When the |-X| command line argument is used, Vim will not connect to the | |
712 X server and copy/paste to the X clipboard (selection) will not work. Use the | |
713 shift key with the mouse buttons to let the xterm do the selection. | |
714 | |
715 *xterm-command-server* | |
716 When the X-server clipboard is available, the command server described in | |
717 |x11-clientserver| can be enabled with the --servername command line argument. | |
718 | |
719 *xterm-copy-paste* | |
720 NOTE: In some (older) xterms, it's not possible to move the cursor past column | |
5908 | 721 95 or 223. This is an xterm problem, not Vim's. Get a newer xterm |
722 |color-xterm|. Also see |'ttymouse'|. | |
7 | 723 |
724 Copy/paste in xterm with (current mode NOT included in 'mouse'): | |
725 1. Press left mouse button on first letter of text, move mouse pointer to last | |
726 letter of the text and release the button. | |
727 2. Use normal Vim commands to put the cursor at the insert position. | |
728 3. Press "a" to start Insert mode. | |
729 4. Click the middle mouse button. | |
730 5. Press ESC to end Insert mode. | |
731 (The same can be done with anything in 'mouse' if you keep the shift key | |
732 pressed while using the mouse.) | |
733 | |
734 Note: if you lose the 8th bit when pasting (special characters are translated | |
735 into other characters), you may have to do "stty cs8 -istrip -parenb" in your | |
736 shell before starting Vim. | |
737 | |
738 Thus in an xterm the shift and ctrl keys cannot be used with the mouse. Mouse | |
739 commands requiring the CTRL modifier can be simulated by typing the "g" key | |
740 before using the mouse: | |
741 "g<LeftMouse>" is "<C-LeftMouse> (jump to tag under mouse click) | |
742 "g<RightMouse>" is "<C-RightMouse> ("CTRL-T") | |
743 | |
744 *mouse-mode-table* *mouse-overview* | |
745 A short overview of what the mouse buttons do, when 'mousemodel' is "extend": | |
746 | |
747 Normal Mode: | |
748 event position selection change action ~ | |
749 cursor window ~ | |
750 <LeftMouse> yes end yes | |
751 <C-LeftMouse> yes end yes "CTRL-]" (2) | |
752 <S-LeftMouse> yes no change yes "*" (2) *<S-LeftMouse>* | |
753 <LeftDrag> yes start or extend (1) no *<LeftDrag>* | |
754 <LeftRelease> yes start or extend (1) no | |
755 <MiddleMouse> yes if not active no put | |
756 <MiddleMouse> yes if active no yank and put | |
757 <RightMouse> yes start or extend yes | |
600 | 758 <A-RightMouse> yes start or extend blockw. yes *<A-RightMouse>* |
7 | 759 <S-RightMouse> yes no change yes "#" (2) *<S-RightMouse>* |
760 <C-RightMouse> no no change no "CTRL-T" | |
761 <RightDrag> yes extend no *<RightDrag>* | |
762 <RightRelease> yes extend no *<RightRelease>* | |
763 | |
764 Insert or Replace Mode: | |
765 event position selection change action ~ | |
766 cursor window ~ | |
767 <LeftMouse> yes (cannot be active) yes | |
768 <C-LeftMouse> yes (cannot be active) yes "CTRL-O^]" (2) | |
769 <S-LeftMouse> yes (cannot be active) yes "CTRL-O*" (2) | |
770 <LeftDrag> yes start or extend (1) no like CTRL-O (1) | |
771 <LeftRelease> yes start or extend (1) no like CTRL-O (1) | |
772 <MiddleMouse> no (cannot be active) no put register | |
773 <RightMouse> yes start or extend yes like CTRL-O | |
600 | 774 <A-RightMouse> yes start or extend blockw. yes |
7 | 775 <S-RightMouse> yes (cannot be active) yes "CTRL-O#" (2) |
776 <C-RightMouse> no (cannot be active) no "CTRL-O CTRL-T" | |
777 | |
778 In a help window: | |
779 event position selection change action ~ | |
780 cursor window ~ | |
781 <2-LeftMouse> yes (cannot be active) no "^]" (jump to help tag) | |
782 | |
783 When 'mousemodel' is "popup", these are different: | |
784 | |
785 Normal Mode: | |
786 event position selection change action ~ | |
787 cursor window ~ | |
788 <S-LeftMouse> yes start or extend (1) no | |
600 | 789 <A-LeftMouse> yes start or extend blockw. no *<A-LeftMouse>* |
7 | 790 <RightMouse> no popup menu no |
791 | |
792 Insert or Replace Mode: | |
793 event position selection change action ~ | |
794 cursor window ~ | |
795 <S-LeftMouse> yes start or extend (1) no like CTRL-O (1) | |
600 | 796 <A-LeftMouse> yes start or extend blockw. no |
7 | 797 <RightMouse> no popup menu no |
798 | |
799 (1) only if mouse pointer moved since press | |
800 (2) only if click is in same buffer | |
801 | |
802 Clicking the left mouse button causes the cursor to be positioned. If the | |
803 click is in another window that window is made the active window. When | |
804 editing the command-line the cursor can only be positioned on the | |
805 command-line. When in Insert mode Vim remains in Insert mode. If 'scrolloff' | |
806 is set, and the cursor is positioned within 'scrolloff' lines from the window | |
807 border, the text is scrolled. | |
808 | |
809 A selection can be started by pressing the left mouse button on the first | |
810 character, moving the mouse to the last character, then releasing the mouse | |
811 button. You will not always see the selection until you release the button, | |
812 only in some versions (GUI, MS-DOS, WIN32) will the dragging be shown | |
813 immediately. Note that you can make the text scroll by moving the mouse at | |
814 least one character in the first/last line in the window when 'scrolloff' is | |
815 non-zero. | |
816 | |
817 In Normal, Visual and Select mode clicking the right mouse button causes the | |
818 Visual area to be extended. When 'mousemodel' is "popup", the left button has | |
819 to be used while keeping the shift key pressed. When clicking in a window | |
820 which is editing another buffer, the Visual or Select mode is stopped. | |
821 | |
600 | 822 In Normal, Visual and Select mode clicking the right mouse button with the alt |
1121 | 823 key pressed causes the Visual area to become blockwise. When 'mousemodel' is |
600 | 824 "popup" the left button has to be used with the alt key. Note that this won't |
853 | 825 work on systems where the window manager consumes the mouse events when the |
826 alt key is pressed (it may move the window). | |
600 | 827 |
7 | 828 *double-click* |
829 Double, triple and quadruple clicks are supported when the GUI is active, | |
830 for MS-DOS and Win32, and for an xterm (if the gettimeofday() function is | |
831 available). For selecting text, extra clicks extend the selection: | |
832 click select ~ | |
833 double word or % match *<2-LeftMouse>* | |
834 triple line *<3-LeftMouse>* | |
835 quadruple rectangular block *<4-LeftMouse>* | |
836 Exception: In a Help window a double click jumps to help for the word that is | |
837 clicked on. | |
838 A double click on a word selects that word. 'iskeyword' is used to specify | |
839 which characters are included in a word. A double click on a character | |
840 that has a match selects until that match (like using "v%"). If the match is | |
841 an #if/#else/#endif block, the selection becomes linewise. | |
842 For MS-DOS and xterm the time for double clicking can be set with the | |
843 'mousetime' option. For the other systems this time is defined outside of | |
844 Vim. | |
845 An example, for using a double click to jump to the tag under the cursor: > | |
846 :map <2-LeftMouse> :exe "tag ". expand("<cword>")<CR> | |
847 | |
848 Dragging the mouse with a double click (button-down, button-up, button-down | |
849 and then drag) will result in whole words to be selected. This continues | |
850 until the button is released, at which point the selection is per character | |
851 again. | |
852 | |
853 *gpm-mouse* | |
854 The GPM mouse is only supported when the |+mouse_gpm| feature was enabled at | |
855 compile time. The GPM mouse driver (Linux console) does not support quadruple | |
856 clicks. | |
857 | |
858 In Insert mode, when a selection is started, Vim goes into Normal mode | |
859 temporarily. When Visual or Select mode ends, it returns to Insert mode. | |
860 This is like using CTRL-O in Insert mode. Select mode is used when the | |
861 'selectmode' option contains "mouse". | |
1621 | 862 *sysmouse* |
863 The sysmouse is only supported when the |+mouse_sysmouse| feature was enabled | |
864 at compile time. The sysmouse driver (*BSD console) does not support keyboard | |
865 modifiers. | |
7 | 866 |
867 *drag-status-line* | |
868 When working with several windows, the size of the windows can be changed by | |
869 dragging the status line with the mouse. Point the mouse at a status line, | |
870 press the left button, move the mouse to the new position of the status line, | |
871 release the button. Just clicking the mouse in a status line makes that window | |
872 the current window, without moving the cursor. If by selecting a window it | |
873 will change position or size, the dragging of the status line will look | |
874 confusing, but it will work (just try it). | |
875 | |
876 *<MiddleRelease>* *<MiddleDrag>* | |
877 Mouse clicks can be mapped. The codes for mouse clicks are: | |
878 code mouse button normal action ~ | |
879 <LeftMouse> left pressed set cursor position | |
880 <LeftDrag> left moved while pressed extend selection | |
881 <LeftRelease> left released set selection end | |
882 <MiddleMouse> middle pressed paste text at cursor position | |
883 <MiddleDrag> middle moved while pressed - | |
884 <MiddleRelease> middle released - | |
885 <RightMouse> right pressed extend selection | |
886 <RightDrag> right moved while pressed extend selection | |
887 <RightRelease> right released set selection end | |
888 <X1Mouse> X1 button pressed - *X1Mouse* | |
889 <X1Drag> X1 moved while pressed - *X1Drag* | |
890 <X1Release> X1 button release - *X1Release* | |
891 <X2Mouse> X2 button pressed - *X2Mouse* | |
892 <X2Drag> X2 moved while pressed - *X2Drag* | |
893 <X2Release> X2 button release - *X2Release* | |
894 | |
895 The X1 and X2 buttons refer to the extra buttons found on some mice. The | |
896 'Microsoft Explorer' mouse has these buttons available to the right thumb. | |
7272
17333ebd2bbd
commit https://github.com/vim/vim/commit/d042dc825c9b97dacd84d4728f88300da4d5b6b9
Christian Brabandt <cb@256bit.org>
parents:
6884
diff
changeset
|
897 Currently X1 and X2 only work on Win32 and X11 environments. |
7 | 898 |
899 Examples: > | |
900 :noremap <MiddleMouse> <LeftMouse><MiddleMouse> | |
901 Paste at the position of the middle mouse button click (otherwise the paste | |
902 would be done at the cursor position). > | |
903 | |
904 :noremap <LeftRelease> <LeftRelease>y | |
905 Immediately yank the selection, when using Visual mode. | |
906 | |
907 Note the use of ":noremap" instead of "map" to avoid a recursive mapping. | |
908 > | |
909 :map <X1Mouse> <C-O> | |
910 :map <X2Mouse> <C-I> | |
911 Map the X1 and X2 buttons to go forwards and backwards in the jump list, see | |
912 |CTRL-O| and |CTRL-I|. | |
913 | |
914 *mouse-swap-buttons* | |
915 To swap the meaning of the left and right mouse buttons: > | |
916 :noremap <LeftMouse> <RightMouse> | |
917 :noremap <LeftDrag> <RightDrag> | |
918 :noremap <LeftRelease> <RightRelease> | |
919 :noremap <RightMouse> <LeftMouse> | |
920 :noremap <RightDrag> <LeftDrag> | |
921 :noremap <RightRelease> <LeftRelease> | |
922 :noremap g<LeftMouse> <C-RightMouse> | |
923 :noremap g<RightMouse> <C-LeftMouse> | |
924 :noremap! <LeftMouse> <RightMouse> | |
925 :noremap! <LeftDrag> <RightDrag> | |
926 :noremap! <LeftRelease> <RightRelease> | |
927 :noremap! <RightMouse> <LeftMouse> | |
928 :noremap! <RightDrag> <LeftDrag> | |
929 :noremap! <RightRelease> <LeftRelease> | |
930 < | |
931 vim:tw=78:ts=8:ft=help:norl: |