


DVIDVI(L)                                               DVIDVI(L)


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

SSYYNNOOPPSSIISS
       dvidvi [param] infile outfile

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

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

   PPaarraammeetteerrss
       -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 num-
           ber 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 num-
           ber  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 num-
           bered 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  occur-
           rence  of  the page numbered 1, you can specify a page



                            March 1994                          1





DVIDVI(L)                                               DVIDVI(L)


           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 pre-
           cedes the number, then the page is taken from the mir-
           ror 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.

EEXXAAMMPPLLEESS
       -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 sec-
                 ond.  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.



                            March 1994                          2





DVIDVI(L)                                               DVIDVI(L)


       -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                          3


