helm/matita/matita.txt

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