1
0
mirror of git://git.suckless.org/sbase synced 2024-12-22 15:04:53 +00:00
sbase/split.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

51 lines
923 B
Groff

.Dd October 8, 2015
.Dt SPLIT 1
.Os sbase
.Sh NAME
.Nm split
.Nd split up a file
.Sh SYNOPSIS
.Nm
.Op Fl a Ar num
.Op Fl b Ar num[k|m|g] | Fl l Ar num
.Op Fl d
.Op Ar file Op Ar prefix
.Sh DESCRIPTION
.Nm
splits
.Ar file
into files with 1000 lines each, named with
.Ar prefix
"x" followed by 2-digit alphabetical count suffixes.
If
.Nm
runs out of suffixes, it stops after the last valid filename.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl a Ar num
Set suffix length to
.Ar num
characters.
The default is 2.
.It Fl b Ar num[k|m|g] | Fl l Ar num
Start a new file every
.Ar num
bytes | lines.
The units k, m, and g are case insensitive and powers of 2, not 10.
The default is 1000 lines.
.It Fl d
Use decimal rather than alphabetical suffixes.
.El
.Sh SEE ALSO
.Xr cat 1
.Sh STANDARDS
The
.Nm
utility is compliant with the
.St -p1003.1-2013
specification.
.Pp
The
.Op Fl d
flag and g unit are an extension to that specification.