mirror of
https://github.com/9fans/plan9port.git
synced 2025-01-12 11:10:07 +00:00
977b25a76a
The overloading of IR emits magic \X'...' sequences that turn into HTML manual links. But not all such IR invocations should be manual links; those had to be written to avoid the IR macro before. Worse, the \X'...' ending the IR causes troff to emit only a single space after a period. Defining a new IM macro for manual references fixes both problems. Fixes #441.
82 lines
1.1 KiB
Groff
82 lines
1.1 KiB
Groff
.TH SPLIT 1
|
|
.CT 1 files
|
|
.SH NAME
|
|
split \- split a file into pieces
|
|
.SH SYNOPSIS
|
|
.B split
|
|
[
|
|
.I option ...
|
|
]
|
|
[
|
|
.I file
|
|
]
|
|
.SH DESCRIPTION
|
|
.I Split
|
|
reads
|
|
.I file
|
|
(standard input by default)
|
|
and writes it in pieces of 1000
|
|
lines per output file.
|
|
The names of the
|
|
output files are
|
|
.BR xaa ,
|
|
.BR xab ,
|
|
and so on to
|
|
.BR xzz .
|
|
The options are
|
|
.TP
|
|
.BI -n " n"
|
|
Split into
|
|
.IR n -line
|
|
pieces.
|
|
.TP
|
|
.BI -l " n"
|
|
Synonym for
|
|
.B -n
|
|
.IR n ,
|
|
a nod to Unix's syntax.
|
|
.TP
|
|
.BI -e " expression"
|
|
File divisions occur at each line
|
|
that matches a regular
|
|
.IR expression ;
|
|
see
|
|
.IM regexp (7) .
|
|
Multiple
|
|
.B -e
|
|
options may appear.
|
|
If a subexpression of
|
|
.I expression
|
|
is contained in parentheses
|
|
.BR ( ... ) ,
|
|
the output file name is the portion of the
|
|
line which matches the subexpression.
|
|
.TP
|
|
.BI -f " stem
|
|
Use
|
|
.I stem
|
|
instead of
|
|
.B x
|
|
in output file names.
|
|
.TP
|
|
.BI -s " suffix
|
|
Append
|
|
.I suffix
|
|
to names identified under
|
|
.BR -e .
|
|
.TP
|
|
.B -x
|
|
Exclude the matched input line from the output file.
|
|
.TP
|
|
.B -i
|
|
Ignore case in option
|
|
.BR -e ;
|
|
force output file names (excluding the suffix)
|
|
to lower case.
|
|
.SH SOURCE
|
|
.B \*9/src/cmd/split.c
|
|
.SH SEE ALSO
|
|
.IR sed (1),
|
|
.IM awk (1) ,
|
|
.IM grep (1) ,
|
|
.IM regexp (7)
|