# HG changeset patch
# User Eli Zaretskii <eliz@gnu.org>
# Date 980603990 0
# Node ID d991c8f6b85bb1f2cfb1b9d6e763d54d56ce0c98
# Parent  5d275e40d47f50a553123e91464109a7b4907dec
(Escape sequences in shell output): New section.

diff -r 5d275e40d47f -r d991c8f6b85b man/faq.texi
--- a/man/faq.texi	Sat Jan 27 13:49:00 2001 +0000
+++ b/man/faq.texi	Sat Jan 27 13:59:50 2001 +0000
@@ -1223,6 +1223,7 @@
 * Replacing highlighted text::  
 * Editing MS-DOS files::        
 * Filling paragraphs with a single space::  
+* Escape sequences in shell output::   
 @end menu
 
 @node Setting up a customization file, Colors on a TTY, Common requests, Common requests
@@ -2526,7 +2527,7 @@
 different conventions that Unix and MS-DOS have for delineating the end
 of a line.
 
-@node Filling paragraphs with a single space,  , Editing MS-DOS files, Common requests
+@node Filling paragraphs with a single space,  Escape sequences in shell output, Editing MS-DOS files, Common requests
 @section How can I tell Emacs to fill paragraphs with a single space after each period?
 @cindex One space following periods
 @cindex Single space following periods
@@ -2540,6 +2541,28 @@
 (setq sentence-end-double-space nil)
 @end lisp
 
+@node Escape sequences in shell output, , Filling paragraphs with a single space, Common requests
+@section Why do I get these strange escape sequences when I run
+@code{ls} from the Shell mode?
+@cindex Escape sequences in @code{ls} output
+@cindex @code{ls} in Shell mode
+
+This happens because @code{ls} is aliased to @samp{ls --color} in your
+shell init file.  You have two alternatives to solve this:
+
+@itemize @bullet
+@item
+Make the alias conditioned on the @code{EMACS} variable in the
+environment.  When Emacs runs a subsidiary shell, it exports the
+@code{EMACS} variable with the value @code{t} to that shell.  You can
+unalias @code{ls} when that happens, thus limiting the alias to your
+interactive sessions.
+
+@item
+Install the @code{ansi-color} package (bundled with Emacs 21.1 and
+later), which converts these ANSI escape sequences into colors.
+@end itemize
+
 @c ------------------------------------------------------------
 @node    Bugs and problems, Compiling and installing Emacs, Common requests, Top
 @chapter Bugs and problems