From: Paul Eggert <eggert@cs.ucla.edu>
Date: Tue, 20 Sep 2022 07:09:42 +0000 (-0700)
Subject: doc: warn about tabs command (bug#57946)
X-Git-Tag: v9.2~136
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=4cbe227fa0b1bfd05b10245a3466ed99413e3a15;p=thirdparty%2Fcoreutils.git

doc: warn about tabs command (bug#57946)
---

diff --git a/doc/coreutils.texi b/doc/coreutils.texi
index e6eae44dc7..adf957e612 100644
--- a/doc/coreutils.texi
+++ b/doc/coreutils.texi
@@ -8295,6 +8295,15 @@ TAB following a non-ASCII byte.  You can avoid that issue by using the
 @option{-T0} option or put @code{TABSIZE=0} in your environment, to tell
 @command{ls} to align using spaces, not tabs.
 
+If set a terminal's hardware tabs to anything other than the default,
+you should also use a @command{--tabsize} option or @env{TABSIZE}
+environment variable either to match the hardware tabs, or to disable
+the use of hardware tabs.  Otherwise, the output of @command{ls} may
+not line up.  For example, if you run the shell command @samp{tabs -4}
+to set hardware tabs to every four columns, you should also run
+@samp{export TABSIZE=4} or @samp{export TABSIZE=0}, or use the
+corresponding @option{--tabsize} options.
+
 @item -w @var{cols}
 @itemx --width=@var{cols}
 @opindex -w