helm/matita/matita.txt

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