* coreutils.texi (ls: General output formatting): Mention the

workarounds to accommodate the Apple Terminal bug.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 5f590af..a9c6d29 100644 (file)
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2007-01-19  Jim Meyering  <jim@meyering.net>
+
+       * coreutils.texi (ls: General output formatting): Mention the
+       workarounds to accommodate the Apple Terminal bug.
+
 2007-01-04  Jim Meyering  <jim@meyering.net>
 
        * coreutils.texi (base64 invocation): When decoding, newlines

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index 6fc6704..89e97d8 100644 (file)
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -6419,6 +6419,13 @@ Assume that each tab stop is @var{cols} columns wide.  The default is 8.
 @command{ls} uses tabs where possible in the output, for efficiency.  If
 @var{cols} is zero, do not use tabs at all.
 
+@c FIXME: remove in 2009, if Apple Terminal has been fixed for long enough.
+Some terminal emulators (at least Apple Terminal 1.5 (133) from Mac OS X 10.4.8)
+do not properly align columns to the right of a TAB following a
+non-@acronym{ASCII} byte.  If you use such a terminal emulator, use the
+@option{-T0} option or put @code{TABSIZE=0} in your environment to tell
+@command{ls} to align using spaces, not tabs.
+
 @item -w
 @itemx --width=@var{cols}
 @opindex -w