diff options
| author | Bram Moolenaar <Bram@vim.org> | 2016-04-21 21:10:14 +0200 |
|---|---|---|
| committer | Bram Moolenaar <Bram@vim.org> | 2016-04-21 21:10:14 +0200 |
| commit | 8a633e3427b47286869aa4b96f2bfc1fe65b25cd (patch) | |
| tree | eec90d2e5fdc9a9da532a024ca59993e000813f6 /runtime/doc/term.txt | |
| parent | 6d4431e7b675ba7a0194c0b8eb84b7d92e4e7953 (diff) | |
patch 7.4.1770v7.4.1770
Problem: Cannot use true color in the terminal.
Solution: Add the 'guicolors' option. (Nikolai Pavlov)
Diffstat (limited to 'runtime/doc/term.txt')
| -rw-r--r-- | runtime/doc/term.txt | 22 |
1 files changed, 21 insertions, 1 deletions
diff --git a/runtime/doc/term.txt b/runtime/doc/term.txt index 4359764fdc..0ac5b41b35 100644 --- a/runtime/doc/term.txt +++ b/runtime/doc/term.txt @@ -1,4 +1,4 @@ -*term.txt* For Vim version 7.4. Last change: 2015 Nov 24 +*term.txt* For Vim version 7.4. Last change: 2016 Apr 21 VIM REFERENCE MANUAL by Bram Moolenaar @@ -303,6 +303,10 @@ Added by Vim (there are no standard codes for these): see |'ambiwidth'| t_RB request terminal background color *t_RB* *'t_RB'* see |'ambiwidth'| + t_8f set foreground color (R, G, B) *t_8f* *'t_8f'* + |xterm-true-color| + t_8b set background color (R, G, B) *t_8b* *'t_8b'* + |xterm-true-color| KEY CODES Note: Use the <> form if possible @@ -419,6 +423,22 @@ VT220, etc.). The result is that codes like <xF1> are no longer needed. Note: This is only done on startup. If the xterm options are changed after Vim has started, the escape sequences may not be recognized anymore. + *xterm-true-color* +Vim supports using true colors in the terminal (taken from |highlight-guifg| +and |highlight-guibg|), given that terminal supports this. To make this +work, 'guicolors' option needs to be set. + +Sometimes setting 'guicolors' is not enough and one has to set the |t_8f| and +|t_8b| options explicitly. Default values of these options are +`^[[38;2;%lu;%lu;%lum` and `^[[48;2;%lu;%lu;%lum` (replace `^[` with real +escape) respectively, but it is only set when `$TERM` is `xterm`. Some +terminals accept the same sequences, but with all semicolons replaced by +colons (this is actually more compatible, but less widely supported). These +options contain printf strings, with |printf()| (actually, its C equivalent +hence `l` modifier) invoked with the t_ option value and three unsigned long +integers that may have any value between 0 and 255 (inclusive) representing +red, green and blue colors respectively. + *xterm-resize* Window resizing with xterm only works if the allowWindowOps resource is enabled. On some systems and versions of xterm it's disabled by default |