aboutsummaryrefslogtreecommitdiff
path: root/runtime
diff options
context:
space:
mode:
authorJonathan de Boyne Pollard <J.deBoynePollard-newsgroups@NTLWorld.com>2017-05-27 12:38:14 +0100
committerJonathan de Boyne Pollard <J.deBoynePollard-newsgroups@NTLWorld.com>2017-06-03 18:53:28 +0100
commit16300d02c7fbe95396697fc6c09012e2c2b47b69 (patch)
tree0ad044491f2d66b5c363de3d7fa53b6a02749fc7 /runtime
parent67e2120459268494c589cc5be6a20b05fdd9ca84 (diff)
downloadrneovim-16300d02c7fbe95396697fc6c09012e2c2b47b69.tar.gz
rneovim-16300d02c7fbe95396697fc6c09012e2c2b47b69.tar.bz2
rneovim-16300d02c7fbe95396697fc6c09012e2c2b47b69.zip
tui: Improvements to RGB colour support.
The details are in the on-line help under :help true-color . The brief precis is that nvim is (I hope.) converging with tmux and libvte. It is taking the same approach with setrgbf and setrgbb terminfo capabilities that it does with the Ss and Se terminfo capabilities.
Diffstat (limited to 'runtime')
-rw-r--r--runtime/doc/term.txt21
1 files changed, 14 insertions, 7 deletions
diff --git a/runtime/doc/term.txt b/runtime/doc/term.txt
index c4eefe4e53..fcfb548723 100644
--- a/runtime/doc/term.txt
+++ b/runtime/doc/term.txt
@@ -82,11 +82,16 @@ operation; and it will override |terminfo| saying that it has fewer colours
available.
*true-color* *xterm-true-color*
-Nvim supports using true (24-bit) colours in the terminal. |terminfo| does
-not contain flags to say when terminals have true colour support. So Nvim
-simply assumes true colour support for (all) "xterm", "rxvt", "linux",
-"putty", and "iterm" terminal types, or when Konsole or a terminal emulator
-that sets the COLORTERM environment variable to "truecolor" is detected.
+Nvim supports using true (24-bit) colours in the terminal, on terminals that
+support it. It uses the same |terminfo| extensions that were proposed by
+RĂ¼diger Sonderfeld in 2013 for this: "setrgbf" and "setrgbb". If your
+terminfo definition specifies these, then nothing more is required.
+
+If your terminfo definition is missing them, then Nvim will on a wide range of
+terminals resort to using the ISO 8613-6:1994/ITU T.416:1993 control sequences
+for setting RGB colours. This includes the "rxvt", "linux", "st", and "iterm"
+terminal types, or when Konsole, genuine Xterm, or a terminal emulator that
+sets the COLORTERM environment variable to "truecolor" is detected.
*xterm-resize*
Nvim can resize the terminal display on some terminals that implement an
@@ -99,12 +104,14 @@ Nvim will adjust the shape of the cursor from a block to a line when in insert
mode (or as specified by the 'guicursor' option), on terminals that support
it. It uses the same |terminfo| extensions that were pioneered by tmux for
this: "Ss" and "Se". If your terminfo definition specifies these, as some
-(such as "xterm+tmux") do, then nothing more is required.
+(such as those based upon "xterm+tmux") do, then nothing more is required.
If your terminfo definition is missing them, then Nvim will on a wide range of
terminals resort to using the conventional DECSUSR control sequence for
adjusting the cursor shape. If Konsole is detected, Nvim will use the
-idiosyncratic Konsole terminal control sequences for this.
+idiosyncratic Konsole terminal control sequences for this. Similarly if the
+Linux kernel's built-in terminal emulator is detected, with its idiosyncratic
+control sequence.
Note: tmux itself accepts the conventional DECSUSR control sequence, the same
as many other terminals do. It has to translate this into whatever control