COQ-TEX(1) General Commands Manual COQ-TEX(1)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 egin{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 egin{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 egin{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 out-
put 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 out-
put.
-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 egin... 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 charac-
ter 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)
Check Out this Related Man Page
DETEX(1L)DETEX(1L)NAME
detex - a filter to strip TeX commands from a .tex file.
SYNOPSIS
detex [ -clnstw ] [ -e environment-list ] [ filename[.tex] ... ]
DESCRIPTION
Detex (Version 2.6) reads each file in sequence, removes all comments and TeX control sequences and writes the remainder on the standard
output. All text in math mode and display mode is removed. By default, detex follows input commands. If a file cannot be opened, a
warning message is printed and the command is ignored. If the -n option is used, no input or include commands will be processed. This
allows single file processing. If no input file is given on the command line, detex reads from standard input.
If the magic sequence ``egin{document}'' appears in the text, detex assumes it is dealing with LaTeX source and detex recognizes addi-
tional constructs used in LaTeX. These include the include and includeonly commands. The -l option can be used to force LaTeX mode and
the -t option can be used to force TeX mode regardless of input content.
Text in various environment modes of LaTeX is ignored. The default modes are array, eqnarray, equation, figure, mathmatica, picture, table
and verbatim. The -e option can be used to specify a comma separated environment-list of environments to ignore. The list replaces the
defaults so specifying an empty list effectively causes no environments to be ignored.
The -c option can be used in LaTeX mode to have detex echo the arguments to cite,
ef, and pageref macros. This can be useful when
sending the output to a style checker.
Detex assumes the standard character classes are being used for TeX. Detex allows white space between control sequences and magic charac-
ters like `{' when recognizing things like LaTeX environments.
If the -w flag is given, the output is a word list, one `word' (string of two or more letters and apostrophes beginning with a letter) per
line, and all other characters ignored. Without -w the output follows the original, with the deletions mentioned above. Newline charac-
ters are preserved where possible so that the lines of output match the input as closely as possible.
The TEXINPUTS environment variable is used to find input and include files. Like TeX, it interprets a leading or trailing `:' as the
default TEXINPUTS. It does not support the `//' directory expansion magic sequence.
Detex now handles the basic TeX ligatures as a special case, replacing the ligatures with acceptable charater substitutes. This eliminates
spelling errors introduced by merely removing them. The ligatures are aa, ae, oe, ss, o, l (and their upper-case equivalents). The
special "dotless" characters i and j are also replaced with i and j respectively.
Note that previous versions of detex would replace control sequences with a space character to prevent words from running together. How-
ever, this caused accents in the middle of words to break words, generating "spelling errors" that were not desirable. Therefore, the new
version merely removes these accents. The old functionality can be essentially duplicated by using the -s option.
SEE ALSO tex(1L)DIAGNOSTICS
Nesting of input is allowed but the number of opened files must not exceed the system's limit on the number of simultaneously opened
files. Detex ignores unrecognized option characters after printing a warning message.
AUTHOR
Daniel Trinkle, Computer Science Department, Purdue University
BUGS
Detex is not a complete TeX interpreter, so it can be confused by some constructs. Most errors result in too much rather than too little
output.
Running LaTeX source without a ``egin{document}'' through detex may produce errors.
Suggestions for improvements are (mildly) encouraged.
Purdue University 12 August 1993 DETEX(1L)