From 488b507fca0909aba6a01063929c5fc78927e030 Mon Sep 17 00:00:00 2001
From: herbelin
Date: Fri, 3 Sep 2004 15:57:16 +0000
Subject: MAJ

git-svn-id: svn+ssh://scm.gforge.inria.fr/svn/coq/trunk@8584 85f007b7-540e-0410-9357-904b9bb8a0f7
---
 doc/RefMan-com.tex | 75 ++++++++++++++++++++++++++++++++++--------------------
 1 file changed, 48 insertions(+), 27 deletions(-)

(limited to 'doc/RefMan-com.tex')

diff --git a/doc/RefMan-com.tex b/doc/RefMan-com.tex
index cf5b100e7f..730100eedd 100755
--- a/doc/RefMan-com.tex
+++ b/doc/RefMan-com.tex
@@ -88,7 +88,7 @@ you move the \Coq\ binaries and library after installation.
 \index{Options of the command line}
 
 The following command-line options are recognized by the commands {\tt
-  coqc} and {\tt coqtop}:
+  coqc} and {\tt coqtop}, unless stated otherwise:
 
 \begin{description}
 \item[{\tt -byte}]\ 
@@ -110,20 +110,32 @@ The following command-line options are recognized by the commands {\tt
   logical {\dirpath} and adds {\em directory} and its subdirectories
   to the searched directories when looking for a file.
 
+\item[{\tt -top} {\dirpath}]\ 
+
+  This sets the toplevel module name to {\dirpath} instead of {\tt
+  Top}. Not valid for {\tt coqc}.
+
 \item[{\tt -is} {\em file}, {\tt -inputstate} {\em file}]\ 
 
   Cause \Coq~to use the state put in the file {\em file} as its input
   state. The default state is {\em initial.coq}.
   Mainly useful to build the standard input state.
 
+\item[{\tt -outputstate} {\em file}]\ 
+
+  Cause \Coq~to dump its state to file {\em file}.coq just after finishing
+  parsing and evaluating all the arguments from the command line.
+
 \item[{\tt -nois}]\ 
 
   Cause \Coq~to begin with an empty state. Mainly useful to build the
   standard input state.
 
-\item[{\tt -notactics}]\ 
-
-  Forbid the dynamic loading of tactics.
+%Obsolete?
+%
+%\item[{\tt -notactics}]\ 
+%
+%  Forbid the dynamic loading of tactics in the bytecode version of {\Coq}.
 
 \item[{\tt -init-file} {\em file}]\ 
 
@@ -146,10 +158,15 @@ The following command-line options are recognized by the commands {\tt
 
   Load the Caml object file {\em file}.
 
-\item[{\tt -load-vernac-source} {\em file}]\ 
+\item[{\tt -l} {\em file}, {\tt -load-vernac-source} {\em file}]\ 
 
   Load \Coq~file {\em file}{\tt .v}
 
+\item[{\tt -lv} {\em file}, {\tt -load-vernac-source-verbose} {\em file}]\ 
+
+  Load \Coq~file {\em file}{\tt .v} with 
+  a copy of the contents of the file on standard input.
+
 \item[{\tt -load-vernac-object} {\em file}]\ 
 
   Load \Coq~compiled file {\em file}{\tt .vo}
@@ -169,35 +186,40 @@ The following command-line options are recognized by the commands {\tt
   This option implies options {\tt -batch} and {\tt -silent}. It is
   only available for {\tt coqtop}.
 
-%\item[{\tt -compile-verbose} {\em file}]\ 
+\item[{\tt -compile-verbose} {\em file}]\ 
+
+  This compiles file {\em file}{\tt .v} into {\em file}{\tt .vo} with
+  a copy of the contents of the file on standard input.
+  This option implies options {\tt -batch} and {\tt -silent}. It is
+  only available for {\tt coqtop}.
+
+\item[{\tt -verbose}]\ 
 
-%  This compiles file {\em file}{\tt .v} into {\em file}{\tt .vo} with
-%  a copy of the contents of the file on standard input.
-%  This option implies options {\tt -batch} and {\tt -silent}. It is
-%  only available for {\tt coqtop}.
+  This option is only for {\tt coqc}. It tells to compile the file with
+  a copy of its contents on standard input.
 
 \item[{\tt -batch}]\ 
 
   Batch mode : exit just after arguments parsing. This option is only
   used by {\tt coqc}.
 
-\item[{\tt -debug}]\ 
-
-  Switch on the debug flag.
+%Mostly unused in the code
+%\item[{\tt -debug}]\ 
+%
+%  Switch on the debug flag.
 
 \item[{\tt -xml}]\ 
 
   This option is for use with {\tt coqc}. It tells \Coq\ to export on
   the standard output the content of the compiled file into XML format.
 
-\item[{\tt -emacs}]\ 
+\item[{\tt -quality}]
 
-  Tells \Coq\ it is executed under Emacs.
+  Improve the legibility of the proof terms produced by some tactics.
 
-\item[{\tt -db}]\ 
+\item[{\tt -emacs}]\ 
 
-  Launch \Coq\ under the Objective Caml debugger (provided that \Coq\
-  has been compiled for debugging; see next chapter).
+  Tells \Coq\ it is executed under Emacs.
 
 \item[{\tt -impredicative-set}]\ 
 
@@ -206,6 +228,11 @@ The following command-line options are recognized by the commands {\tt
   some standard axioms of classical mathematics such as the functional
   axiom of choice or the principle of description
 
+\item[{\tt -dump-glob} {\em file}]\
+
+  This dumps references for global names in file {\em file}
+  (to be used by coqdoc, see~\ref{coqdoc})
+ 
 \item[{\tt -dont-load-proofs}]\ 
 
   This avoids loading in memory the proofs of opaque theorems
@@ -219,15 +246,9 @@ The following command-line options are recognized by the commands {\tt
 
 \item[{\tt -bindir} {\em directory}]\ 
 
-  Set the directory containing \Coq\ binaries.
+  Set for {\tt coqc} the directory containing \Coq\ binaries.
   It is equivalent to do \texttt{export COQBIN=}{\em directory}
-  before lauching \Coq.
-
-\item[{\tt -libdir} {\em file}]\ 
-
-  Set the directory containing \Coq\ libraries.
-  It is equivalent to do \texttt{export COQLIB=}{\em directory}
-  before lauching \Coq.
+  before lauching {\tt coqc}.
 
 \item[{\tt -where}]\ 
 
@@ -243,7 +264,7 @@ The following command-line options are recognized by the commands {\tt
 
 \end{description}
 
-% {\tt coqtop} owns an additional option:
+% {\tt coqtop} has an additional option:
 
 % \begin{description}
 % \item[{\tt -searchisos}]\ \\
-- 
cgit v1.2.3

