Man Linux: Main Page and Category List

## 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