Commit 1ce44a69 authored by François Bobot's avatar François Bobot

doc: add information about obsolete and archive. Correct why3session mod/copy/copy-archive

parent 9e416f60
......@@ -153,11 +153,11 @@ with the GUI, and replay the proofs, you will be asked to choose
between 3 options:
\begin{itemize}
\item Keep the former proofs as they are. They will be marked as
``archived''.
``archived''\index{archived}.
\item Upgrade the former proofs to an installed prover (typically a
upgraded version). The corresponding proof attempts will become
attached to this new prover, and marked as obsolete, to make their
replay mandatory.
attached to this new prover, and marked as obsolete\index{obsolete},
to make their replay mandatory.
\item Copy the former proofs to an installed prover. This is a
combination of the actions above: each proof attempt is duplicated,
one with the former prover marked as archived, and one for the new
......@@ -174,7 +174,8 @@ discard these choices via the \textsf{Preferences} dialog.
Outside the GUI, the prover upgrades are handled as follows. The
\texttt{why3replayer} tool will just ignore proof attempts marked as
archived. Conversely, a non-archived proof attempt with a non-existent
archived\index{archived}.
Conversely, a non-archived proof attempt with a non-existent
prover will be reported as a replay failure. The tool
\texttt{why3session} allows you to perform move or copy operations on
proof attempts in a fine-grain way, using filters, as detailed in
......
This diff is collapsed.
......@@ -8,7 +8,7 @@
\usepackage[T1]{fontenc}
\usepackage{lmodern}
%\usepackage{url}
\usepackage[a4paper,pdftex,colorlinks=true,urlcolor=blue,pdfstartview=FitH]{hyperref}
\usepackage[pdftex,colorlinks=true,urlcolor=blue,pdfstartview=FitH]{hyperref}
\usepackage{graphicx}
\usepackage{listings}
\usepackage{xspace}
......
......@@ -164,14 +164,16 @@ attempts and transformations were saved in a database --- an XML file
created when the \why file was opened in the GUI for the first
time. Then, for all the goals that remain unchanged, the previous
proofs are shown again. For the parts that changed, the previous
proofs attempts are shown but marked with "(obsolete)" so that you
proofs attempts are shown but marked with "(obsolete)"\index{obsolete}
so that you
know the results are not accurate. You can now retry to prove all what
remains unproved using any of the provers.
\subsection{Replaying obsolete proofs}
Instead of pushing a prover's button to rerun its proofs, you can
\emph{replay} the existing but obsolete proof attempts, by clicking on
\emph{replay} the existing but obsolete\index{obsolete}
proof attempts, by clicking on
the \textsf{Replay} button. By default, \textsf{Replay} only replays
proofs that were successful before. If you want to replay all of them,
you must select the context \textsf{all goals} at the top of the left
......
......@@ -58,13 +58,7 @@ let spec =
("--set-archive", Arg.Unit set_opt_archived,
" the proof is set to archive" ) ::
("--unset-archive", Arg.Unit unset_opt_archived,
" the proof is set to replayable" ) ::
("--set-obsolete", Arg.Set tobe_obsolete,
" the proof is set to obsolete" ) ::
("--set-archive", Arg.Unit set_opt_archived,
" the proof is set to archive" ) ::
("--unset-archive", Arg.Unit unset_opt_archived,
" the proof is set to replayable" ) ::
" the proof attribute archive is unset" ) ::
(*
("--to-known-prover",
Arg.Set opt_to_known,
......
......@@ -56,7 +56,7 @@ associated to proved goals (same as --filter-verified-goal --conservative)")::
(* ("--never", Arg.Unit (set_remove Never),
" never remove a proof")::
("-n", Arg.Unit (set_remove Never), " same as --never")::*)
(filter_spec @ common_options)
(force_obsolete_spec @ filter_spec @ common_options)
let rec interactive to_remove =
eprintf "Do you want to remove the external proof %a (y/n)@."
......@@ -69,7 +69,7 @@ let rec interactive to_remove =
let run_one env config filters fname =
let env_session,_ =
read_update_session ~allow_obsolete:false env config fname in
read_update_session ~allow_obsolete:!opt_force_obsolete env config fname in
session_iter_proof_attempt_by_filter filters
(fun pr ->
let remove = match !opt_remove with
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment