coqdoc1
Documentation tool for the coq proof assistant
Usage
coqdoc [options]
files
Overview
coqdoc is a documentation tool for the Coq proof assistant. It creates LaTeX or HTML documents from a set of Coq files. See the Coq reference manual for documentation (url below).
Options
Overall options
-
-h -
Help. Will give you the complete list of options accepted by
coqdoc.
-
--html -
Select a HTML output.
-
--latex -
Select a LaTeX output.
-
--dvi -
Select a DVI output.
-
--ps -
Select a PostScript output.
-
--texmacs -
Select a TeXmacs output.
-
--stdout -
Redirect the output to stdout
-ofile,--outputfile-
Redirect the output into the file file.
-ddir, --directory dir-
Output files into directory dir instead of current directory (option
-ddoes not change the filename specified with option-o, if any).
-
-s, --short -
Do not insert titles for the files. The default behavior is to insert a title like ``Library Foo'' for each file.
-tstring, --title string-
Set the document title.
-
--body-only -
Suppress the header and trailer of the final document. Thus, you can insert the resulting document into a larger one.
-pstring, --preamble string-
Insert some material in the LaTeX preamble, right before \begin{document} (meaningless with -html).
--vernac-filefile, --tex-file file-
Considers the file file respectively as a .v (or .g) file or a .tex file.
--files-fromfile-
Read file names to process in file file as if they were given on the command line. Useful for program sources split in several directories.
-
-q, --quiet -
Be quiet. Do not print anything except errors.
-
-h, --help -
Give a short summary of the options and exit.
-
-v, --version -
Print the version and exit.
Index options
Default behavior is to build an index, for the HTML output only, into index.html.
-
--no-index -
Do not output the index.
-
--multi-index -
Generate one page for each category and each letter in the index, together with a top page index.html.
Table of contents option
-
-toc, --table-of-contents -
Insert a table of contents. For a LaTeX output, it inserts a \tableofcontents at the beginning of the document. For a HTML output, it builds a table of contents into toc.html.
Hyperlinks options
--glob-fromfile-
Make references using Coq globalizations from file file. (Such globalizations are obtained with Coq option
-dump-glob).
-
--no-externals -
Do not insert links to the Coq standard library.
--externalurl libroot-
Set base URL for the external library whose root prefix is libroot.
--coqlib_urlurl-
Set base URL for the Coq standard library (default is http://coq.inria.fr/library/).
--coqlibdir-
Set the base path where the Coq files are installed, especially style files coqdoc.sty and coqdoc.css.
-Rdir coqdir-
Map physical directory dir to Coq logical directory coqdir (similarly to Coq option
-R).Note:option-Ronly has effect on the files following it on the command line, so you will probably need to put this option first.
Contents options
-
-g, --gallina -
Do not print proofs.
-
-l, --light -
Light mode. Suppress proofs (as with
-g) and the following commands:- •
-
[Recursive] Tactic Definition
- •
-
Hint / Hints
- •
-
Require
- •
-
Transparent / Opaque
- •
-
Implicit Argument / Implicits
- •
-
Section / Variable / Hypothesis / End
The behavior of options
-gand-lcan be locally overridden using the (* begin show *) ... (* end show *) environment (see above).
Language options
Default behavior is to assume ASCII 7 bits input files.
-
-latin1, --latin1 -
Select ISO-8859-1 input files. It is equivalent to --inputenc latin1 --charset iso-8859-1.
-
-utf8, --utf8 -
Select UTF-8 (Unicode) input files. It is equivalent to --inputenc utf8 --charset utf-8. LaTeX UTF-8 support can be found at http://www.ctan.org/tex-archive/macros/latex/contrib/supported/unicode/.
|
Give a LaTeX input encoding, as an option to LaTeX package inputenc. |
|---|---|
|
Specify the HTML character set, to be inserted in the HTML header. |
Releases
12 releases since Debian 3.1 (Sarge); the text changed 7 times.
--body-only since Debian 5.0 (Lenny);
--dvi since Debian 5.0 (Lenny);
--gallina since Debian 5.0 (Lenny);
--help since Debian 5.0 (Lenny);
--html since Debian 5.0 (Lenny);
--latex since Debian 5.0 (Lenny);
--latin1 since Debian 5.0 (Lenny);
--light since Debian 5.0 (Lenny);
--multi-index since Debian 5.0 (Lenny);
--no-externals since Debian 5.0 (Lenny);
--no-index since Debian 5.0 (Lenny);
--ps since Debian 5.0 (Lenny);
--quiet since Debian 5.0 (Lenny);
--short since Debian 5.0 (Lenny);
--stdout since Debian 5.0 (Lenny);
--table-of-contents since Debian 5.0 (Lenny);
--texmacs since Debian 5.0 (Lenny);
--utf8 since Debian 5.0 (Lenny);
--version since Debian 5.0 (Lenny);
-g since Debian 5.0 (Lenny);
-l since Debian 5.0 (Lenny);
-latin1 since Debian 5.0 (Lenny);
-q since Debian 5.0 (Lenny);
-s since Debian 5.0 (Lenny);
-toc since Debian 5.0 (Lenny);
-utf8 since Debian 5.0 (Lenny);
-v since Debian 5.0 (Lenny).
--glob-from until Debian 12 (Bookworm).