@dircategory Text Utilities * dvidvi: (dvidvi). Convert DVI-file into another DVI-file

@parskip=0.75em

@title{DviDvi} @subtitle{A dvi file converter} @subtitle{} @subtitle{Version 1.1} @author{Thomas Rockicki} DviDvi converts a DVI-file into another DVI-file. This is version 1.1, author Thomas Rockicki, Amiga-Port (better: PasTeX-Port) Thomas Baetzler and Jochen Wiedmann. Copyright (C) 1988-91, Radical Eye Software

Here's a little hack I threw together for those doing pagination tricks. The dvidvi program converts a DVI file into another DVI file, with perhaps certain changes.

Enjoy; this is an early release, so make suggestions, improvements, and I'll get back to you with a better version later.

1. Parameters, options and arguments

Invocation is

    `dvidvi param infile outfile'

What are the parameters? The 'easy' parameters are the following:

-f n

page n is first page selected

-l n

page n is last page selected

-n n

select at most n pages. Notice that n is the number of pages selected, independently of the number of pages actually contained in a sheet

-i { n1..n2 | n1 }[,...]

include pages (ranges allowed). When this option is used, ONLY the specified pages are selected. However, we can exclude from these pages with the option -x.

-x { n1..n2 | n1 }[,...]

exclude pages (ranges allowed)

-q

work in quiet mode, that is do not print in the screen messages of how the work is being done.

-r

reverse the order of the pages.

-sm m

Scale the magnification. (Magnification is multiplied by magstep(m)).

-sh m

Scale the document-height. (Height is multiplied by magstep(m)).

-sw m

Scale the document-width. (Width is multiplied by magstep(m)).

The page numbers for the above options -f, -l, -i and -x can be specified in different ways.

1. If a number n is given, it is interpreted as the n'th page from the begining of the .dvi file. Of course, this number is independent of the page number assigned by TeX.
2. TeX page numbers are those who are actually written in the page; these page numbers can be modified, for example, by using the TeX commands `\pagenumbering', `\setcounter{page}{n}', and `\addtocounter{page}{n}'. A TeX page number can be specified by preceding the number n with the character . Thus, if you specify `-f @25 -l @30' you select the pages between 25 and 30, these numbers being those assigned by TeX.
3. However, several pages can have the same TeX page number in a .dvi file. For example, the introductory pages in a book are numbered i, ii, and so on until the first chapter begins and then, the pages are numbered 1, 2, etc. In this case, the pages numbered i and 1 in the .dvi file have the same TeX page number. If you want to select for example the second occurrence of the page numbered 1, you can specify a page number as `(@2)1'. Thus `@1' is equivalent to `(@1)1'. For example, if you specify `-f (@2)1 -l(@2)10' you select the pages between 1 and 10 of the first chapter, not the introductory pages between i and x.

There is another parameter that tells DviDvi how you want to change page layout and specifications. But this parameter is somewhat complicated and therefore explained in a special section. See section 2. the `-m'-parameter.

Go to the first, previous, next, last section, table of contents.