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.
This commit is contained in:
Eli Zaretskii 2017-12-15 11:45:22 +02:00
parent 8ed529f0f3
commit 12ad276d15
3 changed files with 8 additions and 2 deletions

View file

@ -303,6 +303,11 @@ And here's how to do it in csh:
if ($?prompt) set prompt = @dots{} if ($?prompt) set prompt = @dots{}
@end example @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 Emacs does not expect a compiler process to launch asynchronous
subprocesses; if it does, and they keep running after the main subprocesses; if it does, and they keep running after the main
compiler process has terminated, Emacs may kill them or their output compiler process has terminated, Emacs may kill them or their output

View file

@ -1397,9 +1397,10 @@ directory stack if they are not already on it
underlying shell, of course. underlying shell, of course.
@vindex comint-terminfo-terminal @vindex comint-terminfo-terminal
@vindex TERM, environment variable, in sub-shell
Comint mode sets the @env{TERM} environment variable to a safe default Comint mode sets the @env{TERM} environment variable to a safe default
value, but this value disables some useful features. For example, 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 color is supported. Therefore, Emacs provides an option
@code{comint-terminfo-terminal}, which you can set to a terminal that @code{comint-terminfo-terminal}, which you can set to a terminal that
is present in your system's terminfo database, in order to take is present in your system's terminfo database, in order to take

View file

@ -780,7 +780,7 @@ the dribble file.
@item @item
@findex open-termscript @findex open-termscript
@cindex termscript file @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 For possible display bugs, the terminal type (the value of environment
variable @env{TERM}), the complete termcap entry for the terminal from variable @env{TERM}), the complete termcap entry for the terminal from
@file{/etc/termcap} (since that file is not identical on all machines), @file{/etc/termcap} (since that file is not identical on all machines),