summaryrefslogtreecommitdiff
path: root/usr.bin/split/split.1
diff options
context:
space:
mode:
authorjtc <jtc@NetBSD.org>1994-12-21 08:11:23 +0000
committerjtc <jtc@NetBSD.org>1994-12-21 08:11:23 +0000
commit5233fb40266ffd8b405524fa171a342abf78c70c (patch)
treede2f1b3be29ba7cc5357ab8d67654ef8f8ffa826 /usr.bin/split/split.1
parentfdc1920d231ad76a218ed384918ce059f71d6e58 (diff)
Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id convention.
Diffstat (limited to 'usr.bin/split/split.1')
-rw-r--r--usr.bin/split/split.192
1 files changed, 43 insertions, 49 deletions
diff --git a/usr.bin/split/split.1 b/usr.bin/split/split.1
index 42e7b6a586b..788f1007b93 100644
--- a/usr.bin/split/split.1
+++ b/usr.bin/split/split.1
@@ -1,5 +1,7 @@
-.\" Copyright (c) 1990, 1991 Regents of the University of California.
-.\" All rights reserved.
+.\" $NetBSD: split.1,v 1.5 1994/12/21 08:20:35 jtc Exp $
+.\"
+.\" Copyright (c) 1990, 1991, 1993, 1994
+.\" The Regents of the University of California. All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
@@ -29,10 +31,9 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" from: @(#)split.1 6.4 (Berkeley) 7/29/91
-.\" $Id: split.1,v 1.4 1994/04/01 04:01:48 cgd Exp $
+.\" @(#)split.1 8.3 (Berkeley) 4/16/94
.\"
-.Dd July 29, 1991
+.Dd April 16, 1994
.Dt SPLIT 1
.Os
.Sh NAME
@@ -40,66 +41,59 @@
.Nd split a file into pieces
.Sh SYNOPSIS
.Nm split
-.Op Fl Ns Ar n
-.Op Fl b Ar bytes
+.Op Fl b Ar byte_count[k|m]
+.Op Fl l Ar line_count
.Op Ar file Op Ar name
.Sh DESCRIPTION
The
.Nm split
utility reads the given
.Ar file
-and splits it up in to
-smaller files.
+(or standard input if no file is specified)
+and breaks it up into files of 1000 lines each.
.Pp
-Available options:
-.Bl -tag -width "bb bytesx"
-.It Fl Ns Ar lines
-Create files of length
-.Fl Ns Ar n
-lines long.
-.It Fl b Ar bytes
-Create files of length
-.Ar bytes .
+The options are as follows:
+.Bl -tag -width Ds
+.It Fl b
+Create smaller files
+.Ar byte_count
+bytes in length.
+If
+.Dq Li k
+is appended to the number, the file is split into
+.Ar byte_count
+kilobyte pieces.
+If
+.Dq Li m
+is appended to the number, the file is split into
+.Ar byte_count
+megabyte pieces.
+.It Fl l
+Create smaller files
+.Ar n
+lines in length.
.El
.Pp
-If no output file length is specified, the file size
-will default to a length of 1000 lines.
+If additional arguments are specified, the first is used as the name
+of the input file which is to be split.
+If a second additional argument is specified, it is used as a prefix
+for the names of the files into which the file is split.
+In this case, each file into which the file is split is named by the
+prefix followed by a lexically ordered suffix in the range of
+.Dq Li aa-zz .
.Pp
-Available operands:
-.Bl -tag -width name
-.It Fl
-Read from the standard input.
-.It Ar file
-A pathname specifying the
-.Ar file
-to be split. If no
-.Ar file
-operand is given,
-.Nm split
-reads from the standard input.
-.It Ar name
If the
.Ar name
-operand is given,
-the output files will begin with the prefix
-.Ar name
-and each sequential portion of the split file
-receives a lexically ordered suffix
-in the range of
-.Bq Em aa-zz .
-If the operand
-.Ar name
-is not specified,
-the default prefix of
-.Em x
-is be used.
-.Pp
+argument is not specified, the file is split into lexically ordered
+files named in the range of
+.Dq Li xaa-zzz .
.Sh BUGS
-If you provide
+For historical reasons, if you specify
.Ar name ,
.Nm split
can only create 676 separate
-files. The default naming convention allows 2028 separate files.
+files.
+The default naming convention allows 2028 separate files.
.Sh HISTORY
A
.Nm split