Date: Mon, 23 Jul 2001 02:05:06 -0700 From: Dima Dorfman <dima@unixfreak.org> To: Sheldon Hearn <sheldonh@starjuice.net> Cc: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/bin/ls ls.1 Message-ID: <20010723090506.D79C13E2F@bazooka.unixfreak.org> In-Reply-To: <46876.995877622@axl.seasidesoftware.co.za>; from sheldonh@starjuice.net on "Mon, 23 Jul 2001 10:40:22 %2B0200"
next in thread | previous in thread | raw e-mail | index | archive | help
Sheldon Hearn <sheldonh@starjuice.net> writes:
>
>
> On Sun, 22 Jul 2001 03:33:31 MST, Dima Dorfman wrote:
>
> > Modified files:
> > bin/ls ls.1
> > Log:
> > Don't put a shell prompt in the example since none of the other man
> > pages do it. Also, don't use brackets to indicate optional options in
> > the example; instead, add a paragraph below the example explaining it.
>
> The use of the second person ("you") in this document is getting worse.
> It began with that god-awful colour import, and this delta adds more.
>
> Please be careful not to introduce the second person ("you") into
> documents that are relatively pure in this respect.
This I wholeheartedly agree with. How about this patch:
Index: ls.1
===================================================================
RCS file: /stl/src/FreeBSD/src/bin/ls/ls.1,v
retrieving revision 1.52
diff -u -r1.52 ls.1
--- ls.1 2001/07/22 10:33:31 1.52
+++ ls.1 2001/07/23 09:04:30
@@ -367,10 +367,11 @@
.Pp
.Dl "ls -l | sort -n +4"
.Pp
-Additionally, you may want to use the
+Additionally, the
.Fl r
flag to
.Xr sort 1
+may be used
to get the results sorted from largest to smallest (a reverse sort).
.Sh DIAGNOSTICS
The
@@ -403,12 +404,12 @@
The default
.Dq cons25
console has the proper capabilities,
-however if you want to display the colors in an
-.Xr xterm 1
+but to display the colors in an
+.Xr xterm 1 ,
for example,
-you need to set your
+the
.Ev TERM
-variable to
+variable must be set to
.Dq xterm-color .
Other terminal types may require similar adjustments. Colorization
is silently disabled if the output isn't directed to a terminal
@@ -481,7 +482,7 @@
.Tn ANSI
colors.
The actual display may differ
-depending on the color capabilities of your terminal.
+depending on the color capabilities of the terminal in use.
.Pp
The order of the attributes are as follows:
.Pp
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010723090506.D79C13E2F>