


DVITODVI(1)                                           DVITODVI(1)


NNAAMMEE
       dvitodvi - rearrange pages in a DVI file

SSYYNNOOPPSSIISS
       ddvviittooddvvii [ --qq ] [ --ii _i_n_f_i_l_e ] [ --oo _o_u_t_f_i_l_e ] [ --ww_w_i_d_t_h ] [
       --hh_h_e_i_g_h_t ] _p_a_g_e_s_p_e_c_s [ _i_n_f_i_l_e [ _o_u_t_f_i_l_e ] ]

DDEESSCCRRIIPPTTIIOONN
       _D_v_i_t_o_d_v_i rearranges pages from a DVI file, creating a  new
       DVI  file.  _D_v_i_t_o_d_v_i can be used to perform a large number
       of  arbitrary  re-arrangements  of  Documents,   including
       arranging  for  printing  2-up, 4-up, booklets, reversing,
       selecting front or back sides of documents, scaling,  etc.

       _p_a_g_e_s_p_e_c_s follow the syntax:

              _p_a_g_e_s_p_e_c_s   _= _[_m_o_d_u_l_o_:_]_[_m_a_g_@_]_s_p_e_c_s

              _s_p_e_c_s       _= _s_p_e_c_[_+_s_p_e_c_s_]_[_,_s_p_e_c_s_]

              _s_p_e_c        _= _[_-_]_p_a_g_e_n_o_[_(_x_o_f_f_,_y_o_f_f_)_]

       _m_o_d_u_l_o  is the number of pages in each block. The value of
       _m_o_d_u_l_o should be greater than 0; the default value  is  1.
       The  optional  _m_a_g parameter adjusts the file's magnifica-
       tion by the magnification specified. The magnification and
       modulo  can  be  specified  in  reverse  order if desired.
       _s_p_e_c_s are the page specifications for the  pages  in  each
       block.  The  value  of  the  _p_a_g_e_n_o in each _s_p_e_c should be
       between 0 (for the first page in the block)  and  _m_o_d_u_l_o-1
       (for the last page in each block) inclusive.  The optional
       dimensions _x_o_f_f and _y_o_f_f shift the page by  the  specified
       (positive)  amount.   _x_o_f_f  and  _y_o_f_f  are in PostScript's
       points, but may be followed by the units ccmm or iinn to  con-
       vert to centimetres or inches, or the flag ww or hh to spec-
       ify as a multiple of the width or height.  If the optional
       minus  sign  is specified, the page is relative to the end
       of the document, instead of the start.

       If page _s_p_e_cs are separated by ++ the pages will be  merged
       into  one  page; if they are separated by  they will be on
       separate pages.  If there is only one page  specification,
       with _p_a_g_e_n_o zero, the _p_a_g_e_n_o may be omitted.

       The  _-_w  option  gives  the  width  which is used by the ww
       dimension specifier, and the _-_h option  gives  the  height
       which  is  used by the hh dimension specifier. These dimen-
       sions are also used (after scaling) to  set  the  clipping
       path for each page.

       Dvitodvi normally prints the page numbers of the pages re-
       arranged; the _-_q option suppresses this.





                                                                1





DVITODVI(1)                                           DVITODVI(1)


EEXXAAMMPPLLEESS
       This section contains some sample re-arrangements. To  put
       two pages on one sheet (of landscaped A3 paper), the page-
       spec to use is:

                             2:0+1(21cm,0)

       To reduce an A3 page to A4 size, the pagespec to use is:

                           700@(-.3in,-.3in)

       To select all of the odd pages in reverse order, use:

                                  2:-0


AAUUTTHHOORR
       Angus Duggan, from dviselect(1), by Chris  Torek,  Univer-
       sity of Maryland

SSEEEE AALLSSOO
       dviconcat(1), dvibook(1), dviselect(1), latex(1), tex(1)
       _M_C_-_T_e_X _U_s_e_r_'_s _G_u_i_d_e
       _T_h_e  _T_e_X_b_o_o_k  _D_v_i_t_o_d_v_i does not adjust some of the parame-
       ters in the postamble. The may be a problem if these  val-
       ues are used to size certain structures in the output con-
       version programs.






























                                                                2


