Provided by: texlive-base_2009-15_all bug

NAME

       dvipdfm - Produce PDF files directly from DVI files

SYNOPSIS

       dvipdfm [options] file[.dvi]

DESCRIPTION

       The program dvipdfm generates a PDF file from a DVI file.  DVI files are the output format
       produced by TeX.  Output from groff can be converted to DVI format using grodvi.

       The program  dvipdfm  recognizes  several  commonly  used  \special  commands,  which  are
       extensions  to  the  DVI  format.   Specifically, it understands color specials, papersize
       specials, tpic specials (which allow it to be used with pic), hypertex specials, and  some
       PostScript  specials.   These  extensions  allow  documents to contain color, figures, and
       hyperlinks.  The program tries to mimic the behavior of dvips so that many macro  packages
       produced  for use with dvips will work with dvipdfm.  Dvipdfm understands its own specific
       \special commands to allow access to PDF features such as annotations and bookmarks.   For
       more details, consult the Dvipdfm User's Manual, which is distributed with dvipdfm.

OPTIONS

       -c   Ignore  color  \specials.   The  -c  toggles  a  flag  that  disables  color \special
            processing.  Unless changed in the configuration file, that flag is  off,  and  color
            \specials are interpreted normally.  The -c option may be used to produce a black and
            white document from a document containing color TeX \special commands.

       -d   Remove  thumbnail  images  after  including  them.   (See  the  -t  option  for  more
            information.)

       -e   Toggle partial font embedding flag.  If partial font embedding is off, embedded fonts
            are fully embedded.  The default, if not changed in the  configuration  file,  is  to
            embed only those glyphs actually used in the document.

       -f map_file
            Set  the  name  of the font map file to map_file.  The format of the font map file is
            documented in the Dvipdfm User's Manual.

       -l   Select landscape mode.  In other words, exchange the x and y dimensions of the paper.

       -m  mag
            Magnify the input document by mag.

       -o  name
            Generate PDF output file having the name name.  By default, the name  of  the  output
            file is file.pdf.

       -p  paper
            Select the papersize by name (e.g., letter, legal, ledger, tabloid, a3, a4, or a5 )

       -r  size
            Set  resolution  of  bitmapped  fonts  to  size  dots  per inch.  Bitmapped fonts are
            generated by the Kpathsea library, which uses MetaFont.  Bitmapped fonts are included
            as type 3 fonts in the PDF output file.

       -s  page_specifications
            Select  the  pages of the DVI file to be converted.  The page_specifications consists
            of a comma separated list of page_ranges:

            page_specifications := page_specification[,page_specifications]

            where

            page_specification := single_page|page_range

            page_range := [first_page]-[last_page]

            An empty first_page is implied to be the first  page  of  the  DVI  file.   An  empty
            last_page is treated as the last page of the DVI file.

            Examples:

            -s 1,3,5
                 includes pages 1, 3, and 5;

            -s - includes all pages;

            -s -,-
                 includes two copies of all pages in the DVI file; and

            -s 1-10
                 includes the first ten pages of the DVI file.

       -t   Search  for  thumbnail  images  of  each  page  in  the directory named by the TMPDIR
            environment variable.  The thumbnail images must be named in a specific format.  They
            must  have  the  same base name as the DVI file and they must have the page number as
            the extension to the file name.  Dvipdfm does not generate the thumbnails itself, but
            it is distributed with a wrapper program named dvipdft that does so.

       -v   Increase  verbosity.   Results of the -v option are cumulative (e.g., -vv ) increases
            the verbosity by two increments.

       -x x_offset
            Set the left margin to x_offset.  The default left margin is  1.0in.   The  dimension
            may be specified in any units understood by TeX (e.g., bpt, pt, in, cm )

       -y y_offset
            Set  the top margin to y_offset.  The default top margin is 1.0in.  The dimension may
            be specified in any units understood by TeX (e.g., bpt, pt, in, cm )

       -z compression_level
            Set the compression level to compression_level.  Compressions levels range from 0 (no
            compression)  to  9  (maximum compression) and correspond to the values understood by
            zlib.

ENVIRONMENT

       Dvipdfm uses the kpathsea library for locating  the  files  that  it  opens.   Hence,  the
       environment variables documented in the Kpathsea library documentation influence dvipdfm.

       Dvipdfm also reads the following environment variables:

       TMP  The directory to search for thumbnail images of each page.

FILES

       The  precise  location  of  the  following  files  is  determined  by the Kpathsea library
       configuration.  The location may be determined by using kpsewhich, e.g.,
       kpsewhich -progname=dvipdfm -format='other text files' config

       config
            Startup options

       t1fonts.map
            The default font map file (this name may be changed in the config file).

       *.tfm
            TeX font metrics

       *.vf TeX virtual font files

       *.pfb
            PostScript Type 1 font files

       texmf.cnf
            The Kpathsea library configuration file.  The location of this file may be  found  by
            typing
            kpsewhich texmf.cnf

SEE ALSO

       tex(1),   dvips(1),   groff(1),   grodvi(1),   pic(1),   and  the  Kpathsea  library  info
       documentation.

AUTHOR

       Mark A. Wicks <mwicks@kettering.edu>

                                            5/28/2001                                  dvipdfm(1)