diff options
Diffstat (limited to 'runtime/doc/term.txt')
| -rw-r--r-- | runtime/doc/term.txt | 16 |
1 files changed, 12 insertions, 4 deletions
diff --git a/runtime/doc/term.txt b/runtime/doc/term.txt index b15321e6f2..b6aa37a508 100644 --- a/runtime/doc/term.txt +++ b/runtime/doc/term.txt @@ -24,6 +24,7 @@ the pc terminal, for Unix an ansi terminal. On Unix the terminfo database is used. There is no access to the terminfo settings with |:set|. + *TERM* If you experience terminal difficulties, first ensure that you have set the correct terminal type in your $TERM environment variable so that Nvim is pulling the correct entry from the terminfo database in the first place. @@ -43,6 +44,16 @@ As noted in the commentary in the terminfo source file: incorrect; for starters it does not include tmux's italics and status line capabilities or correctly describe how to set inverse video. +Setting your $TERM environment variable to the correct value also avoids the +problem that SSH does not mirror arbitrary client-end environment variables +such as $COLORTERM, $XTERM_VERSION, $VTE_VERSION, $KONSOLE_PROFILE_NAME, and +$TERM_PROGRAM to the server end, whereas it does send the $TERM environment +variable. + +Note that the Unibilium library (used by Nvim to read terminfo) allows you to +override an out-of-date system terminfo database with one in your +$HOME/.terminfo/ directory, in part or in whole. + *builtin-terms* *builtin_terms* If a |terminfo| database is not available, or no entry for the terminal type is found in that database, Nvim will look up the terminal type in a compiled-in @@ -60,10 +71,7 @@ terminfo record is used as a final fallback. The built-in mini-database is not combined with an external terminfo database, nor can it be used in preference to one. You can thus entirely override any omissions or out-of-date information in the built-in terminfo database by -supplying an external one with entries for the terminal type. Note that the -Unibilium library (used by Nvim to read terminfo) allows you to override an -out-of-date system terminfo database with one in your $HOME/.terminfo/ -directory. +supplying an external one with entries for the terminal type. Settings depending on terminal *term-dependent-settings* |