NAME

       dvidvi - selects and/or re-arranges pages in a TeX dvi file

SYNOPSIS

       dvidvi [param] infile outfile

DESCRIPTION

   Copyright
       dvidvi 1.0, Copyright (C) 1988-91, Radical Eye Software

   Introduction
       The  dvidvi  program  converts  a  dvi  file  into  another dvi file, with perhaps certain
       changes.

   Parameters
       -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.

       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.  This is the -m parameter.
       *   The number preceding the colon is the modulo value.  Everything will be done in chunks
           of pages this big.  If there is no colon, than the default value is assumed to be one.
           The last chunk of pages is padded with as many blank pages as necessary.
       *   Following the colon is a comma-separated list of page numbers.  These page numbers are
           with  respect  to  the  current  chunk of pages, and must lie in the range zero to the
           modulo value less one.  If a negative sign precedes the number, then the page is taken
           from  the mirror chunk; if there are m chunks, then the mirror chunk of chunk n is the
           chunk numbered m-n-1.  Put simply, it is the chunk numbered the same,  only  from  the
           end.   This  can  be  used  to  reverse pages.  If no number is given, the page number
           defaults to 1.
       *   Following each page number is an optional offset value in parenthesis, which  consists
           of  a  pair of comma-separated dimensions.  Each dimension is a decimal number with an
           optional unit of measure.  The default unit of measure is inches, or the last unit  of
           measure  used.   All units are in true dimensions.  Allowable units of measure are the
           same that TeX allows: in, mm, cm, pt, pc, dd, and cc.

EXAMPLES

       -m -      Reverses the order of the pages.  This time, both the modulo and the page number
                 are defaulted.
       -m 2:0    Selects the first, third, fifth, etc. pages from the file.  Print this one after
                 printing the next, taking the paper out of the feed tray and reinserting it into
                 the paper feed.
       -m 2:-1   Selects the second, fourth, etc. pages, and writes them in reverse order.
       -m 4:-1,2(4.25in,0in)
       -m 4:-3,0(4.25in,0in)
                 Useful  for  printing a little booklet, four pages to a sheet, double-sided, for
                 stapling in the middle.  Print the first  one,  put  the  stack  back  into  the
                 printer  upside  down,  and  print  the  second.   The  `in'  specifications are
                 superfluous.
       -m ,(1pt,1)
                 Scare your system administrator!  Actually,  things  are  so  blurry  with  this
                 option, you may want to send enemies letters printed like this.  *Long* letters.
       -m 4:0(5.5in,4.25),3(0,4.25)
       -m 4:1(0in,4.25),2(5.5,4.25)
                 Print  a  four-page  card  on  one sheet.  Print the first, rotate the paper 180
                 degrees and feed  it  again.   (PostScript  people  can  do  funny  tricks  with
                 PostScript so this isn't necessary.)

                                            March 1994                                  DVIDVI(1)