split.1: convert to mandoc

... and fix usage line, when -l or -b is specified the argument is required,
not optional.
This commit is contained in:
Hiltjo Posthuma 2015-01-31 14:07:13 +01:00
parent 67e374bcba
commit 3253f2eec3

80
split.1
View File

@ -1,58 +1,48 @@
.TH SPLIT 1 sbase\-VERSION .Dd January 30, 2015
.SH NAME .Dt SPLIT 1 sbase\-VERSION
split \- split up a file .Os
.SH SYNOPSIS .Sh NAME
.B split .Nm split
.RB [ \-d ] .Nd split up a file
.RB [ \-a .Sh SYNOPSIS
.IR len ] .Nm
.RB [ \-b .Op Fl a Ar len
.RI [ bytes [k|m|g]]] .Op Fl b Ar bytes[k|m|g]
.RB [ \-l .Op Fl d
.RI [ lines ]] .Op Fl l Ar lines
.RI [ input .Op Ar input Op Ar prefix
.RI [ prefix ]] .Sh DESCRIPTION
.Nm
.SH DESCRIPTION reads a file, splitting it into smaller files, every
.B split .Ar bytes
Reads a file, splitting it into smaller files, every
.IR bytes
bytes bytes
or or
.IR lines .Ar lines
lines. If lines. If
.B split .Nm
runs out of filenames before all the data can be written, it stops at the runs out of filenames before all the data can be written, it stops at the
last valid filename, leaving all the written data on the disk. last valid filename, leaving all the written data on the disk.
The The
.IR b .Fl b
and and
.IR l .Fl l
flags are mutually exclusive. Only the last one specified will be obeyed. flags are mutually exclusive. Only the last one specified will be obeyed.
.Sh OPTIONS
.SH OPTIONS .Bl -tag -width Ds
.TP .It Fl a Ar len
.B \-d
Use decimal suffixes rather than alphabetical.
.TP
.B \-a "len"
Set the suffix length to Set the suffix length to
.IR len .Ar len
characters long. characters long.
.It Fl b Ar bytes[k|m|g]
.TP start a new file every
.B \-b [bytes[k|m|g]] .Ar bytes
Start a new file every
.IR bytes
bytes. The units k, m, and g are case insensitive, and powers of 2, not 10. bytes. The units k, m, and g are case insensitive, and powers of 2, not 10.
.It Fl d
.TP Use decimal suffixes rather than alphabetical.
.B \-l [lines] .It Fl l Ar lines
Start a new file every Start a new file every
.IR lines .Ar lines
lines. lines.
.El
.SH SEE ALSO .Sh SEE ALSO
.IR cat (1) .Xr cat 1