helm/matita/matita.txt

   1 TODO
   2   NUCLEO
   3   - PREOCCUPANTE: per
   4     inductive i : Prop := K : True (*-> i*) -> i.
   5     noi generiamo i_rec e i_rect con e senza il commento qui sopra; Coq NON
   6     genera i_rec e i_rect quando c'e' un argomento ricorsivo.
   7     (CSC: manca vincolo aggiuntivo non dipendente dalla sorta per il caso in
   8     questione) -> CSC
   9
  10
  11   TATTICHE
  12   - theorem t: True. elim x. ==> BOOM! unificazione di una testa flessibile con
  13     True.
  14   - parsing contestuale (tattiche replace, change e forse altre)
  15     capire dove fare la select per avere i contesti in cui disambiguare gli
  16     altri argomenti.
  17   - assiomi (manca sintassi concreta e AST).
  18   - Guardare il commento
  19     (*CSC: this code is suspect and/or bugged: we try first without reduction
  20     and then using whd. However, the saturate_term always tries with full
  21     reduction without delta. *)
  22     in primitiveTactics.ml. Potrebbe essere causa di rallentamento della apply
  23     oltre che di bug!
  24   - Dare errore significativo al posto di NotWellTypedInterpreation -> CSC
  25   - elim_intros_simpl e rewrite_simpl: ora non viene usata dal
  26                ^^^^^^           ^^^^^^
  27     toplevel la variante che semplifica. Capire quali sono i problemi
  28     e/o cosa fare delle varianti con semplificazione.
  29     (con sintassi concreta alla \section*, analogamente cut e similia che fanno
  30     intros... ) -> CSC
  31   - eta_expand non usata da nessuno? (ask Andrea?)
  32   - eliminare eta_fix? (aspettare notazione) (correlato con sopra?)
  33   - bug di ferruccio: fare un refresh dei nomi dopo l'applicazione
  34     di una tattica. Di quali nomi fare refresh? (Andrea) di quelli
  35     veramente ambigui, ovvero dell'ultimo binder tale che sotto di
  36     esso un nome viene usato in maniera ambigua. Esempio:
  37     \lambda x. \lambda x. (x x) (dove una x e' -2) ==> fare refresh
  38     \lambda x. \lambda x. (x x) (dove entrambe sono -1) ==> non fare refresh
  39     Capita quando un tipo dall'environment (e.g. \lambda x.T)
  40     viene inserito in un contesto (e.g. x:nat) dove le variabili
  41     sono gia' state legate in precedenza.
  42   - supportare l'apertura di piu' script contemporaneamente in tab/finestre
  43     diversi/e
  44
  45
  46   GUI GRAFICA
  47   - highlight degli errori di parsing nello script (usando lo sfondo come per la
  48     parte lockata di testo, da ripulire quando si modifica il testo o si sposta
  49     il punto di esecuzione)
  50   - invertibilita' dell'inserimento automatico di alias: quando si torna
  51     su bisognerebbe tornare su di un passo e non fare undo degli alias
  52     (Zack: nella history ci sono anche gli offset per sapere a che pezzo di
  53     script uno stato appartiene)
  54   - keybinding globali: CTRL-{su,giu,...} devono fungere anche quando altre
  55     finestre hanno il focus (e.g. cicBrowser). C'e' gia' da qualche parte il
  56     codice che aggiunge i keybinding a tutte le eventBox, e' da ripristinare
  57   - fare "matita foo" (dove foo non esiste), cambiare qualcosa e uscire senza
  58     salvare. In verita' foo e' stato scritto lo stesso!
  59   - sensitiveness per copy/paste/cut/delete nel menu Edit
  60   - sensitiveness per goto begin/end/etc.
  61
  62   - menu contestuale (tasto dx) nel sequent viewer -> attende notazione
  63   - bug di refresh del widget quando si avanza ("swap" tra la finestra dei
  64     sequenti e la finestra dello script)
  65   - feedback su hyperlink nei sequenti e nel browser: rendere visibili gli
  66     hyperlink (cursore a "manina"? hyperlink evidenziati?). La maction che
  67     collassa la prova e' fastidiosa: la prova si chiude se non si clicca
  68     correttamente su un hyperlink (anche tooltip sui bottoni)
  69   - che farne della palette delle tattiche?
  70   - script outline -> Zack
  71   - riattaccare hbugs (brrr...)                             -> Zack
  72
  73   GUI LOGICA
  74   - matitaclean all (o matitamake cleanall) dovrebbe radere al suolo la
  75     directory .matita
  76   - notazione -> Luca e Zack
  77   - copiare nel .moo la baseuri e poi il matitaclean la legge da li e non dal
  78     .ma (si evita il syntax error e il cambio di una baseuri non causa
  79     sporcizia)
  80   - non chiudere transitivamente i moo ??
  81
  82 DONE
  83 - icone standard per zoom-in/out/= e piu' aderenza alle Gnome Interface
  84   Guidelines (e.g. about dialog) -> CSC
  85 - salvare la parte di testo lockata dagli effetti di undo/redo con
  86   (shift-)ctrl-Z e anche usando il menu che si apre con il tasto destro -> CSC
  87 - fare in modo che il testo caricato inizialmente da matita non sia
  88   undoable (usando i metodi begin/end_not_undoable_action di gtk_source_view)
  89   -> Gares
  90 - Implementare menu edit: cut/copy/undo/etc. -> CSC
  91 - gestione dei path per include: il path deve essere assoluto? da decidere ...
  92   ( -I ?? o chiedere a matitamake la root e farci una find? ) -> Gares
  93 - freeze durante avanzamento -> Gares, CSC
  94 - tornare indietro (verso il cursore) in matita dovrebbe essere O(1) e non un
  95   Undo passo passo (sembra che il collo di bottiglia sia fare iterare su ogni
  96   uri da togliere (accorpare almeno il lavoro sul db magari aiuta) -> Gares, CSC
  97 - quando si sposta il punto di esecuzione dello script cambiare la parte di
  98   script visibile nella finestra dello script -> Gares, CSC
  99 - find & replace -> Gares
 100 - Bug di cut&paste: se si fa cut&paste di testo lockato si ottiene testo
 101   lockato! -> Gares
 102 - Bug: non disambigua
 103   inductive i (x:nat) : bool \to Prop \def K : bool \to (i x true) \to (i x false).
 104   perche' non inserisce nat nel domain di disambiguazione. Deve esserci un bug
 105   stupido da qualche parte -> CSC
 106 - Bug vari nella generazione dei principi di eliminazione:
 107    1. generazione nomi (usa ref incrementata localmente) -> Andrea
 108    2. prodotti dipendenti come non-dipendenti (visibili eseguendo passo
 109       passo il test inversion.ma) -> CSC, Gares
 110    3. usato trucco outtype non dipendenti per il case -> CSC, Gares
 111 - controllo per script modificato o meno prima di uscire  -> Gares
 112 - LApply deve prendere in input gli identificatori che va a generare;
 113   lascio a Ferruccio la scelta della sintassi concreta    -> Ferruccio
 114 - fare tornare a matitac -1 quando lo stato finale e'
 115   diverso da No_proof, non eseguire comandi quando lo
 116   stato e' diverso da No_proof                            -> CSC
 117 - uri_of_term and term_of_uri: cambiare il tipo per far
 118   tornare delle uri!!!                                    -> CSC
 119 - intro = intros 1                                        -> Gares
 120 - timetravel (urimanager)                                 -> Gares
 121 - implementare macro in matitaScript.ml                   -> Gares
 122 - history deve aggiornare anche la whelp bar              -> Gares
 123 - commenti exeguibili (forse devono essere una lista e non
 124   un singolo executable e forse devono contenere anche Note
 125   e non solo Executable)                                  -> Gares
 126 - spostare il codice di creazione delle tabelle da
 127   MatitaDb, al momento quelle create da matita possono
 128   andare out of sync con quelle create dai file .sql      -> Gares
 129 - tree update in background                               -> Gares
 130 - update del getter in background                         -> Zack
 131 - agganciare href_callback del sequent_viewer             -> Zack
 132 - shortcut varie per script handling                      -> Zack
 133 - operazioni rimanenti su script (top, bottom, jump)      -> Zack
 134 - lighting-ls-getter in matita                            -> Gares
 135 - riagganciare toolbar                                    -> Zack
 136 - evitare che n-mila tattiche Goal siano nello script
 137   (una per ogni cambio di tab)                            -> Zack
 138 - implementazione comandi rimanenti in matitaEngine.ml    -> Gares
 139 - sintassi per gli alias                                  -> Gares
 140 - implementazione script handling (sopra engine)          -> Zack
 141 - matitaSync all'indietro                                 -> Gares
 142 - riagganciare GUI                                        -> Zack
 143
 144 (**********************************************************************)
 145
 146 comandi:
 147  - interattivi (solo da gui)
 148    - Macro/Comandi (check, print, hint, undo, locate, match)
 149      potrebbero anche non avere sintassi concreta, del tipo che
 150      check e' solo un bottone che apre una finetra in cui puoi
 151      scrivere un termine o selezionarlo dalla prova corrente
 152  - batch (sono gli unici che stanno nel .ma)
 153    - Tattiche, theorem, alias (cambiano la prova)
 154
 155
 156           MOUSE
 157 -------------------------------------------+
 158  gui (macro: hint)                         |      SHELL
 159      (disambiguatore)                      |
 160          +-----------------+---------------+-----------------------------------
 161          | matita (status) |               | matitac
 162          | (log) (sync)    |    but2log    | fold ( fun s l -> engine l s) file
 163          +-----------------+---------------+-----------------------------------
 164          |  lingua:/sintassi concreta non ambigua delle tattiche+Qed,Thm,alias/
 165          +----------------------------------------------------------
 166          |            engine: TacticAst (cic) -> status -> status
 167          |               ma non usa il campo alias dello status
 168 ---------+----------------------------------------------------------
 169                             ocaml
 170 --------------------------------------------------------------------
 171
 172
 173 engine:
 174  - accetta solo linee non ambigue
 175  - alias:
 176      alias ident nat = "cic:/matita/gares/nat.ind#(1/1)".
 177      alias number = (natural|real|positive|integer).
 178
 179
 180
 181 matita:
 182  - mantiene uno stack di stati
 183  - mantiene un log sync con gli stati
 184  - offre delle api per generare la sintassi concreta che puo' servire
 185    alla gui (la gui fa una chiamata a funzione e matita genera "auto."
 186    cosi' la sintassi la gui non la vede mai e la tratta al massimo come un
 187    testo semplice e basta (insomma, metterei in matita il generatore di
 188    sintassi concreta) but2log
 189  - ha il controllo... ovvero anche la gui viene usata da matita, o per sapere
 190    la prossima azione o per chidere di scegliere il termine tra una lista
 191
 192  (stato :: tl) (log , (start,end) :: tl)
 193
 194  +----------+
 195  |          |
 196  +----------+
 197
 198 gui:
 199  - step
 200  - choose
 201
 202 stato:
 203  - alias
 204  - proof status option
 205  - metadati relativi allo script per il sync
 206  - settings "baseuri/url/" eccc
 207  -
 208
 209 alias
 210  - sintassi concreta
 211
 212 engine prende in input
 213  - AST di Cic (tactic ast)
 214
 215 sync:
 216  - presi 2 stati fa il diff e lo somma/sottrae al DB
 217
 218 (**********************************************************************)
 219
 220 script handling
 221 - ad ogni script sul quale l'utente sta lavorando corrispondono
 222   - un modello (vedi sotto)
 223   - un buffer di testo gtk + attributi (usati principalmente per distinguere la
 224     parte di testo immodificabile da quella modificabile)
 225   - una lista di observer che vengono notificati ad ogni cambiamento di stato
 226 - un modello di script e' composto da:
 227   - una lista di stringhe (inizialmente vuota) detta "statement list". Ogni
 228     elemento della lista corrisponde ad uno statement (nel senso di
 229     TacticAst.statement) gia' valutato dall'engine. La parte immodificabile del
 230     buffer di testo corrisponde con le stringhe contenute nella lista
 231   - una lista di stati (inizialmente contenente lo stato vuoto) detta "state
 232     list". Si ha l'invariante che la lunghezza di tale lista e' uguale alla
 233     lunghezza della statements list + 1. Lo stato i-esimo della lista di stati
 234     e' lo stato di matita _prima_ dell'esecuzione dell i-esimo statement
 235   - una stringa, detta "future text", corrispondente alla parte di testo dello
 236     script non ancora valutata. L'ultimo stato della state list e' lo stato
 237     corrente di matita
 238 - relazione tra modello e buffer di testo gtk
 239   - le modifiche al testo del buffer sono possibili solo nella parta non ancora
 240     valutata. Ognuna di esse viene apportata _anche_ al future text
 241   - invariante: e' sempre possibile riscrivere ("redraw") l'intero contenuto del
 242     buffer di testo a partire dal modello, attributi compresi
 243 - oggetto script
 244   - metodi
 245     - new: gtk_text_buffer -> script
 246     - redraw: unit (* ridisegna il contenuto del buffer di testo *)
 247     - advance: ?statement:string -> unit -> unit
 248         (* valuta il primo statement del future text (usando eval_statement
 249         (puo' fallire con una eccezione)), rimuove il testo corrispondente dal
 250         future text, aggiunge alla statement list una entry per ogni statement
 251         ritornato da eval_statement, aggiunge il nuovo stato alla state list,
 252         invoka tutti gli observer
 253         Se c'e' l'argomento opzionale statement, quello e' il testo che viene
 254         passato ad eval_statement, se ha successo nessuna rimozione dal future
 255         text viene effettuata *)
 256     - retract: unit -> unit
 257         (* sposta l'ultimo statement della statement list al future text, toglie
 258         l'ultimo stato della state list, MatitaSync.time_travel
 259         ~present:ultimo_stato ~past:stato_precedente *)
 260     - private eval_statement: string -> MatitaTypes.status * string list
 261         (* parsa lo statement
 262         - se e' un Command o un Tactical (vedi TacticAst) invoca MatitaEngine
 263           passando lo stato corrente
 264         - se e' una Macro la gestisce (= tutte le Macro sono implementate qua)
 265           Ritorna una lista di coppie <stato, statement>. La proiezione sulla
 266           prima componente rappresenta gli stati da aggiungere alla state list;
 267           quella sulla seconda gli statement da aggiungere alla statement list.
 268         *)
 269     (* gestione degli observer *)
 270     - add_observer: (MatitaTypes.status -> unit) -> observer_id
 271     - remove_observer: observer_id -> unit
 272     (* gestione del salvataggio *)
 273     - save_to: string -> unit        (* ridisegna su file *)
 274     - load_from: string -> unit
 275         (* retract fino allo stato zero, nuovo stato con future text pari al
 276         contenuto del file passato *)
 277