2 (**********************************************************************)
5 - implementare macro in matitaScript.ml (check, hint, ..) -> Gares
6 - script outline -> Zack
7 - cicBrowser: riagganciare(?) resa di termini scritti
9 - menu contestuale (tasto dx) nel sequent viewer ->
10 - controllo per script modificato o meno prima di uscire ->
11 - riattaccare hbugs (brrr...) -> Zack
12 - spostare il codice di creazione delle tabelle da
13 MatitaDb, al momento quelle create da matita possono
14 andare out of sync con quelle create dai file .sql
17 - tree update in background -> Gares
18 - update del getter in background -> Zack
19 - agganciare href_callback del sequent_viewer -> Zack
20 - shortcut varie per script handling -> Zack
21 - operazioni rimanenti su script (top, bottom, jump) -> Zack
22 - lighting-ls-getter in matita -> Gares
23 - riagganciare toolbar -> Zack
24 - evitare che n-mila tattiche Goal siano nello script
25 (una per ogni cambio di tab) -> Zack
26 - implementazione comandi rimanenti in matitaEngine.ml -> Gares
27 - sintassi per gli alias -> Gares
28 - implementazione script handling (sopra engine) -> Zack
29 - matitaSync all'indietro -> Gares
30 - riagganciare GUI -> Zack
32 (**********************************************************************)
35 - interattivi (solo da gui)
36 - Macro/Comandi (check, print, hint, undo, locate, match)
37 potrebbero anche non avere sintassi concreta, del tipo che
38 check e' solo un bottone che apre una finetra in cui puoi
39 scrivere un termine o selezionarlo dalla prova corrente
40 - batch (sono gli unici che stanno nel .ma)
41 - Tattiche, theorem, alias (cambiano la prova)
45 -------------------------------------------+
46 gui (macro: hint) | SHELL
48 +-----------------+---------------+-----------------------------------
49 | matita (status) | | matitac
50 | (log) (sync) | but2log | fold ( fun s l -> engine l s) file
51 +-----------------+---------------+-----------------------------------
52 | lingua:/sintassi concreta non ambigua delle tattiche+Qed,Thm,alias/
53 +----------------------------------------------------------
54 | engine: TacticAst (cic) -> status -> status
55 | ma non usa il campo alias dello status
56 ---------+----------------------------------------------------------
58 --------------------------------------------------------------------
62 - accetta solo linee non ambigue
64 alias ident nat = "cic:/matita/gares/nat.ind#(1/1)".
65 alias number = (natural|real|positive|integer).
70 - mantiene uno stack di stati
71 - mantiene un log sync con gli stati
72 - offre delle api per generare la sintassi concreta che puo' servire
73 alla gui (la gui fa una chiamata a funzione e matita genera "auto."
74 cosi' la sintassi la gui non la vede mai e la tratta al massimo come un
75 testo semplice e basta (insomma, metterei in matita il generatore di
76 sintassi concreta) but2log
77 - ha il controllo... ovvero anche la gui viene usata da matita, o per sapere
78 la prossima azione o per chidere di scegliere il termine tra una lista
80 (stato :: tl) (log , (start,end) :: tl)
93 - metadati relativi allo script per il sync
94 - settings "baseuri/url/" eccc
100 engine prende in input
101 - AST di Cic (tactic ast)
104 - presi 2 stati fa il diff e lo somma/sottrae al DB
106 (**********************************************************************)
109 - ad ogni script sul quale l'utente sta lavorando corrispondono
110 - un modello (vedi sotto)
111 - un buffer di testo gtk + attributi (usati principalmente per distinguere la
112 parte di testo immodificabile da quella modificabile)
113 - una lista di observer che vengono notificati ad ogni cambiamento di stato
114 - un modello di script e' composto da:
115 - una lista di stringhe (inizialmente vuota) detta "statement list". Ogni
116 elemento della lista corrisponde ad uno statement (nel senso di
117 TacticAst.statement) gia' valutato dall'engine. La parte immodificabile del
118 buffer di testo corrisponde con le stringhe contenute nella lista
119 - una lista di stati (inizialmente contenente lo stato vuoto) detta "state
120 list". Si ha l'invariante che la lunghezza di tale lista e' uguale alla
121 lunghezza della statements list + 1. Lo stato i-esimo della lista di stati
122 e' lo stato di matita _prima_ dell'esecuzione dell i-esimo statement
123 - una stringa, detta "future text", corrispondente alla parte di testo dello
124 script non ancora valutata. L'ultimo stato della state list e' lo stato
126 - relazione tra modello e buffer di testo gtk
127 - le modifiche al testo del buffer sono possibili solo nella parta non ancora
128 valutata. Ognuna di esse viene apportata _anche_ al future text
129 - invariante: e' sempre possibile riscrivere ("redraw") l'intero contenuto del
130 buffer di testo a partire dal modello, attributi compresi
133 - new: gtk_text_buffer -> script
134 - redraw: unit (* ridisegna il contenuto del buffer di testo *)
135 - advance: ?statement:string -> unit -> unit
136 (* valuta il primo statement del future text (usando eval_statement
137 (puo' fallire con una eccezione)), rimuove il testo corrispondente dal
138 future text, aggiunge alla statement list una entry per ogni statement
139 ritornato da eval_statement, aggiunge il nuovo stato alla state list,
140 invoka tutti gli observer
141 Se c'e' l'argomento opzionale statement, quello e' il testo che viene
142 passato ad eval_statement, se ha successo nessuna rimozione dal future
143 text viene effettuata *)
144 - retract: unit -> unit
145 (* sposta l'ultimo statement della statement list al future text, toglie
146 l'ultimo stato della state list, MatitaSync.time_travel
147 ~present:ultimo_stato ~past:stato_precedente *)
148 - private eval_statement: string -> MatitaTypes.status * string list
149 (* parsa lo statement
150 - se e' un Command o un Tactical (vedi TacticAst) invoca MatitaEngine
151 passando lo stato corrente
152 - se e' una Macro la gestisce (= tutte le Macro sono implementate qua)
153 Ritorna una lista di coppie <stato, statement>. La proiezione sulla
154 prima componente rappresenta gli stati da aggiungere alla state list;
155 quella sulla seconda gli statement da aggiungere alla statement list.
157 (* gestione degli observer *)
158 - add_observer: (MatitaTypes.status -> unit) -> observer_id
159 - remove_observer: observer_id -> unit
160 (* gestione del salvataggio *)
161 - save_to: string -> unit (* ridisegna su file *)
162 - load_from: string -> unit
163 (* retract fino allo stato zero, nuovo stato con future text pari al
164 contenuto del file passato *)