Un-deprecate the -G flag at obrien's request. Colour sequences are still

dependent upon the output being directed to a terminal however.
(Use the CLICOLOR_FORCE variable to force output).

1 files changed, 15 insertions, 5 deletions

diff --git a/bin/ls/ls.1 b/bin/ls/ls.1
index 7f48f12..29a303f 100644
--- a/bin/ls/ls.1
+++ b/bin/ls/ls.1
@@ -43,7 +43,7 @@
 .Nd list directory contents
 .Sh SYNOPSIS
 .Nm ls
-.Op Fl ABCFHLPRTWabcdfgiklnoqrstu1
+.Op Fl ABCFGHLPRTWabcdfgiklnoqrstu1
 .Op Ar file ...
 .Sh DESCRIPTION
 For each operand that names a
@@ -91,8 +91,9 @@ a percent sign (%) after each whiteout,
 and a vertical bar (|) after each that is a
 .Tn FIFO .
 .It Fl G
-This flag has been deprecated.  Please use the
-.Ev CLICOLOR environment variable instead.
+Enable colorized output.  This option is equivalent to defining
+.Ev CLICOLOR
+in the environment.  (See below).
 .It Fl H
 Symbolic links on the command line are followed.  This option is assumed if
 none of the
@@ -395,10 +396,19 @@ you need to set your
 .Ev TERM
 variable to
 .Dq xterm-color .
-Other terminal types may require similar adjustments.
+Other terminal types may require similar adjustments.  Colorization
+is silently disabled if the output isn't directed to a terminal
+unless the
+.Ev CLICOLOR_FORCE
+variable is defined.
 .It Ev CLICOLOR_FORCE
 Color sequences are normally disabled if the output isn't directed to
-a color capable terminal.  This can be overridden by setting this flag.
+a terminal.  This can be overridden by setting this flag.
+The
+.Ev TERM
+variable still needs to reference a color capable terminal however
+otherwise it is not possible to determine which color sequences to
+use.
 .It Ev COLUMNS
 If this variable contains a string representing a
 decimal integer, it is used as the