ROADMAP 17.7 KB
Newer Older
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
1

MARCHE Claude's avatar
MARCHE Claude committed
2

MARCHE Claude's avatar
MARCHE Claude committed
3
============ Long-term Roadmap (see below for roadmaps to next release) ===========
MARCHE Claude's avatar
MARCHE Claude committed
4

MARCHE Claude's avatar
MARCHE Claude committed
5
== Papers to write ==
Jean-Christophe Filliâtre's avatar
Jean-Christophe Filliâtre committed
6

MARCHE Claude's avatar
MARCHE Claude committed
7
  * DONE Encodings and transformations (Andrei+Francois)
8
  * DONE Why presentation at the IVL workshop of CADE:
9 10
    (http://research.microsoft.com/en-us/um/people/moskal/boogie2011/)
    deadline: May 1st
Jean-Christophe Filliâtre's avatar
Jean-Christophe Filliâtre committed
11 12
  * Caml code ?
  * logic language for talking to provers
MARCHE Claude's avatar
MARCHE Claude committed
13
   - FOL + poly + alg + ind + rec ? + theories
Jean-Christophe Filliâtre's avatar
Jean-Christophe Filliâtre committed
14 15 16
  * VACID-0
  * system description (e.g. at CAD, TACAS)
  * rapports recherche ?
MARCHE Claude's avatar
MARCHE Claude committed
17

MARCHE Claude's avatar
MARCHE Claude committed
18
== stages ==
MARCHE Claude's avatar
MARCHE Claude committed
19

MARCHE Claude's avatar
MARCHE Claude committed
20
* M1. preuve d'un petit compilateur, pas de pb de lieur,
MARCHE Claude's avatar
MARCHE Claude committed
21 22
   eventuellement outils pour les preuves par recurrence
   a la Leino, + fct size automatique
MARCHE Claude's avatar
MARCHE Claude committed
23
* M2. Lieur en Why3, POPLmark challenge. vers
MARCHE Claude's avatar
MARCHE Claude committed
24
   un theorie et/ou un module réutilisable de lieurs
MARCHE Claude's avatar
MARCHE Claude committed
25
* (M2?) Stage Airbus, "TIP" avec Frama-C/Jessie ou WP/Why/Coq
26 27
   besoin du plugin Coq?

MARCHE Claude's avatar
MARCHE Claude committed
28
== new major features ==
MARCHE Claude's avatar
MARCHE Claude committed
29

MARCHE Claude's avatar
MARCHE Claude committed
30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58
* Logic language
 - support for higher-order logic
 - rename andb, orb, xorb and notb into and, or, xor and not

* more libraries (theories and modules)

* A true Jessie3 front-end

* Why3ML
 - Fast WP a la Leino
 - assert qui ne donne pas une hypothese dans la suite -> "check"
   also: in a black box

* Add more examples in the regression tests and in the proval gallery

* A literate programming tool for Why3 (JCF)


* IDE:
 - edition, navigation (partially done)
 - saving session: add shortcut "ctrl-S", but beware of confusion with saving the input file
 - reimplement "hide proved goals" feature
  + suggested solution: replace model + filter_model by a custom model
  (JC + ?)
 - restore provers detection in the middle of a session.
 - commentaires dans les sessions, attachés a chaque ligne


=========== Middle-term roadmap ==========================================
MARCHE Claude's avatar
MARCHE Claude committed
59 60

* PRIORITAIRE, JCF et ANDREI, clone de module
MARCHE Claude's avatar
MARCHE Claude committed
61
 - demarche: ecrire une API avec smart constructors garantissant
MARCHE Claude's avatar
MARCHE Claude committed
62
   le bon typage, et clone sera en premier lieu un de ces constructors
MARCHE Claude's avatar
MARCHE Claude committed
63
 - cas d'utilisation: range d'entiers de Jessie, Flottants -> double ou single
MARCHE Claude's avatar
MARCHE Claude committed
64
   containeurs pour Adacore et Claire
MARCHE Claude's avatar
MARCHE Claude committed
65 66 67 68
 - NON PRIORITAIRE ?
  + regions : strong update
  + ghost code
  + logic symbols used in programs
MARCHE Claude's avatar
MARCHE Claude committed
69

MARCHE Claude's avatar
MARCHE Claude committed
70

MARCHE Claude's avatar
MARCHE Claude committed
71
* extraction vers Caml
MARCHE Claude's avatar
MARCHE Claude committed
72
 - PRIORITAIRE, JCF, ANDREI
MARCHE Claude's avatar
MARCHE Claude committed
73

MARCHE Claude's avatar
MARCHE Claude committed
74 75 76
* Coq plugin

* Coq output
MARCHE Claude's avatar
MARCHE Claude committed
77
 - corriger l'incoherence, comprendre si on veut vraiment accepter
MARCHE Claude's avatar
MARCHE Claude committed
78 79 80 81 82

  function x : 'a
  (cf: en caml cela ne marche pas)

* efficiency issues
MARCHE Claude's avatar
MARCHE Claude committed
83 84
 - understand problems when large number of goals (cf D Mentré examples)
 - also: BTS 13736
MARCHE Claude's avatar
MARCHE Claude committed
85 86 87
https://gforge.inria.fr/tracker/index.php?func=detail&aid=13736&group_id=2990


MARCHE Claude's avatar
MARCHE Claude committed
88 89 90
==================== Roadmap for release 0.72 ========================

== New Features to annouce ==
MARCHE Claude's avatar
MARCHE Claude committed
91

MARCHE Claude's avatar
MARCHE Claude committed
92
* Coq Realizations
93
* tool why3session with commands latex, html, stats, etc
MARCHE Claude's avatar
MARCHE Claude committed
94
* tool why3doc
MARCHE Claude's avatar
MARCHE Claude committed
95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121
* Support for several versions of the same prover
* Improved IDE:
 - left scrollbar
 - font enlargement
 - what else ?
* what else ?
* see also the file CHANGES

== Final preparation ==

* check that nightly bench is OK
* put 0.72 in file Version
* increment the magic number in config (needed ???)
* check headers
* check the file CHANGES
* manual in PDF: check that macro \todo is commented out
    in ./macros.tex
* do "make distrib"
* test the distrib why3-0.72.tar.gz
* make a last commit:
 - add tag 0.72 to the git repository (do not forget to push it)
* put on the web page
 - why3-0.72.tar.gz
 - standard library online, using why3doc
 - API doc, produced using ocamldoc, to http://why3.lri.fr/api/
    Note: check that URL of API doc is correct in doc/api.tex line 9.
 - update the main HTML page (where is the sources ?)
MARCHE Claude's avatar
MARCHE Claude committed
122 123 124
 - add links to extra resources like
   http://why3.lri.fr/jfla-2012/, http://www.lri.fr/~marche/MPRI-2-36-1/,
   http://proval.lri.fr/gallery/index.en.html
MARCHE Claude's avatar
MARCHE Claude committed
125 126 127 128
* produce the Why3 part of ProVal gallery ?
* Announce the distrib
 - What to put in the announcement: see New Features above
* The next commit : add +git to the version in file Version
MARCHE Claude's avatar
MARCHE Claude committed
129

MARCHE Claude's avatar
MARCHE Claude committed
130 131
== TODOs ==

132
* (JCF, ANDREI) add all examples from the VSTTE 2012 competition
MARCHE Claude's avatar
MARCHE Claude committed
133 134

* Documentation
MARCHE Claude's avatar
MARCHE Claude committed
135
 - (GUILLAUME) Realisations Coq, comment fait l'utilisateur pour faire ses realisations
MARCHE Claude's avatar
MARCHE Claude committed
136
   ne pas oublier de dire que les dependances avec le .why ou .mlw: ne sera pas vérifié
MARCHE Claude's avatar
MARCHE Claude committed
137 138
 - (WHO?) revoir documentation du smoke detector
 - (WHO?) Documenter l'utilisation de plusieurs version du meme prouveur comme CVC3 et Z3
139 140 141 142 143 144
 - (CLAUDE) Documenter les popups qui peuvent apparaitre dans why3ide quand les prouveurs ont changé. Et les mettre au point:
   . Lors d'un replay, le dialogue "replace proof" apparait un nombre important de fois,
     il faut absolument pouvoir interrompre, ou donner une reponse qui soit appliquée pour le reste.
     (le 3e bouton "never replace..." ne semble pas jourer ce role...)
   . le dialogue "replace proof" est de toute facon trop large, et les choix possibles sont confus.

145
 - DONE (ANDREI) ajouter option a why3config pour ajouter association ident-executable
MARCHE Claude's avatar
MARCHE Claude committed
146 147
 - (CLAUDE) meme ordre d'idee: ne pas ecraser "default editor" et "timelimit"
 - (WHO?) complete api.tex: explain how to build theories, apply
MARCHE Claude's avatar
MARCHE Claude committed
148
   transformations, write new functions on terms (A)
MARCHE Claude's avatar
MARCHE Claude committed
149 150
 - (ANDREI?) complete manpages.tex: section "Drivers of external provers"
 - (WHO?) make the glossary available
MARCHE Claude's avatar
MARCHE Claude committed
151

MARCHE Claude's avatar
MARCHE Claude committed
152 153
* (CLAUDE) why3session
 - passe sur la documentation ecrite par Francois reecrite par Guillaume
154 155 156 157
 - DONE "why3replayer -latex" remplacé par "why3session latex"
 - "why3html" remplacé par "why3session html"
 - "why3stats" (src/ide/stats.ml) remplacé par "why3session stats"
    ou par "why3session info" avec des options
MARCHE Claude's avatar
MARCHE Claude committed
158 159


160
* (JCF) ameliorer why3doc
MARCHE Claude's avatar
MARCHE Claude committed
161
 - rajouter la production des liens
162 163
 - entree makefile pour produire la bibliotheque standard de Why3 en HTML
   (pour mettre sur le site Web)
MARCHE Claude's avatar
MARCHE Claude committed
164 165 166


* provers
MARCHE Claude's avatar
MARCHE Claude committed
167
 - DONE (CLAUDE) Ensure that we kill a prover after some time (ressurect %T ? with a
MARCHE Claude's avatar
MARCHE Claude committed
168 169
   meaning like twice the value of %t ?), because we cannot be sure they always
   honor their own -timeout option.
Andrei Paskevich's avatar
Andrei Paskevich committed
170
 - DONE (ANDREI) better use of Alt-Ergo's builtin theories: records, enumeration types
Jean-Christophe Filliâtre's avatar
Jean-Christophe Filliâtre committed
171 172
   (Alt-Ergo >= 0.94) => at least two drivers for Alt-Ergo, depending on its
   version number
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
173

MARCHE Claude's avatar
MARCHE Claude committed
174 175
* fix bugs and update the BTS
 - (JCF) reject global "val"s in typing environment for logic decls.
176
 - DONE (CLAUDE) Refreshing the IDE pane for prover output
MARCHE Claude's avatar
MARCHE Claude committed
177 178 179

* (CLAUDE) IDE:
 - DONE enlarge font (menu + shortcut Ctrl-+)
180
 - DONE Ctrl-A to select all rows
MARCHE Claude's avatar
MARCHE Claude committed
181 182
 - DONE Do not save if not needed
 - DONE ne pas ecrire saving sessions si on ne sauve pas la session
MARCHE Claude's avatar
MARCHE Claude committed
183
  + todo: run detection immediately at start up if conf file absent or
MARCHE Claude's avatar
MARCHE Claude committed
184
    outdated. should become doable with the new Session module
MARCHE Claude's avatar
MARCHE Claude committed
185
 - syntax highlighting bugs ?
186 187
   some keywords are not colored in the bottom-right window
   (but they are in the top-right window)
188
   NEED FEEDBACK which ones ???
MARCHE Claude's avatar
MARCHE Claude committed
189 190 191 192 193 194 195 196
 - DONE add a scrollbar for the left panel

* DONE (FRANCOIS) move Session module and its dependencies into the Why3 library
 - but avoid duplication with session_ro
 - avoid also duplication of type like prover_data record
 - do not include task and transf in the data type, so that
   one can reload, and redetect provers
 - session + session_ro -> session_data + session_dynamic
MARCHE Claude's avatar
MARCHE Claude committed
197

MARCHE Claude's avatar
MARCHE Claude committed
198
======================= Roadmap for release 0.71 ========================
MARCHE Claude's avatar
MARCHE Claude committed
199

MARCHE Claude's avatar
MARCHE Claude committed
200
* DONE Final preparation:
MARCHE Claude's avatar
MARCHE Claude committed
201 202 203 204 205 206 207 208 209 210 211 212 213 214 215
** put on the web page
*** why3-0.71.tar.gz
*** manual in PDF: check that macro \todo is commented out
    in ./macros.tex
*** API doc in HTML (suggestion: http://why3.lri.fr/api/)
    Note: check that URL of API doc is correct in doc/api.tex line 9.
** What to put in the announcement:
*** traceability from front-ends work
    (see Krakatoa and Jessie of the next release 2.30 of Why2)
*** many new examples in examples/ and examples/programs
*** significantly improved efficiency of WP calculus
*** improved method for matching old and new goals in proof sessions
*** several bug fixes
*** see also the file CHANGES
** The last commit:
216
*** DONE increment the magic number in config
MARCHE Claude's avatar
MARCHE Claude committed
217
*** add a tag to the git repository
MARCHE Claude's avatar
MARCHE Claude committed
218
*** The next commit : increment why3 version
MARCHE Claude's avatar
MARCHE Claude committed
219

MARCHE Claude's avatar
MARCHE Claude committed
220 221 222
* misc
** DONE fix bug with term shapes, not taking triggers into account
** DONE remove prover coq-realize
MARCHE Claude's avatar
MARCHE Claude committed
223

MARCHE Claude's avatar
MARCHE Claude committed
224 225 226 227 228 229 230 231 232 233
* prover support
** DONE test/debug TPTP output, make Vampire work

* IDE:
** saving session
   * DONE add a "cancel" choice in the "ask" window

* DONE replayer: don't replay a goal that has changed, just display as an
  unsuccessful replay

MARCHE Claude's avatar
MARCHE Claude committed
234 235 236
* DONE reload: improve matching of new and old goals by use a kind a distance
  between some notion of shape of a goal

MARCHE Claude's avatar
MARCHE Claude committed
237
=== Roadmap for third release 0.70, july 2011 ========================
238

239 240
* Final preparation: put on the web page
** why3-0.70.tar.gz
241
** DONE manual in PDF: check that macro \todo can be commented out
242
   from ./macros.tex
243 244
** API doc in HTML (suggestion: http://why3.lri.fr/api/)
   Note: check that URL of API doc is correct in doc/api.tex line 9.
MARCHE Claude's avatar
MARCHE Claude committed
245 246 247 248 249 250
** What to put in the annoucement
   - WhyML VC generator to prove programs
   - new tool why3replayer
   - incompatible changes in syntax: function, predicate, and, or
   - session database in XML format instead of sqlite3
   - threads problem in IDE solved (by not using threads anymore)
MARCHE Claude's avatar
MARCHE Claude committed
251
   - IDE: not necessary to exit to change the input file: just use "reload"
252

253
* The last commit (A):
254
  ** DONE increment the magic number in config
255 256
  ** add a tag to the git repository
  ** The next commit : increment de why3 version
257

258 259
* DONE Distribution of examples: we should distribute those who have an xml file
  under git, and distribute the XML and Coq proofs (JC)
MARCHE Claude's avatar
MARCHE Claude committed
260

MARCHE Claude's avatar
MARCHE Claude committed
261 262
* DONE document "Make obsolete" (A+C)

263
* DONE update IDE section of starting.tex (C)
264

265
* DONE update doc for why3replayer
MARCHE Claude's avatar
MARCHE Claude committed
266

MARCHE Claude's avatar
MARCHE Claude committed
267 268 269
* DONE fix bug 12934 : Coq syntax
  https://gforge.inria.fr/tracker/index.php?func=detail&aid=12934&group_id=2990&atid=10293

270
* DONE document new IDE features (C)
MARCHE Claude's avatar
MARCHE Claude committed
271

272 273
* DONE doc: citer l'article Boogie 2011 quelque part

Andrei Paskevich's avatar
Andrei Paskevich committed
274 275 276 277 278
* DONE deplacer le bouton "Cancel" dans le menu "tools",
  le renommer en "make obsolete"

* DONE Check if remark in doc/api.tex line 80 is still valid (A)

279 280
* DONE put an up-to-date use_api.ml in the manual (C)

281 282 283 284 285 286
* DONE enlever les caracteres de tab des sources
  et les caracteres latin1 (A)

* DONE faire tourner headache pour refabriquer les headers (A)
  ** dans gappa.ml : ajouter Guillaume en dessous de l'entete

287 288 289 290
* DONE Rendre optionnel la question "would you like to save the session ?"
   (C) -> 3-state options (Yes/No/ask) dans la config
  + DONE dans le menu "file" : "save session" sans raccourci clavier

291
* DONE desactiver "Save" (et editable=false dans la fenetre)
292

293 294
* DONE mettre "Quit" en dernier (C)

295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314
* DONE checkout frais, compilation (local ou non) et make bench chaque nuit sur moloch
  (?)

* DONE IDE: reload
  (claude)

* DONE BD : se passer de sqlite3
  (Claude)
  Solution: un unique fichier XML, qui est ecrit mais pas
  tres souvent (pas plus d'une fois par seconde)
  ne pas oublier neanmoins de mettre une action dans Timeout
  qui enregistre au bout d'un moment
  pb: n'est pas independant de l'IDE, peut-on faire un module
  independant de l'IDE ? qui serait utilisé par why3bench ?

* DONE IDE: avoir des transformations non codees en dur
  (Claude d'abord)

* DONE Bug des md5
  (Claude. pas reproductible ? Pb de duplication des buts ?)
MARCHE Claude's avatar
MARCHE Claude committed
315

316
* DONE IDE: no more threads
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
317

318 319 320 321 322
* DONE proof replay
  ** DONE IDE: replay all obsolete but previously successful proofs
  ** DONE in why3replay in whybench
  ** DONE add replay of existing proofs in "make bench" to detect regression
  ** DONE add automatic recompilation, install and bench every night on moloch
Jean-Christophe Filliâtre's avatar
Jean-Christophe Filliâtre committed
323

324
* DONE IDE: implement "inline" (use transformation inline_goal)
Jean-Christophe Filliâtre's avatar
Jean-Christophe Filliâtre committed
325
  ** problem 1: detect that transformation did nothing
MARCHE Claude's avatar
MARCHE Claude committed
326
  ** DONE problem 2: reimport from db does apply inline correctly
MARCHE Claude's avatar
MARCHE Claude committed
327

328 329
* DONE IDE: debug "remove" et "clean" qui provoquent des segfaults !!

Jean-Christophe Filliâtre's avatar
Jean-Christophe Filliâtre committed
330 331
* IDE: ajouter "invalid" comme cas de resultats de preuve
  (utiliser call_provers.proof_result dans gmain)
332
  DONE
MARCHE Claude's avatar
MARCHE Claude committed
333 334


335
=== Roadmap for second release 0.64 ========================================
336

Jean-Christophe Filliâtre's avatar
Jean-Christophe Filliâtre committed
337 338
* fix local installation
  ** fix local executables names (DONE)
339

Jean-Christophe Filliâtre's avatar
Jean-Christophe Filliâtre committed
340 341 342 343 344 345 346
* fix problems with .why.conf (DONE)
  ** if we distribute the current state, users who already have a ~/.why.conf
     will get a error message because of missing loadpath to modules
     Done? - the magic number will force to not use the old ~/.why.conf of
             the user
  ** generally speaking, we should rethink the design of that .why.conf: avoid
     absolute paths,
347
     Partially done - libdir, datadir, loadpath, ... are not written in
Jean-Christophe Filliâtre's avatar
Jean-Christophe Filliâtre committed
348
     why.conf if they correspond to the default value.
349 350


351
* IDE, file names in DB: use only file names relative to the db file
352
  DONE
353

Jean-Christophe Filliâtre's avatar
Jean-Christophe Filliâtre committed
354
=== Roadmap for December 2010 ================================================
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
355 356 357

== Documentation ==

MARCHE Claude's avatar
MARCHE Claude committed
358
1 Introduction (done: suppressed)
359
2 getting started (Claude: done, to be read by others)
MARCHE Claude's avatar
MARCHE Claude committed
360
3 Syntax, tutorial (done: Andrei)
361
4 tutorial for API:
362
** build a task (Claude: done, to be read by others)
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
363 364 365 366 367
** call a prover (Claude: done, to be read by others)
** apply a transformation (a completer plus tard)
** develop a new transformation (a completer plus tard)
5 syntax reference (a completer plus tard par typage et semantique)
6 Standard lib of theories:
368
  (Claude: done, although quite sparse, to be read by others)
369
7 Manpages
370 371
7.1 Compilation, Installation (done)
7.2 external provers (done)
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
372 373 374 375
7.3 why3config (done)
7.4 why3 (done)
7.5 whyml (done)
7.6 IDE (done)
François Bobot's avatar
François Bobot committed
376
7.7 whybench (done, to be read by others)
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
377 378 379
7.8 why.conf (done)
7.9 drivers (to be done later)
7.10 transformations (done)
380
8 API: Andrei + Francois
381
  (should we really add that in the doc ?)
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
382 383
** on remplace par la version HTML a mettre sur la forge INRIA (Francois)
** TODO: mettre un titre au HTML engendré
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
384 385 386 387 388

== IDE ==

(Claude)

MARCHE Claude's avatar
MARCHE Claude committed
389 390 391 392
* database, session save and restore (done)
* Coq output (done)
* Gappa output (done)
* debug hide goals (TODO)
393
* add "context" options (partially done)
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
394
** semantics not clear, should be clarified, documented and
395
   implemented accordingly
MARCHE Claude's avatar
MARCHE Claude committed
396
* add transf "inline goal" (to be done later)
397
* add button "remove"
MARCHE Claude's avatar
MARCHE Claude committed
398 399 400
** removing goals: done
** removing transformation: done, but subgoals stay in db (not critical)
* add button "replay" (to be done later)
401
** semantics: replay obsolete proofs
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
402 403 404

== Misc ==

MARCHE Claude's avatar
MARCHE Claude committed
405 406 407
* README (done)
* INSTALL (done)
* LICENSE (done)
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
408
* OCAML-LICENSE (done)
409
* TODO: licence pour les boomy icons
MARCHE Claude's avatar
MARCHE Claude committed
410

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
411 412
* debuguer cpulimit pour gappa (pb de return code)

MARCHE Claude's avatar
MARCHE Claude committed
413
* option --version a tous les executables (done, except IDE: bug 11604)
414
** + affichage dans l'IDE (done)
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
415
* Builtin arrays in provers (done)
MARCHE Claude's avatar
MARCHE Claude committed
416
* make install (done)
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
417
* make distrib (done)
MARCHE Claude's avatar
MARCHE Claude committed
418
* "make -j" (done)
419
* META for ocamlfind (done)
MARCHE Claude's avatar
MARCHE Claude committed
420
* headers (done)
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
421

MARCHE Claude's avatar
MARCHE Claude committed
422 423 424 425 426 427
== Mails announcement ==

----------------------- Why-discuss list ---------------------------

We are happy to announce the first public release of Why3, also known
as the Why platform next generation. It is a new project, independent
MARCHE Claude's avatar
MARCHE Claude committed
428
from Why versions 2.xx.
Andrei Paskevich's avatar
roadmap  
Andrei Paskevich committed
429 430

The home web page of Why3 is http://why3.gforge.inria.fr, where you
431
can find the source distribution and the manual. See the manual for
MARCHE Claude's avatar
MARCHE Claude committed
432 433
installation instructions and contact information.

MARCHE Claude's avatar
MARCHE Claude committed
434
The main new features with respect to Why 2.xx are the following.
MARCHE Claude's avatar
MARCHE Claude committed
435 436 437 438

1) Completely redesigned input syntax for logic declarations

* new syntax for terms and formulas
Andrei Paskevich's avatar
roadmap  
Andrei Paskevich committed
439 440 441
* enumerated and algebraic data types, pattern matching
* recursive definitions of logic functions and predicates,
  with termination checking
MARCHE Claude's avatar
MARCHE Claude committed
442
* inductive definitions of predicates
Andrei Paskevich's avatar
roadmap  
Andrei Paskevich committed
443 444
* declarations are structured in components called "theories",
  which can be reused and instantiated
MARCHE Claude's avatar
MARCHE Claude committed
445 446 447 448 449 450 451

2) More generic handling of goals and lemmas to prove

* concept of proof task
* generic concept of task transformation
* generic approach for communicating with external provers

Andrei Paskevich's avatar
roadmap  
Andrei Paskevich committed
452
3) Source code organized as a library with a documented API,
MARCHE Claude's avatar
MARCHE Claude committed
453
to allow access to Why3 features programmatically.
MARCHE Claude's avatar
MARCHE Claude committed
454 455 456 457 458 459

4) GUI with new features w.r.t. the former GWhy

* session save and restore
* prover calls in parallel
* splitting, and more generally applying task transformations, on demand
460
* ability to edit proofs for interactive provers (Coq only for the moment)
MARCHE Claude's avatar
MARCHE Claude committed
461 462 463 464 465 466 467 468
  on any subtask

5) Extensible architecture via plugins

* users can define new transformations
* users can add connections to additional provers


Andrei Paskevich's avatar
roadmap  
Andrei Paskevich committed
469
Beware that some Why features are not yet available in Why3:
MARCHE Claude's avatar
MARCHE Claude committed
470 471

* There is a VC generator distributed in Why3 in an experimental stage
Andrei Paskevich's avatar
roadmap  
Andrei Paskevich committed
472 473
  and intentionally undocumented in the current documentation (the input
  syntax for programs may change a lot in the future).
MARCHE Claude's avatar
MARCHE Claude committed
474 475 476 477

* There is no front-end for other languages like C or Java. However,
  the last release Why 2.28 is able to use Why3 as a back-end

MARCHE Claude's avatar
MARCHE Claude committed
478 479 480 481 482 483 484 485
Notice that Why3 is expected to replace Why2 in the future. As such,
it is the project where improvements and new features will be
implemented. As this is the first public release of Why3, it is likely
that missing features, and possibly bugs, will raise soon. Please
report those in the bug tracker, we will do our best to fix them and
provide new releases in a short time.


MARCHE Claude's avatar
MARCHE Claude committed
486 487 488 489 490 491 492 493



--------------------- Frama-C list ----------------------------


The first release of Why3, also known as the Why platform next
generation, is publicly available. Why3 is a new project, independent
MARCHE Claude's avatar
MARCHE Claude committed
494
from Why. The detailed announcement is attached below.
MARCHE Claude's avatar
MARCHE Claude committed
495 496 497 498 499 500 501 502

The Jessie plugin of the Why release 2.28 has the ability to use Why3
as back-end. You must install both Why 2.28 and Why3 for this to work.

Using the Why3 GUI on a C file is done as follows
  frama-c -jessie -jessie-atp why3ide <file>.c
(You can also run it in batch mode using
  frama-c -jessie -jessie-atp why3 <file>.c
503
and process the generated Why3 file "<file>.jessie/why/<file>_why3.why"
MARCHE Claude's avatar
MARCHE Claude committed
504 505 506 507 508 509 510
with Why3 batch tools).

The main new features of interest in the GUI are

* new provers available
* calling provers in parallel
* splitting on demand
MARCHE Claude's avatar
MARCHE Claude committed
511
* ability to call Coq on a given VC to provide a proof script. Incidentally,
MARCHE Claude's avatar
MARCHE Claude committed
512
  this feature can be used to analyse the VC to understand why it is
513
  not proved automatically.
MARCHE Claude's avatar
MARCHE Claude committed
514 515 516 517 518 519 520 521
* proof session saved and restored at startup

Any question, remark or bug report concerning only Why3 should be done
using the Why3 public discussion list and bug tracker.




MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
522