helm/matita/matita.txt

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