sbase/du.1

.Dd 2015-10-08
.Dt DU 1
.Os sbase
.Sh NAME
.Nm du
.Nd display disk usage statistics
.Sh SYNOPSIS
.Nm
.Op Fl a | s
.Op Fl d Ar depth
.Op Fl h
.Op Fl k
.Op Fl H | L | P
.Op Fl x
.Op Ar file ...
.Sh DESCRIPTION
.Nm
displays the file system block usage for each
.Ar file
argument and for each directory in the file hierarchy rooted in directory
argument.
If no
.Ar file
is specified, the block usage of the hierarchy rooted in the current directory
is displayed.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl a
Display an entry for each file in the file hierarchy.
.It Fl s
Display only the grand total for the specified files.
.It Fl d Ar depth
Maximum directory depth to print files and directories.
.It Fl h
Enable human-readable output.
.It Fl k
By default all sizes are reported in 512-byte block counts.
The
.Fl k
option causes the numbers to be reported in kilobyte counts.
.It Fl H
Only dereference symbolic links that are passed as command line arguments when
recursively traversing directories.
.It Fl L
Always dereference symbolic links while recursively traversing directories.
.It Fl P
Don't dereference symbolic links.
This is the default.
.It Fl x
Do not traverse file systems mount points.
.El
.Sh STANDARDS
The
.Nm
utility is compliant with the
.St -p1003.1-2013
specification.
.Pp
The
.Op Fl dhP
flags are an extension to that specification.
Use ISO-date-format in manpages The one specified by mdoc is hard to read for non-native speakers from countries which read the date day-first (like Germany, Greece, North-Korea, Swamp,...). This is also consistent with how we generally specify dates at suckless.org. 2015-10-08 11:15:08 -04:00			`.Dd 2015-10-08`
remove sbase-VERSION from man page, fix sponge.1 date 2015-01-31 08:20:02 -05:00			`.Dt DU 1`
Add .Os sbase and sed replace to .Os sbase $(VERSION) in make install 2015-01-31 14:37:03 -05:00			`.Os sbase`
du.1: convert to mandoc 2015-01-30 16:13:37 -05:00			`.Sh NAME`
			`.Nm du`
			`.Nd display disk usage statistics`
			`.Sh SYNOPSIS`
			`.Nm`
			`.Op Fl a \| s`
			`.Op Fl d Ar depth`
			`.Op Fl h`
			`.Op Fl k`
du: Update usage and document -P as well 2015-02-17 11:07:10 -05:00			`.Op Fl H \| L \| P`
Add -x support for du(1) 2015-02-18 12:24:21 -05:00			`.Op Fl x`
du.1: convert to mandoc 2015-01-30 16:13:37 -05:00			`.Op Ar file ...`
			`.Sh DESCRIPTION`
			`.Nm`
Add primitive du(1) Defaults to a 512-byte blocksize. 2013-10-16 11:58:52 -04:00			`displays the file system block usage for each`
du.1: convert to mandoc 2015-01-30 16:13:37 -05:00			`.Ar file`
fix mandoc warnings - sort references in SEE ALSO section to section number, name. - cols.1: proper order of sections. - wrap lines to max 79 column length. 2015-01-31 08:43:27 -05:00			`argument and for each directory in the file hierarchy rooted in directory`
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command. 2020-03-01 17:37:31 -05:00			`argument.`
			`If no`
fix mandoc warnings - sort references in SEE ALSO section to section number, name. - cols.1: proper order of sections. - wrap lines to max 79 column length. 2015-01-31 08:43:27 -05:00			`.Ar file`
			`is specified, the block usage of the hierarchy rooted in the current directory`
			`is displayed.`
du.1: convert to mandoc 2015-01-30 16:13:37 -05:00			`.Sh OPTIONS`
			`.Bl -tag -width Ds`
			`.It Fl a`
Add primitive du(1) Defaults to a 512-byte blocksize. 2013-10-16 11:58:52 -04:00			`Display an entry for each file in the file hierarchy.`
du: Update usage and document -P as well 2015-02-17 11:07:10 -05:00			`.It Fl s`
			`Display only the grand total for the specified files.`
du.1: convert to mandoc 2015-01-30 16:13:37 -05:00			`.It Fl d Ar depth`
du: add -d flag to specify the max depth to show files or directories we don't allow to use it with -s (like GNU du). busybox allows it. 2014-10-18 17:26:35 -04:00			`Maximum directory depth to print files and directories.`
man pages: improve consistency 2015-02-01 14:52:28 -05:00			`.It Fl h`
			`Enable human-readable output.`
du.1: convert to mandoc 2015-01-30 16:13:37 -05:00			`.It Fl k`
Add -k support for du(1) This setting overrides the BLOCKSIZE environment variable. 2013-10-16 13:00:02 -04:00			`By default all sizes are reported in 512-byte block counts.`
du.1: convert to mandoc 2015-01-30 16:13:37 -05:00			`The`
			`.Fl k`
			`option causes the numbers to be reported in kilobyte counts.`
du: Update usage and document -P as well 2015-02-17 11:07:10 -05:00			`.It Fl H`
			`Only dereference symbolic links that are passed as command line arguments when`
			`recursively traversing directories.`
			`.It Fl L`
			`Always dereference symbolic links while recursively traversing directories.`
du: Fix typo in manpage 2015-02-18 10:20:22 -05:00			`.It Fl P`
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command. 2020-03-01 17:37:31 -05:00			`Don't dereference symbolic links.`
			`This is the default.`
Add -x support for du(1) 2015-02-18 12:24:21 -05:00			`.It Fl x`
			`Do not traverse file systems mount points.`
du.1: convert to mandoc 2015-01-30 16:13:37 -05:00			`.El`
Update manpage for du(1) 2015-02-18 15:42:23 -05:00			`.Sh STANDARDS`
			`The`
			`.Nm`
			`utility is compliant with the`
POSIX 2013 audit Mostly manpage-shuffling according to the changes in the corrigendum, wording changes and more idiomatic expressions. All this is finished up by marking the POSIX 2013 conformant tools with .St -p1003.1-2013 which is not available in older mandoc builds or nroff, but which reflects what we actually did, so who cares? This is a huge step and it's not far until we can release sbase 0.1. 2015-03-27 12:22:48 -04:00			`.St -p1003.1-2013`
			`specification.`
			`.Pp`
			`The`
			`.Op Fl dhP`
			`flags are an extension to that specification.`