Re: du man page

had is rad.

On Wed, Oct 21, 2020 at 10:09 AM Ingo Schwarze <schwarze@usta.de> wrote:

> 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 ,
>
>