[Emacs-diffs] master 4b70de2: Expand direct color description in Emacs FAQ

[Eli Zaretskii]

branch: master
commit 4b70de228d663cdbbae9668e6e990b0064e72fda
Author: Rami Ylimäki <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Expand direct color description in Emacs FAQ
    
    * doc/misc/efaq.texi (Colors on a TTY): Show how to list direct
    mode TERM definitions.  (Bug#30429)
---
 doc/misc/efaq.texi | 29 +++++++++++++++++++++++++----
 1 file changed, 25 insertions(+), 4 deletions(-)

diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi
index fef9b10..5392748 100644
--- a/doc/misc/efaq.texi
+++ b/doc/misc/efaq.texi
@@ -1490,6 +1490,7 @@ exhibits all the colors Emacs knows about on the current 
display.
 
 Syntax highlighting is on by default since version 22.1.
 
address@hidden direct color in terminals
 Emacs 26.1 and later support direct color mode in terminals.  If Emacs
 finds Terminfo capabilities @samp{setb24} and @samp{setf24}, 24-bit
 direct color mode is used.  The capability strings are expected to
@@ -1504,14 +1505,17 @@ $ cat terminfo-custom.src
 
 xterm-emacs|xterm with 24-bit direct color mode for Emacs,
   use=xterm-256color,
-  
setb24=\E[48\:2\:\:address@hidden@}%/%d\:address@hidden@}%/address@hidden@}%&%d\:address@hidden@}%&%dm,
-  
setf24=\E[38\:2\:\:address@hidden@}%/%d\:address@hidden@}%/address@hidden@}%&%d\:address@hidden@}%&%dm,
+  
setb24=\E[48\:2\:\:address@hidden@}%/%d\:address@hidden@}%/address@hidden@}%&\
+     %d\:address@hidden@}%&%dm,
+  
setf24=\E[38\:2\:\:address@hidden@}%/%d\:address@hidden@}%/address@hidden@}%&\
+     %d\:address@hidden@}%&%dm,
 
 $ tic -x -o ~/.terminfo terminfo-custom.src
 
 $ TERM=xterm-emacs emacs -nw
 @end example
 
address@hidden 24-bit direct color mode
 Emacs 27.1 and later support Terminfo capability @samp{RGB} for
 detecting 24-bit direct color mode.  Multiple standard terminal
 definitions support this capability.
@@ -1519,12 +1523,29 @@ definitions support this capability.
 @example
 $ TERM=xterm-direct infocmp | grep seta[bf]
 
-  
address@hidden@}%<%t4%p1%d%e48\:2\:\:address@hidden@}%/%d\:address@hidden@}%/address@hidden@}%&%d\:address@hidden@}%&%d%;m,
-  
address@hidden@}%<%t3%p1%d%e38\:2\:\:address@hidden@}%/%d\:address@hidden@}%/address@hidden@}%&%d\:address@hidden@}%&%d%;m,
+  address@hidden@}%<%t4%p1%d%e48\:2\:\:address@hidden@}%/\
+     %d\:address@hidden@}%/address@hidden@}%&%d\:address@hidden@}%&%d%;m,
+  address@hidden@}%<%t3%p1%d%e38\:2\:\:address@hidden@}%/\
+     %d\:address@hidden@}%/address@hidden@}%&%d\:address@hidden@}%&%d%;m,
 
 $ TERM=xterm-direct emacs -nw
 @end example
 
+If your terminal is incompatible with XTerm, you may have to use
+another @env{TERM} definition.  Any terminal whose name includes
address@hidden should be a candidate.  The @command{toe} command can be
+used to find out which of these are installed on your system:
+
address@hidden
+$ toe | grep '\-direct'
+
+konsole-direct  konsole with direct-color indexing
+vte-direct      vte with direct-color indexing
+st-direct       st with direct-color indexing
+xterm-direct2   xterm with direct-color indexing (old)
+xterm-direct    xterm with direct-color indexing
address@hidden example
+
 Terminals with @samp{RGB} capability treat pixels #000001 - #000007 as
 indexed colors to maintain backward compatibility with applications
 that are unaware of direct color mode.  Therefore the seven darkest