1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151

(*
* prooftree  proof tree display for Proof General
*
* Copyright (C) 2011  2016 Hendrik Tews
*
* This file is part of "prooftree".
*
* "prooftree" is free software: you can redistribute it and/or
* modify it under the terms of the GNU General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* "prooftree" is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* General Public License in file COPYING in this or one of the parent
* directories for more details.
*
* You should have received a copy of the GNU General Public License
* along with "prooftree". If not, see <http://www.gnu.org/licenses/>.
*
* $Id: proof_tree.mli,v 1.18 2016/01/23 12:57:15 tews Exp $
*)
(** Internal representation of proof trees with undo info *)
(** Process a currentgoals command from Proof General, updating the
prooftree display in the right way. If the [layer_flag] is set,
new root goals for independent proof trees are added in a new
layer to the display. In this case there must be no open goal. If
no proof display for [proof_name] is currently in progress, this
function assumes that a new proof has just been started. Then a
new proof display is created or a previous display is emptied and
reused. If [layer_flag] is set, the [current_sequent] and the
additional sequents (from [additional_ids]) form all root nodes of
independent proof trees.
If [layer_flag] is false, the following cases are distinguished,
using {!current_proof_tree}:
{ol
{ The old current branch has been finished (possibly with a
cheating command such as [admit]) and the proof assistant has
switched to the next open goal. This case applies when the new
current goal [current_sequent_id] is in the hash of known
sequents and differs from the old current sequent.}
{ A proof command has been applied to the current sequent,
yielding a new current sequent and possibly some additional
subgoals. This case applies
when the new current sequent [current_sequent_id] is not in the
hash of known sequents. As a special exception, this case does
also apply when the new current sequent equals the old current
sequent and is therefore found in the hash of known sequents (this
happens if the user applied a nonfailing command, that didn't
change the goal, auch as [auto] in some cases.)
} }
@param state state for undo
@param proof_name name of the proof
@param proof_command command issued to the prover
@param cheated_flag is true if the command is a cheating one
@param layer_flag is true if the command adds a new layer of proof goals
@param current_sequent_id ID of current sequent
@param current_sequent_text the current sequent itself
@param additional_ids ID's of the additionally open goals
@param uninstantiated existential variables
@param inst_deps instantiated existential variables with dependencies
*)
val process_current_goals :
int > string > string >
bool > bool > string > string > string list > string list >
(string * string list) list > unit
(** Process an [updatesequent] command. This function is a wrapper
around {!update_sequent_element}, which looks up the right sequent
object and produces appropriate errors, if something goes wrong.
@param state state for undo
@param proof_name name of proof
@param sequent_id ID of sequent to update
@param sequent_text new sequent text
*)
val update_sequent : int > string > string > string > unit
(** Switch to a different open goal.
@param state state for undo
@param proof_name name of proof
@param new_current_id id of new current goal
*)
val switch_to : int > string > string > unit
(** Finish the current branch. Keep current proof, even if this was
the last open branch, in case some existential gets
instantiated or some sequent updated.
@param state state for undo
@param proof_name name of the proof
@param proof_command last command
@param cheated_flag is true if the command is a cheating one
@param uninstantiated existential variables
@param inst_deps instantiated existential variables with dependencies
*)
val process_branch_finished : int > string > string > bool >
string list > (string * string list) list > unit
(** Display a "Complete" message and retire the current proof.
@param state state for undo
@param proof_name name of the completed proof
*)
val process_proof_complete : int > string > unit
(** Undo all changes to reach state [state]. That is, all changes with
a strictly greater state number are undone. Proof trees started
later than [state] will be deleted. Those finished earlier than
[state] remain untouched. All proof trees will be identical to the
point in time before the first action with a state strictly
greater than [state] has been processed.
*)
val undo : int > unit
(** Close the proof window for [proof_name].
@param proof_name name of the proof
*)
val quit_proof : string > unit
(** For efficiency in proof replay the proof tree display and the
sequent area are not redrawn after every change. Changes are only
recorded in the internal data structures. This function cases a
redisplay of those items.
*)
val finish_drawing : unit > unit
(** Take the necessary actions when the configuration record changed.
Calls the {!Proof_window.proof_window.configuration_updated}
method on all live proof windows.
*)
val configuration_updated : unit > unit
