helm/matita/matita.txt

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