From f1bc30be6fc7743d18203affe6004a46f1a901dc Mon Sep 17 00:00:00 2001 From: Jim Meyering Date: Sat, 16 Jun 2001 11:05:30 +0000 Subject: [PATCH] (ls invocation): Mention the effect of locale. --- doc/omni-utils.texi | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) 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.