sbase

suckless unix tools
git clone git://git.2f30.org/sbase
Log | Files | Refs | README | LICENSE

commit 3253f2eec359d46fa44d69449f27ba9e960b2ae0
parent 67e374bcba2c40aebd4a82353c967e1bfeedf003
Author: Hiltjo Posthuma <hiltjo@codemadness.org>
Date:   Sat, 31 Jan 2015 14:07:13 +0100

split.1: convert to mandoc

... and fix usage line, when -l or -b is specified the argument is required,
not optional.

Diffstat:
Msplit.1 | 80+++++++++++++++++++++++++++++++++++--------------------------------------------
1 file changed, 35 insertions(+), 45 deletions(-)

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