|author||Tom Ryder <firstname.lastname@example.org>||2017-11-12 22:19:25 +1300|
|committer||Tom Ryder <email@example.com>||2017-11-12 22:19:25 +1300|
Update and correct detect_background.vim help
1 files changed, 10 insertions, 4 deletions
diff --git a/vim/doc/detect_background.txt b/vim/doc/detect_background.txt
index ad42221c..ed122aee 100644
@@ -3,11 +3,17 @@
Author: Tom Ryder <firstname.lastname@example.org>
License: Same terms as Vim itself (see |license|)
-This plugin inspects the $COLORFGBG environment variable to determine whether
-the user is using a terminal with a light background. It reverses Vim's
-built-in attempts to do this, which have the opposite default.
+The detect_background#DetectBackground() function provided by this plugin
+inspects the $COLORFGBG environment variable to determine whether the user is
+using a terminal with a light background, and returns the word "dark" or
+"light" accordingly, for use in setting 'background'.
-It does not inspect the value of the $TERM variable or |'term'| at all.
+The function does roughly the reverse of Vim's built-in heuristics to set the
+'background' option, which default to a light background in the absence of
+Note that this plugin does not inspect the value of the $TERM environment
+variable or the |'term'| option at all, nor the |'t_RB'| option.
This plugin lives in Tom Ryder's "dotfiles" suite, and will eventually be spun
off into a separate distribution as it solidifies and this documentation