helm/matita/matita.txt

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