helm/matita/matita.txt

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