[BACK]Return to split.1 CVS log [TXT][DIR] Up to [local] / src / usr.bin / split

Diff for /src/usr.bin/split/split.1 between version 1.11 and 1.12

version 1.11, 2006/08/09 12:04:21 version 1.12, 2006/08/09 22:42:08
Line 30 
Line 30 
 .\"  .\"
 .\"     @(#)split.1     8.3 (Berkeley) 4/16/94  .\"     @(#)split.1     8.3 (Berkeley) 4/16/94
 .\"  .\"
 .Dd April 16, 1994  .Dd August 9, 2006
 .Dt SPLIT 1  .Dt SPLIT 1
 .Os  .Os
 .Sh NAME  .Sh NAME
Line 38 
Line 38 
 .Nd split a file into pieces  .Nd split a file into pieces
 .Sh SYNOPSIS  .Sh SYNOPSIS
 .Nm split  .Nm split
   .Op Fl a Ar suffix_length
   .br
 .Oo  .Oo
 .Fl b  .Fl b
 .Sm off  .Sm off
Line 59 
Line 61 
 .Pp  .Pp
 The options are as follows:  The options are as follows:
 .Bl -tag -width Ds  .Bl -tag -width Ds
   .It Fl a Ar suffix_length
   Use
   .Ar suffix_length
   letters to form the suffix of the file name
   (see below).
   The default suffix length is 2.
 .It Xo  .It Xo
 .Fl b  .Fl b
 .Sm off  .Sm off
Line 88 
Line 96 
 .Ar pattern ,  .Ar pattern ,
 which is interpreted as an extended regular expression.  which is interpreted as an extended regular expression.
 The matching line will be the first line of the next output file.  The matching line will be the first line of the next output file.
   This option is incompatible with the
   .Fl b
   and
   .Fl l
   options.
 .El  .El
 .Pp  .Pp
 If  If
Line 96 
Line 109 
 it is used as a prefix  it is used as a prefix
 for the names of the files into which the file is split.  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  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  prefix followed by a lexically ordered suffix using
 .Dq aa-zz .  .Ar suffix_length
   characters in the range
   .Dq a-z .
   .Pp
 If the  If the
 .Ar name  .Ar name
 argument is not specified, the file is split into lexically ordered  argument is not specified, the file is split into lexically ordered
 files named in the range of  files named with the prefixes
 .Dq xaa-zzz .  .Dq x ,
   .Dq y ,
   and
   .Dq z .
 .Sh SEE ALSO  .Sh SEE ALSO
 .Xr re_format 7  .Xr re_format 7
   .Sh STANDARDS
   The
   .Nm
   utility is compliant with the
   .St -p1003.1-2004
   specification.
   .Pp
   The use of
   .Dq y
   and
   .Dq z
   prefixes (in addition to the standard
   .Dq x )
   in the absence of a
   .Ar name
   parameter is an
   .Ox
   extension.
 .Sh HISTORY  .Sh HISTORY
 A  A
 .Nm  .Nm
 command appeared in  command appeared in
 .At v3 .  .At v3 .
 .Sh BUGS  .Sh BUGS
 For historical reasons, if you specify  
 .Ar name ,  
 .Nm  
 can only create 676 separate  
 files.  
 The default naming convention allows 2028 separate files.  
 .Pp  
 The maximum line length for matching patterns is 65536.  The maximum line length for matching patterns is 65536.
Legend:
Removed from v.1.11  
changed lines
  Added in v.1.12