helm/matita/matita.txt

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