comparison runtime/doc/term.txt @ 9027:773d627cac0b v7.4.1799

commit https://github.com/vim/vim/commit/61be73bb0f965a895bfb064ea3e55476ac175162 Author: Bram Moolenaar <Bram@vim.org> Date: Fri Apr 29 22:59:22 2016 +0200 patch 7.4.1799 Problem: 'guicolors' is a confusing option name. Solution: Use 'termguicolors' instead. (Hirohito Higashi)
author Christian Brabandt <cb@256bit.org>
date Fri, 29 Apr 2016 23:00:07 +0200
parents c83e2c1e7f2b
children b11ceef7116e
comparison
equal deleted inserted replaced
9026:eea316a77946 9027:773d627cac0b
1 *term.txt* For Vim version 7.4. Last change: 2016 Apr 21 1 *term.txt* For Vim version 7.4. Last change: 2016 Apr 29
2 2
3 3
4 VIM REFERENCE MANUAL by Bram Moolenaar 4 VIM REFERENCE MANUAL by Bram Moolenaar
5 5
6 6
300 t_RV request terminal version string (for xterm) *t_RV* *'t_RV'* 300 t_RV request terminal version string (for xterm) *t_RV* *'t_RV'*
301 |xterm-8bit| |v:termresponse| |'ttymouse'| |xterm-codes| 301 |xterm-8bit| |v:termresponse| |'ttymouse'| |xterm-codes|
302 t_u7 request cursor position (for xterm) *t_u7* *'t_u7'* 302 t_u7 request cursor position (for xterm) *t_u7* *'t_u7'*
303 see |'ambiwidth'| 303 see |'ambiwidth'|
304 t_RB request terminal background color *t_RB* *'t_RB'* 304 t_RB request terminal background color *t_RB* *'t_RB'*
305 see |'ambiwidth'|
306 t_8f set foreground color (R, G, B) *t_8f* *'t_8f'* 305 t_8f set foreground color (R, G, B) *t_8f* *'t_8f'*
307 |xterm-true-color| 306 |xterm-true-color|
308 t_8b set background color (R, G, B) *t_8b* *'t_8b'* 307 t_8b set background color (R, G, B) *t_8b* *'t_8b'*
309 |xterm-true-color| 308 |xterm-true-color|
310 309
423 Note: This is only done on startup. If the xterm options are changed after 422 Note: This is only done on startup. If the xterm options are changed after
424 Vim has started, the escape sequences may not be recognized anymore. 423 Vim has started, the escape sequences may not be recognized anymore.
425 424
426 *xterm-true-color* 425 *xterm-true-color*
427 Vim supports using true colors in the terminal (taken from |highlight-guifg| 426 Vim supports using true colors in the terminal (taken from |highlight-guifg|
428 and |highlight-guibg|), given that terminal supports this. To make this 427 and |highlight-guibg|), given that the terminal supports this. To make this
429 work, 'guicolors' option needs to be set. 428 work the 'termguicolors' option needs to be set.
430 429
431 Sometimes setting 'guicolors' is not enough and one has to set the |t_8f| and 430 Sometimes setting 'termguicolors' is not enough and one has to set the |t_8f|
432 |t_8b| options explicitly. Default values of these options are 431 and |t_8b| options explicitly. Default values of these options are
433 `^[[38;2;%lu;%lu;%lum` and `^[[48;2;%lu;%lu;%lum` (replace `^[` with real 432 "^[[38;2;%lu;%lu;%lum" and "^[[48;2;%lu;%lu;%lum" respectively, but it is only
434 escape) respectively, but it is only set when `$TERM` is `xterm`. Some 433 set when `$TERM` is `xterm`. Some terminals accept the same sequences, but
435 terminals accept the same sequences, but with all semicolons replaced by 434 with all semicolons replaced by colons (this is actually more compatible, but
436 colons (this is actually more compatible, but less widely supported). These 435 less widely supported): >
437 options contain printf strings, with |printf()| (actually, its C equivalent 436 set t_8f=^[[38:2:%lu:%lu:%lum
438 hence `l` modifier) invoked with the t_ option value and three unsigned long 437 set t_8b=^[[48:2:%lu:%lu:%lum
439 integers that may have any value between 0 and 255 (inclusive) representing 438 (replace `^[` with real escape)
440 red, green and blue colors respectively. 439
440 These options contain printf strings, with |printf()| (actually, its C
441 equivalent hence `l` modifier) invoked with the t_ option value and three
442 unsigned long integers that may have any value between 0 and 255 (inclusive)
443 representing red, green and blue colors respectively.
441 444
442 *xterm-resize* 445 *xterm-resize*
443 Window resizing with xterm only works if the allowWindowOps resource is 446 Window resizing with xterm only works if the allowWindowOps resource is
444 enabled. On some systems and versions of xterm it's disabled by default 447 enabled. On some systems and versions of xterm it's disabled by default
445 because someone thought it would be a security issue. It's not clear if this 448 because someone thought it would be a security issue. It's not clear if this