Name

DVISel - select pages or ranges of pages from a DVI file

Synopsis

dvisel [-v] [-q] [-e] [-o] [-r] [-c count] [-p range]... [[in.dvi] out.dvi]

Description

DVISel selects pages and ranges of pages from a DVI file.

Page ranges are primarily selected with the -p range option; this specifies a single page number, or a range in the form low:high or low-high. Negative numbers can be prefixed by an underscore (_), which are then interpreted relative to the end of the file. The pages are written out in the order that they are specified on the command line. If no page range is given, all pages are selected.

The -e or -o options restrict the pages written out to the even (or odd) subset of the page ranges. The -r option writes the pages out in reverse order.

The -c option is not yet implemented; it will allow the page ranges to apply to the values of one of TeX's page counters.

If no output file is specified on the command line, the output is written to the standard output. If no input file is specified on the command line, the input is read from the standard input.

Examples

To select the last page in a file, and then the remaining pages, the following command can be used:

dvisel _1,1:_2 input.dvi output.dvi

This is useful for moving the table of contents from TeX info documents to the front of the document.

Since all pages are selected if no page range is given, the even pages can be selected by:

dvisel -e input.dvi even.dvi

Double-sided printing can be achieved on some printers by feeding the resulting paper back through the printer, and printing the odd sides in reverse:

dvisel -r -o input.dvi odd.dvi

Last modified on 12th February 2004 by angus@harlequin.co.uk