1
0
mirror of git://git.suckless.org/sbase synced 2025-01-02 21:12:15 +00:00
sbase/du.1
Brandon Pribula d458fa2c7b fix: update man pages to standard mdoc date format
When viewing sbase's man pages the date displayed at the bottom is
the current date rather than the date entered in the <program>.1
file.

According to this:

https://mandoc.bsd.lv/mdoc/details/date.html

The traditional man date format used by sbase (.Dd year-month-day)
is no longer recommended and no longer supported by GNU troff or
Heirloom Docs and as a result the current date is displayed instead.
Although this format is still accepted by mandoc for backward
compatibility.

For portability it states the standard mdoc date format should be
used instead: .Dd month day, year

I applied the following patch to sbase's last commit b30fb56 and
it fixes the issue.
2024-09-08 08:35:39 +02:00

62 lines
1.3 KiB
Groff

.Dd October 8, 2015
.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.