[Emacs-diffs] /srv/bzr/emacs/trunk r99606: * faq.texi: Note that ansi-color is now enabled by default.

[Chong Yidong]

------------------------------------------------------------
revno: 99606
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Tue 2010-03-02 21:44:52 -0500
message:
  * faq.texi: Note that ansi-color is now enabled by default.
modified:
  doc/misc/ChangeLog
  doc/misc/faq.texi

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2010-02-28 10:05:21 +0000
+++ b/doc/misc/ChangeLog        2010-03-03 02:44:52 +0000
@@ -1,3 +1,8 @@
+2010-03-03  Chong Yidong  <address@hidden>
+
+       * faq.texi (Escape sequences in shell output): Note that ansi-color is
+       now enabled by default.
+
 2010-02-28  Michael Albinus  <address@hidden>
 
        * dbus.texi (Errors and Events): D-Bus messages are retrieved only,

=== modified file 'doc/misc/faq.texi'
--- a/doc/misc/faq.texi 2010-02-27 03:09:45 +0000
+++ b/doc/misc/faq.texi 2010-03-03 02:44:52 +0000
@@ -2617,22 +2617,19 @@
 @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:
-
address@hidden @bullet
address@hidden
-Make the alias conditioned on the @code{EMACS} variable in the
-environment.  When Emacs runs a subsidiary shell, it exports the
address@hidden variable to that shell, with value equal to the absolute
-file name of Emacs.  You can
-unalias @code{ls} when that happens, thus limiting the alias to your
-interactive sessions.
-
address@hidden
-Install the @code{ansi-color} package (bundled with Emacs 21.1 and
-later), which converts these ANSI escape sequences into colors.
address@hidden itemize
+In many systems, @code{ls} is aliased to @samp{ls --color}, which
+prints using ANSI color escape sequences.  Emacs version 21.1 and
+later includes the @code{ansi-color} package, which lets Shell mode
+recognize these escape sequences.  In Emacs 23.2 and later, the
+package is enabled by default; in earlier versions you can enable it
+by typing @kbd{M-x ansi-color-for-comint-mode} in the Shell buffer, or
+by adding @code{(add-hook 'shell-mode-hook
+'ansi-color-for-comint-mode-on)} to your init file.
+
+In Emacs versions before 21.1, the @code{ansi-color} package is not
+included.  In that case, you need to unalias @code{ls} for interactive
+shells running in Emacs; this can be done by checking the @code{EMACS}
+variable in the environment.
 
 @node Fullscreen mode on MS-Windows
 @section How can I start Emacs in fullscreen mode on MS-Windows?