helm/matita/matita.txt

   1
   2 (**********************************************************************)
   3
   4 TODO
   5 - Implementare menu edit: find/replace/cut/copy/undo/etc.
   6 - Bug vari nella generazione dei principi di eliminazione:
   7    1. generazione nomi (usa ref incrementata localmente)
   8    2. prodotti dipendenti come non-dipendenti (visibili eseguendo passo
   9       passo il test inversion.ma)
  10    3. usato trucco outtype non dipendenti per il case
  11 - elim_intros_simpl e rewrite_simpl: ora non viene usata dal
  12              ^^^^^^           ^^^^^^
  13   toplevel la variante che semplifica. Capire quali sono i problemi
  14   e/o cosa fare delle varianti con semplificazione.
  15 - eta_expand non usata da nessuno?
  16 - eliminare eta_fix? (aspettare notazione da Zack e Luca)
  17 - bug di ferruccio: fare un refresh dei nomi dopo l'applicazione
  18   di una tattica. Di quali nomi fare refresh? (Andrea) di quelli
  19   veramente ambigui, ovvero dell'ultimo binder tale che sotto di
  20   esso un nome viene usato in maniera ambigua. Esempio:
  21   \lambda x. \lambda x. (x x) (dove una x e' -2) ==> fare refresh
  22   \lambda x. \lambda x. (x x) (dove entrambe sono -1) ==> non fare refresh
  23 - a volte genera termini con variabili legate da piu' binder
  24   Capita quando un tipo dall'environment (e.g. \lambda x.T)
  25   viene inserito in un contesto (e.g. x:nat) dove le variabili
  26   sono gia' state legate in precedenza.
  27 - script outline                                          -> Zack
  28 - cicBrowser: riagganciare(?) resa di termini scritti
  29   nella URL(??)                                           ->
  30 - menu contestuale (tasto dx) nel sequent viewer          ->
  31 - riattaccare hbugs (brrr...)                             -> Zack
  32
  33 DONE
  34 - controllo per script modificato o meno prima di uscire  -> Gares
  35 - LApply deve prendere in input gli identificatori che va a generare;
  36   lascio a Ferruccio la scelta della sintassi concreta    -> Ferruccio
  37 - fare tornare a matitac -1 quando lo stato finale e'
  38   diverso da No_proof, non eseguire comandi quando lo
  39   stato e' diverso da No_proof                            -> CSC
  40 - uri_of_term and term_of_uri: cambiare il tipo per far
  41   tornare delle uri!!!                                    -> CSC
  42 - intro = intros 1                                        -> Gares
  43 - timetravel (urimanager)                                 -> Gares
  44 - implementare macro in matitaScript.ml                   -> Gares
  45 - history deve aggiornare anche la whelp bar              -> Gares
  46 - commenti exeguibili (forse devono essere una lista e non
  47   un singolo executable e forse devono contenere anche Note
  48   e non solo Executable)                                  -> Gares
  49 - spostare il codice di creazione delle tabelle da
  50   MatitaDb, al momento quelle create da matita possono
  51   andare out of sync con quelle create dai file .sql      -> Gares
  52 - tree update in background                               -> Gares
  53 - update del getter in background                         -> Zack
  54 - agganciare href_callback del sequent_viewer             -> Zack
  55 - shortcut varie per script handling                      -> Zack
  56 - operazioni rimanenti su script (top, bottom, jump)      -> Zack
  57 - lighting-ls-getter in matita                            -> Gares
  58 - riagganciare toolbar                                    -> Zack
  59 - evitare che n-mila tattiche Goal siano nello script
  60   (una per ogni cambio di tab)                            -> Zack
  61 - implementazione comandi rimanenti in matitaEngine.ml    -> Gares
  62 - sintassi per gli alias                                  -> Gares
  63 - implementazione script handling (sopra engine)          -> Zack
  64 - matitaSync all'indietro                                 -> Gares
  65 - riagganciare GUI                                        -> Zack
  66
  67 (**********************************************************************)
  68
  69 comandi:
  70  - interattivi (solo da gui)
  71    - Macro/Comandi (check, print, hint, undo, locate, match)
  72      potrebbero anche non avere sintassi concreta, del tipo che
  73      check e' solo un bottone che apre una finetra in cui puoi
  74      scrivere un termine o selezionarlo dalla prova corrente
  75  - batch (sono gli unici che stanno nel .ma)
  76    - Tattiche, theorem, alias (cambiano la prova)
  77
  78
  79           MOUSE
  80 -------------------------------------------+
  81  gui (macro: hint)                         |      SHELL
  82      (disambiguatore)                      |
  83          +-----------------+---------------+-----------------------------------
  84          | matita (status) |               | matitac
  85          | (log) (sync)    |    but2log    | fold ( fun s l -> engine l s) file
  86          +-----------------+---------------+-----------------------------------
  87          |  lingua:/sintassi concreta non ambigua delle tattiche+Qed,Thm,alias/
  88          +----------------------------------------------------------
  89          |            engine: TacticAst (cic) -> status -> status
  90          |               ma non usa il campo alias dello status
  91 ---------+----------------------------------------------------------
  92                             ocaml
  93 --------------------------------------------------------------------
  94
  95
  96 engine:
  97  - accetta solo linee non ambigue
  98  - alias:
  99      alias ident nat = "cic:/matita/gares/nat.ind#(1/1)".
 100      alias number = (natural|real|positive|integer).
 101
 102
 103
 104 matita:
 105  - mantiene uno stack di stati
 106  - mantiene un log sync con gli stati
 107  - offre delle api per generare la sintassi concreta che puo' servire
 108    alla gui (la gui fa una chiamata a funzione e matita genera "auto."
 109    cosi' la sintassi la gui non la vede mai e la tratta al massimo come un
 110    testo semplice e basta (insomma, metterei in matita il generatore di
 111    sintassi concreta) but2log
 112  - ha il controllo... ovvero anche la gui viene usata da matita, o per sapere
 113    la prossima azione o per chidere di scegliere il termine tra una lista
 114
 115  (stato :: tl) (log , (start,end) :: tl)
 116
 117  +----------+
 118  |          |
 119  +----------+
 120
 121 gui:
 122  - step
 123  - choose
 124
 125 stato:
 126  - alias
 127  - proof status option
 128  - metadati relativi allo script per il sync
 129  - settings "baseuri/url/" eccc
 130  -
 131
 132 alias
 133  - sintassi concreta
 134
 135 engine prende in input
 136  - AST di Cic (tactic ast)
 137
 138 sync:
 139  - presi 2 stati fa il diff e lo somma/sottrae al DB
 140
 141 (**********************************************************************)
 142
 143 script handling
 144 - ad ogni script sul quale l'utente sta lavorando corrispondono
 145   - un modello (vedi sotto)
 146   - un buffer di testo gtk + attributi (usati principalmente per distinguere la
 147     parte di testo immodificabile da quella modificabile)
 148   - una lista di observer che vengono notificati ad ogni cambiamento di stato
 149 - un modello di script e' composto da:
 150   - una lista di stringhe (inizialmente vuota) detta "statement list". Ogni
 151     elemento della lista corrisponde ad uno statement (nel senso di
 152     TacticAst.statement) gia' valutato dall'engine. La parte immodificabile del
 153     buffer di testo corrisponde con le stringhe contenute nella lista
 154   - una lista di stati (inizialmente contenente lo stato vuoto) detta "state
 155     list". Si ha l'invariante che la lunghezza di tale lista e' uguale alla
 156     lunghezza della statements list + 1. Lo stato i-esimo della lista di stati
 157     e' lo stato di matita _prima_ dell'esecuzione dell i-esimo statement
 158   - una stringa, detta "future text", corrispondente alla parte di testo dello
 159     script non ancora valutata. L'ultimo stato della state list e' lo stato
 160     corrente di matita
 161 - relazione tra modello e buffer di testo gtk
 162   - le modifiche al testo del buffer sono possibili solo nella parta non ancora
 163     valutata. Ognuna di esse viene apportata _anche_ al future text
 164   - invariante: e' sempre possibile riscrivere ("redraw") l'intero contenuto del
 165     buffer di testo a partire dal modello, attributi compresi
 166 - oggetto script
 167   - metodi
 168     - new: gtk_text_buffer -> script
 169     - redraw: unit (* ridisegna il contenuto del buffer di testo *)
 170     - advance: ?statement:string -> unit -> unit
 171         (* valuta il primo statement del future text (usando eval_statement
 172         (puo' fallire con una eccezione)), rimuove il testo corrispondente dal
 173         future text, aggiunge alla statement list una entry per ogni statement
 174         ritornato da eval_statement, aggiunge il nuovo stato alla state list,
 175         invoka tutti gli observer
 176         Se c'e' l'argomento opzionale statement, quello e' il testo che viene
 177         passato ad eval_statement, se ha successo nessuna rimozione dal future
 178         text viene effettuata *)
 179     - retract: unit -> unit
 180         (* sposta l'ultimo statement della statement list al future text, toglie
 181         l'ultimo stato della state list, MatitaSync.time_travel
 182         ~present:ultimo_stato ~past:stato_precedente *)
 183     - private eval_statement: string -> MatitaTypes.status * string list
 184         (* parsa lo statement
 185         - se e' un Command o un Tactical (vedi TacticAst) invoca MatitaEngine
 186           passando lo stato corrente
 187         - se e' una Macro la gestisce (= tutte le Macro sono implementate qua)
 188           Ritorna una lista di coppie <stato, statement>. La proiezione sulla
 189           prima componente rappresenta gli stati da aggiungere alla state list;
 190           quella sulla seconda gli statement da aggiungere alla statement list.
 191         *)
 192     (* gestione degli observer *)
 193     - add_observer: (MatitaTypes.status -> unit) -> observer_id
 194     - remove_observer: observer_id -> unit
 195     (* gestione del salvataggio *)
 196     - save_to: string -> unit        (* ridisegna su file *)
 197     - load_from: string -> unit
 198         (* retract fino allo stato zero, nuovo stato con future text pari al
 199         contenuto del file passato *)
 200