


DVISELECT(1)                                         DVISELECT(1)


NNAAMMEE
       dviselect - extract pages from DVI files

SSYYNNOOPPSSIISS
       ddvviisseelleecctt  [  --ss  ]  [  --ii _i_n_f_i_l_e ] [ --oo _o_u_t_f_i_l_e ] _l_i_s_t _o_f
       _p_a_g_e_s [ _i_n_f_i_l_e [ _o_u_t_f_i_l_e ] ]

DDEESSCCRRIIPPTTIIOONN
       _D_v_i_s_e_l_e_c_t selects pages from a DVI file produced  by  TeX,
       creating  a  new DVI file usable by any of the TeX conver-
       sion programs, or even by _d_v_i_s_e_l_e_c_t itself.

       A _r_a_n_g_e is a string of the form _e_v_e_n, _o_d_d,  or  _f_i_r_s_t_:_l_a_s_t
       where  both  _f_i_r_s_t  and _l_a_s_t are optional numeric strings,
       with negative numbers indicated by  a  leading  underscore
       character  ``_''.  If both _f_i_r_s_t and _l_a_s_t are omitted, the
       colon may also be omitted, or  may  be  replaced  with  an
       asterisk  ``*''.   A  _p_a_g_e _r_a_n_g_e is a list of ranges sepa-
       rated by periods.  A _l_i_s_t _o_f _p_a_g_e_s is described by  a  set
       of page ranges separated by commas and/or white space.

       _D_v_i_s_e_l_e_c_t  actually  looks at the ten _c_o_u_n_t variables that
       TeX writes; the first of these (\count0) is the page  num-
       ber,  with  \count1  through  \count9  having  varied uses
       depending on which macro packages are in use.   (Typically
       \count1  might be a chapter or section number.)  A page is
       included in _d_v_i_s_e_l_e_c_t's output if all  its  \count  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.

       Instead  of  \count  values,  _d_v_i_s_e_l_e_c_t 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 nega-
       tive absolute page numbers.  Even/odd specifiers, however,
       are  legal;  ``dviselect =even'' selects every other page,
       starting with the second.

       More precisely, an asterisk or an empty string implies  no
       limit;  an  equal  sign  means absolute page number rather
       than \counts; a leading colon means everything up  to  and
       including   the   given   page;  a  trailing  colon  means



                                                                1





DVISELECT(1)                                         DVISELECT(1)


       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 \count should be examined.  If fewer than 10
       ranges are specified, the remaining \counts are left unre-
       stricted  (that is, ``1:5'' and ``1:5.*'' are equivalent).
       A single number _n is treated as if it were the range  _n_:_n.
       An  arbitrary number of page selectors may be given, sepa-
       rated by commas or whitespace; a page is selected  if  any
       of the selectors matches its \counts or absolute page num-
       ber.

       Dviselect normally prints the page numbers  of  the  pages
       selected; the _-_s option suppresses this.

AAUUTTHHOORR
       Chris Torek, University of Maryland

SSEEEE AALLSSOO
       dviconcat(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

BBUUGGSS
       A  leading ``-'' ought to be allowed for negative numbers,
       but it is currently used as a synonym for ``:'', for back-
       wards compatibility.

       Section  or  subsection selection will sometimes fail, for
       the DVI file lists only the \count values that were active
       when  the page ended.  Clever macro packages can alleviate
       this by making use of  other  ``free''  \count  registers.
       Chapters  normally  begin  on new pages, and do not suffer
       from this particular problem.

       The heuristic that decides which arguments are page selec-
       tors and which are file names is often wrong.  Using shell
       redirection or the -i and -o options is safest.

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













                                                                2


