summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJim Meyering <jim@meyering.net>2001-06-16 11:05:30 +0000
committerJim Meyering <jim@meyering.net>2001-06-16 11:05:30 +0000
commitf1bc30be6fc7743d18203affe6004a46f1a901dc (patch)
treee86406d490710faa088554814cb69f5f88d9be0e /doc
parent6560a8c7845cb58de3270dc12ff6a170cd87330c (diff)
downloadcoreutils-f1bc30be6fc7743d18203affe6004a46f1a901dc.tar.xz
(ls invocation): Mention the effect of locale.
Diffstat (limited to 'doc')
-rw-r--r--doc/omni-utils.texi8
1 files changed, 7 insertions, 1 deletions
diff --git a/doc/omni-utils.texi b/doc/omni-utils.texi
index ce8c08aa4..ec95f354d 100644
--- a/doc/omni-utils.texi
+++ b/doc/omni-utils.texi
@@ -4540,7 +4540,13 @@ arguments, by default @code{ls} lists just the file name. If no
non-option argument is specified, @code{ls} operates on the current
directory, acting as if it had been invoked with a single argument of @samp{.}.
-By default, the output is sorted alphabetically. If standard output is
+@vindex LC_COLLATE
+By default, the output is sorted alphabetically, according to the locale
+settings in effect. @footnote{If you have arranged to use a non-@sc{posix}
+locale (e.g., by setting @env{LC_ALL} to @samp{en_US}), then @code{ls} may
+produce output that is sorted differently than you're accustomed to.
+In that case, set the @env{LC_COLLATE} environment variable to @samp{C}.}
+If standard output is
a terminal, the output is in columns (sorted vertically) and control
characters are output as question marks; otherwise, the output is listed
one per line and control characters are output as-is.