DataMuseum.dk

top - metrics - download

    Length: 1739 (0x6cb)
    Types: TextFile
    Names: »dviconcat.tex«

└─⟦52210d11f⟧ Bits:30007239 EUUGD2: TeX 3 1992-12
    └─⟦af5ba6c8e⟧ »unix3.0/DVIWARE.tar.Z« 
        └─⟦ca79c7339⟧ 
            └─⟦this⟧ »DVIware/laser-setters/mctex/doc/dviconcat.tex« 

TextFile

\subsection{The \dviconcat\ program}%\label{sec:dviconcat}
The \dviconcat\ program
is the inverse of \dviselect:
It concatenates several separate \dvi\ files
to produce a single output file.
The two programs together
have the capacity to re-order the pages of a single \dvi\ file.
Using \dviconcat\ instead of several invocations
of a single \dvi\ driver
may save on header pages,
or make collation easier.
As a special case,
\dviconcat\ can also be used
to alter the magnification of a single \dvi\ file.

The program is invoked as:
\begin{quote}
{\tt dviconcat}
[{\tt -m} {\it magnification\/}]
[{\tt -o} {\it outfile\/}]
{\it list of files}
\end{quote}
If no {\it files\/} are named,
\dviconcat\ reads its standard input;
if no {\it outfile\/} is given,
\dviconcat\ writes its standard output.
The special file name `{\tt -}'
also refers to standard input.

By default, the magnification in the output file
is the same as that of the first input file.
The {\tt -m} option will override this.
If the magnifications of any of the other input files
do not match that of the first,
\dviconcat\ will print a warning.\footnote
{Thus, {\tt dviconcat -m -1 <file.dvi >/dev/null} will tell you
the current magnification of the file,
since no proper \dvi\ file
ever has a negative magnification.}

If any of the \dvi\ files being read
were not produced by \TeX\ or \LaTeX,
and for some reason use different `numerator' or `denominator' values
(these affect the way \dvi\ arithmetic is done),
\dviconcat\ will refuse to concatenate them.

This program would have been called {\tt dvicat},
but that name was already taken.
({\tt Dvicat} produces output for the
Graphics Systems C/A/T phototypesetter,
the same one the original {\tt troff} drives.)