\documentclass{article}
\begin{document}

\title{Dvispell and Dvistatc\\a simple package for checking orthography\\in
western European languages}
\author{Daniel Taupin\\{\tt taupin@lps.u-psud.fr}}
\date{20 october 2001}

\maketitle

\section*{Introduction}
\subsection*{The purpose}
Programs {\tt dvispell} and {\tt dvistatc} are designed to be of very safe and
simple use. They are {\slshape\bfseries not supposed to correct your texts}
--- a job which appears to be seriously tricky when you write out of the
standard basic language --- but only to give yo a list of words which are
{\slshape\bfseries not in your dictionary} of known words.

Once you have got that information, you are supposed to be clever enough to
correct or accept these words. Note that existing words (including plurals,
feminine versions and conjugations) only are checked, and that this package
make no control of grammatical coherence.

\subsection*{{\ttfamily dvispell}}
 This is a standard GCC version of Eberhardt Mattes initial program. Provided
by Kinga Izdebska, a student Prof. Janusz S. Bie\'n (Univ. Warshaw) ({\tt
jsbien@mimuw.edu.pl}) errors or missing features have been corrected by Daniel
Taupin (Orsay, France). Usage is the same as E. Mattes' and is shortly
explained executing it without arguments.

 For those who do no know, {\tt dvispell} translates a DVI file to text,
without formatting of attempt to format as {\tt dvi2txt} unfortunately does.
Thus, besides its use for spell checking, {\tt dvispell} is an excellent tool
to retrieve a \TeX/\LaTeX{} source from te DVI when the source has been lost.

\subsection*{{\ttfamily dvistatc}}
 This is the GCC version of a previous program written in Turbo Pascal, whose
conversion to C by P2C appeared to be bugged.

 It reads the output of {\tt dvispell} (with some specific options), builds a
table of all words it finds, removes all those which appear in the given
dictionary, and outputs the remaining ones, with number of occurences and
their page range.

\section*{Installation}
 Three distributions are [intended to be] provided.

\subsection*{Windows 9x/ME}

 The {\tt dvispell.zip} file is fit for EmTeX distribution.
In that case, under MSDOS window~:

 \begin{itemize}
 \item Set the current directory to EmTeX root, e.g. \verb|D:\emtex|
 \item \verb|pkunzip -d dvispell.zip|  (or \verb|unzip -d dvispell.zip| if you
have {\tt unzip})
 \end{itemize}
 That's all. Then, checking the orthography of a french DVI (e.g.
\verb|my-text.dvi|) is done by~:

 \smallskip
 \verb|ortograf my-text|

 \smallskip\noindent and the list is in {\tt my-text.wls}. Intermadiate text
file is in {\tt my-text.txt}. Note that you {\bfseries\slshape must edit} {\tt
ortograf.bat} to give the correct locations of all files and dictionaries.

 Remark: if you specify explicit paths to all files, no environment
specification is needed and you can get rid of many tricks...

 Important: {\slshape\bfseries backslashes} are required in the procedures to
specify the location of executables but, in command lines, {\slshape\bfseries
argument should use plain slashes} to specify paths to arguments.
 
 \medskip
 If you {\slshape\bfseries do not use EmTeX}, there is {\slshape\bfseries no
serious problem}. Just put {\tt orto*.bat} in {\bfseries\slshape your path}
and edit these procedures to specifiy the exact location of {\tt
dvispell.exe}, 
{\tt dvistatc.exe} and {\tt pc850.dsb}.
 
\subsection*{DJGPP}
 In the case you want to recompile {\tt dvispell}, {\tt dvisprep} or
{\tt dvistatc}, get {\tt dvispell.tar.gz} and {\tt dvistatc.tar.gz}. ``un-tar''
them with

 \smallskip
 \verb|tar -zxf dvispell.tar.gz|

 \verb|tar -zxf dvistats.tar.gz|

 \smallskip
 Go to \verb|./dvispell| directory, enter \verb|bash| (required, not plain
MSDOS!) and run

 \smallskip
 \verb|./configure|
 
 \verb|make|

 \smallskip
 This should compile {\tt dvispell} correctly.

 Go to \verb|./dvistats| directory and run
 
 \smallskip
 \verb|make|

 \smallskip
 In case of problems, just edit Makefile and try again.

\subsection*{Linux}
 In this case you have to recompile {\tt dvispell}, {\tt dvisprep} and {\tt
dvistatc}, get {\tt dvispell.tar.gz} and {\tt dvistatc.tar.gz}. ``un-tar''
them with

 \smallskip
 \verb|tar -zxf dvispell.tar.gz|

 \verb|tar -zxf dvistats.tar.gz|

 \smallskip
 Go to \verb|./dvispell| directory, 
and run

 \smallskip
 \verb|./configure|
 
 \verb|make|

 \smallskip
 This should compile {\tt dvispell} correctly.

 Go to \verb|./dvistats| directory and run
 
 \smallskip
 \verb|make|

 \smallskip
 In case of problems, just edit Makefile and try again.

 \medskip
 Remark: installation should be bone manually, since the \verb|make install|
are presently bugged.

 \end{document}
