helm/matita/matita.txt

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