Re: du man page

Hi,

adr@SDF.ORG wrote on Wed, Oct 21, 2020 at 11:44:01AM +0000:

> In du(1) it reads:
>
> [...]
> EXAMPLES
> Display a summary of files and folders in the current directory,
> sorted by size:
>
> $ du -sh * .??* | sort -h
> [...]
>
> This misses file names of the form .a, .1, etc. Better use something like
>
> $ du -ahd1 . | sort -h

Committed with three tweaks:

* The "." is redundant, it is the default for "file",
as documented in the first paragraph.
* POSIX recommends a space between an option and its argument,
and we usually follow that advice in our manuals.
* I like the word "had" better than the word "ahd".

> Where is the best place to report these trivial documentation fixes?

If you include a patch, tech@. If you don't, misc@ is fine.

Yours,
Ingo


CVSROOT: /cvs
Module name: src
Changes by: schwarze@cvs.openbsd.org 2020/10/21 11:00:47

Modified files:
usr.bin/du : du.1

Log message:
simplify and improve the example by using the -a and -d options;
suggested by <adr at sdf dot org>, tweaked by me


Index: du.1
===================================================================
RCS file: /cvs/src/usr.bin/du/du.1,v
retrieving revision 1.37
diff -u -r1.37 du.1
--- du.1 30 Jan 2020 17:54:30 -0000 1.37
+++ du.1 21 Oct 2020 16:56:47 -0000
@@ -151,7 +151,7 @@
Display a summary of files and folders in the current directory,
sorted by size:
.Pp
-.Dl $ du -sh * .??* | sort -h
+.Dl $ du -had 1 | sort -h
.Sh SEE ALSO
.Xr df 1 ,
.Xr fts_open 3 ,