Undocumented values of ls --color

[Bjoern Voigt]

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