Hello,
as I played a bit with the "--color" option of "ls" I found, that some
values of "--color=WHEN" are undocumented.
I saw this proble in coreutils-7.0 beta and in coreutils-6.11, but
probably the problem is much older.
The valid options of "--color=WHEN" are according to the source code
coreutils-7.0/src/ls.c:828:
static char const *const color_args[] =
{
/* force and none are for compatibility with another color-ls version */
"always", "yes", "force",
"never", "no", "none",
"auto", "tty", "if-tty", NULL
};
But "ls --help" only shows:
--color[=WHEN] control whether color is used to distinguish file
types. WHEN may be `never', `always', or `auto'
[...]
By default, color is not used to distinguish types of files. That is
equivalent to using --color=none. Using the --color option without the
optional WHEN argument is equivalent to using --color=always. With
--color=auto, color codes are output only if standard output is connected
to a terminal (tty). The environment variable LS_COLORS can influence the
colors, and can be set easily by the dircolors command.
Also the manual page is incomplete:
coreutils-7.0/man/ls.1:
--color[=WHEN]
control whether color is used to distinguish file types.
WHEN may be `never', `always', or `auto'
I think, options should be documented completely.
Unfortunately I am not a native English speaker and I do not fully
understand the differences between all the "--color=WHEN" options. So I
could not provide a patch directly.
Regards,
Björn Voigt_______________________________________________
Bug-coreutils mailing list
[email protected]
http://lists.gnu.org/mailman/listinfo/bug-coreutils
