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