DSPLIT(1)

NAME
dsplit - split troff output into segments

SYNOPSIS
dsplit [ options []] [ file []]

DESCRIPTION
dsplit splits troff output files into small, self-contained pieces. Breaks always occur at page boundaries, and are only forced when the specified number of pages or bytes in the current segment has been exceeded. Standard input is used if file is omitted. The following options are recognized:

[-p num]
Segmentation by pages.
    Split output into segments consisting of no more than num pages (default is 20).

    [-b num]
Segmentation by bytes.
    Complete current page in segment when there are more than num bytes (default 100,000) in the current segment. The next segment will begin with the next new page.

    [-f name]
Use name as the pathname prefix for the different segments. The default is dsplit.out(.) Consecutive integers, starting at 01, are appended to name to produce the name of the file used for the next segment.

    [-r]
Report the name of the file containing the segment
    just completed.

    [-s string]
Separate each segment with a line containing
    string (default is NULL). This option is only used if writing to standard output, and is automatically disabled if the option is used.

EXAMPLES
If file contains the output from a large troff run (say 144 pages), the command
    dsplit -p50 -fpart troff.out
splits the file into 50-page segments; the first 50 pages, the second 50 pages, and the remaining pages are contained in files part01(,) part02(,) and part03(,) respectively.

SEE ALSO
troff(1), troff(5)