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 | |
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')
-rw-r--r-- | runtime/doc/options.txt | 14 | ||||
-rw-r--r-- | runtime/doc/term.txt | 22 | ||||
-rw-r--r-- | runtime/doc/various.txt | 1 |
3 files changed, 35 insertions, 2 deletions
diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt index 80d2360937..8310a68bae 100644 --- a/runtime/doc/options.txt +++ b/runtime/doc/options.txt @@ -1,4 +1,4 @@ -*options.txt* For Vim version 7.4. Last change: 2016 Apr 20 +*options.txt* For Vim version 7.4. Last change: 2016 Apr 21 VIM REFERENCE MANUAL by Bram Moolenaar @@ -3477,6 +3477,18 @@ A jump table for the options with a short description can be found at |Q_op|. This option cannot be set from a |modeline| or in the |sandbox|, for security reasons. + *'guicolors'* *'gcol'* +'guicolors' 'gcol' boolean (default off) + global + {not in Vi} + {not available when compiled without the + |+termtruecolor| feature} + When on, uses |highlight-guifg| and |highlight-guibg| attributes in + the terminal (thus using 24-bit color). Requires a ISO-8613-3 + compatible terminal. + If setting this option does not work (produces a colorless UI) + reading |xterm-true-color| might help. + *'guicursor'* *'gcr'* *E545* *E546* *E548* *E549* 'guicursor' 'gcr' string (default "n-v-c:block-Cursor/lCursor, ve:ver35-Cursor, 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 diff --git a/runtime/doc/various.txt b/runtime/doc/various.txt index 8e5100507e..b73949f98b 100644 --- a/runtime/doc/various.txt +++ b/runtime/doc/various.txt @@ -424,6 +424,7 @@ m *+tcl* Tcl interface |tcl| m *+tcl/dyn* Tcl interface |tcl-dynamic| |/dyn| *+terminfo* uses |terminfo| instead of termcap N *+termresponse* support for |t_RV| and |v:termresponse| +m *+termtruecolor* 24-bit color in xterm-compatible terminals support N *+textobjects* |text-objects| selection *+tgetent* non-Unix only: able to use external termcap N *+timers* the |timer_start()| function |