summaryrefslogtreecommitdiff
path: root/runtime/doc/terminal.txt
diff options
context:
space:
mode:
authorBram Moolenaar <Bram@vim.org>2018-04-10 15:59:11 +0200
committerBram Moolenaar <Bram@vim.org>2018-04-10 15:59:11 +0200
commitf59c6e8cee092433d325ba21a107654a8d84f776 (patch)
treec099b90bce7ba9db27eeff0eb0c7368b93a70446 /runtime/doc/terminal.txt
parent07b46af645fa7a2b95afec3f3d87c91942d9cbd0 (diff)
downloadvim-git-f59c6e8cee092433d325ba21a107654a8d84f776.tar.gz
patch 8.0.1685: can't set ANSI colors of a terminal windowv8.0.1685
Problem: Can't set ANSI colors of a terminal window. Solution: Add term_setansicolors(), term_getansicolors() and g:term_ansi_colors. (Andy Massimino, closes #2747)
Diffstat (limited to 'runtime/doc/terminal.txt')
-rw-r--r--runtime/doc/terminal.txt10
1 files changed, 10 insertions, 0 deletions
diff --git a/runtime/doc/terminal.txt b/runtime/doc/terminal.txt
index 2d1af1126..551a3740c 100644
--- a/runtime/doc/terminal.txt
+++ b/runtime/doc/terminal.txt
@@ -136,6 +136,16 @@ terminal window will start with a white or black background.
To use a different color the Terminal highlight group can be used, for
example: >
hi Terminal ctermbg=lightgrey ctermfg=blue guibg=lightgrey guifg=blue
+<
+ *g:terminal_ansi_colors*
+In GUI mode or with |termguicolors|, the 16 ANSI colors used by default in new
+terminal windows may be configured using the variable
+`g:terminal_ansi_colors`, which should be a list of 16 color names or
+hexadecimal color codes, similar to those accepted by |highlight-guifg|. When
+not using GUI colors, the terminal window always uses the 16 ANSI colors of
+the underlying terminal.
+The |term_setansicolors()| function can be used to change the colors, and
+|term_getansicolors()| to get the currently used colors.
Syntax ~