comparison runtime/doc/terminal.txt @ 19797:d73d982499ae v8.2.0455

patch 8.2.0455: cannot set the highlight group for a specific terminal Commit: https://github.com/vim/vim/commit/83d4790a04780328c9c7ad22d18f404a27c11601 Author: Bram Moolenaar <Bram@vim.org> Date: Thu Mar 26 20:34:00 2020 +0100 patch 8.2.0455: cannot set the highlight group for a specific terminal Problem: Cannot set the highlight group for a specific terminal. Solution: Add the "highlight" option to term_start(). (closes https://github.com/vim/vim/issues/5818)
author Bram Moolenaar <Bram@vim.org>
date Thu, 26 Mar 2020 20:45:03 +0100
parents 51bc26d4a393
children 1908e92b02fd
comparison
equal deleted inserted replaced
19796:dd865be96964 19797:d73d982499ae
1 *terminal.txt* For Vim version 8.2. Last change: 2020 Jan 30 1 *terminal.txt* For Vim version 8.2. Last change: 2020 Mar 26
2 2
3 3
4 VIM REFERENCE MANUAL by Bram Moolenaar 4 VIM REFERENCE MANUAL by Bram Moolenaar
5 5
6 6
146 terminal window will start with a white or black background. 146 terminal window will start with a white or black background.
147 147
148 To use a different color the Terminal highlight group can be used, for 148 To use a different color the Terminal highlight group can be used, for
149 example: > 149 example: >
150 hi Terminal ctermbg=lightgrey ctermfg=blue guibg=lightgrey guifg=blue 150 hi Terminal ctermbg=lightgrey ctermfg=blue guibg=lightgrey guifg=blue
151 < 151 The highlight needs to be defined before the terminal is created. Doing it
152 later, or setting 'wincolor', will only have effect when the program running
153 in the terminal displays text or clears the terminal.
154 Instead of Terminal another group can be specified with the "term_highlight"
155 option for `term_start()`.
156
152 *g:terminal_ansi_colors* 157 *g:terminal_ansi_colors*
153 In GUI mode or with 'termguicolors', the 16 ANSI colors used by default in new 158 In GUI mode or with 'termguicolors', the 16 ANSI colors used by default in new
154 terminal windows may be configured using the variable 159 terminal windows may be configured using the variable
155 `g:terminal_ansi_colors`, which should be a list of 16 color names or 160 `g:terminal_ansi_colors`, which should be a list of 16 color names or
156 hexadecimal color codes, similar to those accepted by |highlight-guifg|. When 161 hexadecimal color codes, similar to those accepted by |highlight-guifg|. When
855 "term_opencmd" command to use for opening the window when 860 "term_opencmd" command to use for opening the window when
856 "open" is used for "term_finish"; must 861 "open" is used for "term_finish"; must
857 have "%d" where the buffer number goes, 862 have "%d" where the buffer number goes,
858 e.g. "10split|buffer %d"; when not 863 e.g. "10split|buffer %d"; when not
859 specified "botright sbuf %d" is used 864 specified "botright sbuf %d" is used
865 "term_highlight" highlight group to use instead of
866 "Terminal"
860 "eof_chars" Text to send after all buffer lines were 867 "eof_chars" Text to send after all buffer lines were
861 written to the terminal. When not set 868 written to the terminal. When not set
862 CTRL-D is used on MS-Windows. For Python 869 CTRL-D is used on MS-Windows. For Python
863 use CTRL-Z or "exit()". For a shell use 870 use CTRL-Z or "exit()". For a shell use
864 "exit". A CR is always added. 871 "exit". A CR is always added.