3725d501b3
1) Refactor manpage, add STANDARDS section. 2) Boolean-style-changes. 3) Update usage, reflecting num-idiom also changed in the manpage. 4) Refactor error messages. 5) Also fclose stdin. 6) Empty line before return.
51 lines
922 B
Groff
51 lines
922 B
Groff
.Dd March 17, 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-2008
|
|
specification.
|
|
.Pp
|
|
The
|
|
.Op Fl d
|
|
flag and g unit are an extension to that specification.
|