bug-coreutils
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[PATCH] doc: ls: make help for --color more concise and accurate


From: Pádraig Brady
Subject: [PATCH] doc: ls: make help for --color more concise and accurate
Date: Mon, 14 Sep 2009 14:24:38 +0100
User-agent: Thunderbird 2.0.0.6 (X11/20071008)

Jim Meyering wrote:
> Hi Pádraig,
> 
> Is this ok with you?

In the same vein, how about this cleanup?

>From 23f8cfda81a7261edeebe406582bb68d643f10ca Mon Sep 17 00:00:00 2001
From: =?utf-8?q?P=C3=A1draig=20Brady?= <address@hidden>
Date: Thu, 10 Sep 2009 08:00:31 +0100
Subject: [PATCH] doc: ls: make help for --color more concise and accurate

* src/ls.c (usage): Shorten the --color ancillary info by
two lines, while replacing --color=none with --color=never.
Mention "always" is the default parameter of the --color option,
along with the primary help for that option.
Mention the ancillary --color info in the --color primary help.
---
 src/ls.c |   14 ++++++--------
 1 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/src/ls.c b/src/ls.c
index b62ea12..220ab65 100644
--- a/src/ls.c
+++ b/src/ls.c
@@ -4552,8 +4552,8 @@ Mandatory arguments to long options are mandatory for 
short options too.\n\
 "), stdout);
       fputs (_("\
   -C                         list entries by columns\n\
-      --color[=WHEN]         control whether color is used to distinguish 
file\n\
-                               types.  WHEN may be `never', `always', or 
`auto'\n\
+      --color[=WHEN]         colorize the output.  WHEN defaults to `always'\n\
+                               or can be `never' or `auto'.  More info below\n\
   -d, --directory            list directory entries instead of contents,\n\
                                and do not dereference symbolic links\n\
   -D, --dired                generate output designed for Emacs' dired mode\n\
@@ -4667,12 +4667,10 @@ Mandatory arguments to long options are mandatory for 
short options too.\n\
       emit_size_note ();
       fputs (_("\
 \n\
-By default, color is not used to distinguish types of files.  That is\n\
-equivalent to using --color=none.  Using the --color option without the\n\
-optional WHEN argument is equivalent to using --color=always.  With\n\
---color=auto, color codes are output only if standard output is connected\n\
-to a terminal (tty).  The environment variable LS_COLORS can influence the\n\
-colors, and can be set easily by the dircolors command.\n\
+Using color to distinguish types of files is not enabled by default, or when\n\
+--color=never is specified.  With --color=auto, color codes are output only\n\
+when standard output is connected to a terminal.  The LS_COLORS environment\n\
+variable can change the default codes and can be set using dircolors command\n\
 "), stdout);
       fputs (_("\
 \n\
-- 
1.6.2.5




reply via email to

[Prev in Thread] Current Thread [Next in Thread]