Improve documentation of TERM environment variable

* doc/emacs/trouble.texi (Checklist):
* doc/emacs/building.texi (Compilation Shell):
* doc/emacs/misc.texi (Shell Options): Improve indexing of TERM.
* doc/emacs/building.texi (Compilation Shell): Mention
'comint-terminfo-terminal' in conjunction with the TERM value.

diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi
index 87ac61bac3b600a356237491579500c71164e998..e108a4e7c1087c8b75e9133663863f024fa4813e 100644 (file)
--- a/doc/emacs/building.texi
+++ b/doc/emacs/building.texi
@@ -303,6 +303,11 @@ And here's how to do it in csh:
 if ($?prompt) set prompt = @dots{}
 @end example
 
+@vindex TERM, environment variable, in compilation mode
+  If you want to customize the value of the @env{TERM} environment
+variable passed to the compilation subshell, customize the variable
+@code{comint-terminfo-terminal} (@pxref{Shell Options}).
+
   Emacs does not expect a compiler process to launch asynchronous
 subprocesses; if it does, and they keep running after the main
 compiler process has terminated, Emacs may kill them or their output

diff --git a/doc/emacs/misc.texi b/doc/emacs/misc.texi
index b6b396af8f51772554ee46f5bb25f067ce35521d..e4be004ae52c0382beac79569181230233f49a9b 100644 (file)
--- a/doc/emacs/misc.texi
+++ b/doc/emacs/misc.texi
@@ -1397,9 +1397,10 @@ directory stack if they are not already on it
 underlying shell, of course.
 
 @vindex comint-terminfo-terminal
+@vindex TERM, environment variable, in sub-shell
 Comint mode sets the @env{TERM} environment variable to a safe default
 value, but this value disables some useful features.  For example,
-color is disabled for applications that use @env{TERM} to determine if
+color is disabled in applications that use @env{TERM} to determine if
 color is supported.  Therefore, Emacs provides an option
 @code{comint-terminfo-terminal}, which you can set to a terminal that
 is present in your system's terminfo database, in order to take

diff --git a/doc/emacs/trouble.texi b/doc/emacs/trouble.texi
index 4a836c3224bd47db93fddddf67a49d562e3f1dff..e98322d74e2c1686eb105c5ea8d6ad766f1ca006 100644 (file)
--- a/doc/emacs/trouble.texi
+++ b/doc/emacs/trouble.texi
@@ -780,7 +780,7 @@ the dribble file.
 @item
 @findex open-termscript
 @cindex termscript file
-@cindex @env{TERM} environment variable
+@vindex TERM, environment variable, and display bugs
 For possible display bugs, the terminal type (the value of environment
 variable @env{TERM}), the complete termcap entry for the terminal from
 @file{/etc/termcap} (since that file is not identical on all machines),