NAME

       coq-tex - Process Coq phrases embedded in LaTeX files

SYNOPSIS

       coq-tex  [ -o output-file ] [ -n line-width ] [ -image coq-image ] [ -w ] [ -v ] [ -sl ] [
       -hrule ] [ -small ] input-file ...

DESCRIPTION

       The coq-tex filter extracts Coq phrases embedded  in  LaTeX  files,  evaluates  them,  and
       insert the outcome of the evaluation after each phrase.

       Three LaTeX environments are provided to include Coq code in the input files:

       coq_example
              The  phrases  between  \begin{coq_example}  and \end{coq_example} are evaluated and
              copied into the output file. Each  phrase  is  followed  by  the  response  of  the
              toplevel loop.

       coq_example*
              The  phrases  between \begin{coq_example*} and \end{coq_example*} are evaluated and
              copied into the output file. The responses of the toplevel loop are discarded.

       coq_eval
              The phrases between \begin{coq_eval} and  \end{coq_eval}  are  silently  evaluated.
              They  are  not  copied into the output file, and the responses of the toplevel loop
              are discarded.

       The resulting LaTeX code is stored in the file file.v.tex if the input file has a name  of
       the  form  file.tex,  otherwise  the name of the output file is the name of the input file
       with `.v.tex' appended.

       The files produced by coq-tex can be directly processed by LaTeX.  Both  the  Coq  phrases
       and the toplevel output are typeset in typewriter font.

OPTIONS

       -o output-file
              Specify  the  name  of  a  file  where the LaTeX output is to be stored. A dash `-'
              causes the LaTeX output to be printed on standard output.

       -n line-width
              Set the line width. The default is 72 characters. The  responses  of  the  toplevel
              loop  are folded if they are longer than the line width. No folding is performed on
              the Coq input text.

       -image coq-image
              Cause the file coq-image to be executed to evaluate the Coq  phrases.  By  default,
              this  is  the  command coqtop without specifying any path which is used to evaluate
              the Coq phrases.

       -w     Cause lines to be folded on a space character whenever possible, avoiding word cuts
              in  the  output.  By  default, folding occurs at the line width, regardless of word
              cuts.

       -v     Verbose mode. Prints the Coq answers on the  standard  output.   Useful  to  detect
              errors in Coq phrases.

       -sl    Slanted mode. The Coq answers are written in a slanted font.

       -hrule Horizontal lines mode. The Coq parts are written between two horizontal lines.

       -small Small font mode. The Coq parts are written in a smaller font.

CAVEATS

       The  \begin...  and  \end...  phrases must sit on a line by themselves, with no characters
       before the backslash or after the closing brace.  Each Coq phrase must  be  terminated  by
       `.'  at  the  end of a line.  Blank space is accepted between `.' and the newline, but any
       other character will cause coq-tex to ignore the  end  of  the  phrase,  resulting  in  an
       incorrect shuffling of the responses into the phrases.  (The responses ``lag behind''.)

SEE ALSO

       coqtop (1).

                                          29 March 1995                                COQ-TEX(1)