summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1/dviselect.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf/doc/man/man1/dviselect.1')
-rw-r--r--Master/texmf/doc/man/man1/dviselect.1131
1 files changed, 0 insertions, 131 deletions
diff --git a/Master/texmf/doc/man/man1/dviselect.1 b/Master/texmf/doc/man/man1/dviselect.1
deleted file mode 100644
index 735cacd0ba7..00000000000
--- a/Master/texmf/doc/man/man1/dviselect.1
+++ /dev/null
@@ -1,131 +0,0 @@
-.\" Copyright (c) 1987-2012 UMD-CS, released under the X11 license;
-.\" see README and source files.
-.TH DVISELECT 1
-.SH NAME
-dviselect \- extract pages from DVI files
-.SH SYNOPSIS
-.B dviselect
-[
-.B \-s
-] [
-.B \-i
-.I infile
-] [
-.B \-o
-.I outfile
-]
-.I "list of pages"
-[
-.I infile
-[
-.I outfile
-] ]
-.SH DESCRIPTION
-.I Dviselect
-selects pages from a DVI file produced by TeX,
-creating a new DVI file
-usable by any of the TeX conversion programs,
-or even by
-.I dviselect
-itself.
-.PP
-A
-.I range
-is a string of the form
-.IR even ,
-.IR odd ,
-or
-.I first:last
-where both
-.I first
-and
-.I last
-are optional numeric strings, with negative numbers indicated by
-a leading underscore character ``_''. If both
-.I first
-and
-.I last
-are omitted, the colon may also be omitted, or may be replaced
-with an asterisk ``*''. A
-.I page range
-is a list of ranges separated by periods. A
-.I "list of pages"
-is described by a set of page ranges separated by commas and/or white space.
-.PP
-.I Dviselect
-actually looks at the ten
-.I count
-variables that TeX writes; the first of these (\ecount0) is the
-page number, with \ecount1 through \ecount9 having varied uses
-depending on which macro packages are in use. (Typically \ecount1
-might be a chapter or section number.) A page is included in
-.IR dviselect 's
-output if all its \ecount values match any one of the ranges
-listed on the command line. For example, the command
-``dviselect *.1,35:''
-might select everything in chapter 1, as well as pages 35 and up.
-``dviselect 10:30'' would select pages 10 through 30 (inclusive).
-``:43'' means everything up to and including page 43 (including
-negative-numbered pages).
-To get all even-numbered pages, use ``even'';
-to get all odd-numbered pages, use ``odd''.
-If a Table of Contents has negative page numbers, ``:_1'' will select it.
-Note that ``*'' must be quoted from the shell;
-the empty string is more convenient to use, if harder to read.
-.PP
-Instead of \ecount values,
-.I dviselect
-can also select by ``absolute page number'', where the first page
-is page 1, the second page 2, and so forth. Absolute page numbers
-are indicated by a leading equal sign ``=''. Ranges of absolute
-pages are also allowed: ``dviselect =3:7'' will extract the third
-through seventh pages. Dot separators are not legal in absolute
-ranges, and there are no negative absolute page numbers.
-Even/odd specifiers, however, are legal;
-``dviselect =even'' selects every other page,
-starting with the second.
-.PP
-More precisely, an asterisk or an empty string implies no limit;
-an equal sign means absolute page number rather than \ecounts;
-a leading colon means everything up to and including the given page; a
-trailing colon means everything from the given page on;
-the word ``even'' means only even values shall be accepted;
-the word ``odd'' means only odd values shall be accepted; and
-a period indicates that the next \ecount should be examined.
-If fewer than 10 ranges are specified, the remaining \ecounts
-are left unrestricted (that is, ``1:5'' and ``1:5.*'' are equivalent).
-A single number \fIn\fP is treated as if it were the range \fIn:n\fP.
-An arbitrary number of page selectors may be given, separated by commas
-or whitespace; a page is selected if any of the selectors matches
-its \ecounts or absolute page number.
-.PP
-Dviselect normally prints the page numbers of the pages selected; the
-.I \-s
-option suppresses this.
-.SH AUTHOR
-Chris Torek, University of Maryland
-.SH "SEE ALSO"
-dviconcat(1), latex(1), tex(1)
-.br
-.I "MC-TeX User's Guide"
-.br
-.I "The TeXbook"
-.SH BUGS
-A leading ``-'' ought to be allowed for negative numbers, but it
-is currently used as a synonym for ``:'', for backwards compatibility.
-.PP
-Section or subsection selection will sometimes fail, for the DVI
-file lists only the \ecount values that were active when the page
-ended. Clever macro packages can alleviate this by making use of
-other ``free'' \ecount registers. Chapters normally begin on new
-pages, and do not suffer from this particular problem.
-.PP
-The heuristic that decides which arguments are page selectors
-and which are file names is often wrong.
-Using shell redirection or the \-i and \-o options is safest.
-.PP
-.I Dviselect
-does not adjust the parameters in the postamble; however, since these
-values are normally used only to size certain structures in the output
-conversion programs, and the parameters never need to be adjusted upward,
-this has not proven to be a problem.