ROADMAP 35.3 KB
Newer Older
MARCHE Claude's avatar
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 6 7 8 9 10 11

== projects ==

* modules, raffinement, these de Leon

* 

MARCHE Claude's avatar
MARCHE Claude committed
12
== Papers to write ==
Jean-Christophe Filliatre's avatar
Jean-Christophe Filliatre committed
13

14 15 16 17
  * paper on the module system, its semantics, realizations, avec en
    particulier la solution avec les types classes qui reste a
    implanter

MARCHE Claude's avatar
MARCHE Claude committed
18
  * DONE paper on the proof management system
MARCHE Claude's avatar
MARCHE Claude committed
19

20
  * DONE Encodings and transformations (Andrei+Francois FroCos 11)
21
  * DONE Why presentation at the IVL workshop of CADE:
22 23
    (http://research.microsoft.com/en-us/um/people/moskal/boogie2011/)
    deadline: May 1st
Jean-Christophe Filliatre's avatar
Jean-Christophe Filliatre committed
24 25
  * Caml code ?
  * logic language for talking to provers
26 27 28
    - DONE (Boogie 11)
    - DONE FOL + poly (FroCos 11)
    -  alg + ind + rec ? + theories
Jean-Christophe Filliatre's avatar
Jean-Christophe Filliatre committed
29
  * VACID-0
MARCHE Claude's avatar
MARCHE Claude committed
30
  * system description (e.g. at CADE, TACAS)
Jean-Christophe Filliatre's avatar
Jean-Christophe Filliatre committed
31
  * rapports recherche ?
MARCHE Claude's avatar
MARCHE Claude committed
32

MARCHE Claude's avatar
MARCHE Claude committed
33
== stages ==
MARCHE Claude's avatar
MARCHE Claude committed
34

MARCHE Claude's avatar
MARCHE Claude committed
35
* M1. preuve d'un petit compilateur, pas de pb de lieur,
MARCHE Claude's avatar
MARCHE Claude committed
36 37
   eventuellement outils pour les preuves par recurrence
   a la Leino, + fct size automatique
MARCHE Claude's avatar
MARCHE Claude committed
38
* M2. Lieur en Why3, POPLmark challenge. vers
MARCHE Claude's avatar
MARCHE Claude committed
39
   un theorie et/ou un module réutilisable de lieurs
MARCHE Claude's avatar
MARCHE Claude committed
40
* (M2?) Stage Airbus, "TIP" avec Frama-C/Jessie ou WP/Why/Coq
MARCHE Claude's avatar
MARCHE Claude committed
41
   besoin de la tactique Coq?
42

MARCHE Claude's avatar
MARCHE Claude committed
43
== new major features ==
MARCHE Claude's avatar
MARCHE Claude committed
44

MARCHE Claude's avatar
MARCHE Claude committed
45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72
* 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


73 74 75 76 77 78
* Projets interessant Cesar ?
** Preuve de prog flottants avec Frama-C+WP+Why3+PVS
** Generation d'annotations
** porter multirounding a jessie->Why3. Completer le mode full et faire passer
   interval_arith.c. Completer la galerie
** preuve sur l'assembleur
MARCHE Claude's avatar
MARCHE Claude committed
79 80
** support de Yices 2 ? interesserait Cesar

81

MARCHE Claude's avatar
MARCHE Claude committed
82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114
==================== Roadmap for release 0.83 ========================

== TODOs ==

* extraction vers Caml
** utiliser ZArith

* replayer
** deplacer option -bench dans une commande de why3session

* terminaison
** generer une obligation de preuve de well-foundedness quand on utilise
   un variant avec "with R" (une seule fois pour chaque R !)
** quand une definition logique recursive ne peut pas etre verifiee
   bien-fondee statiquement, generer une obligation de preuve
   (feature wish de F Besson)

* Coq tactic
** ajout de bases de hint

* IDE
** todo: run detection immediately at start up if conf file absent or
    outdated. should become doable with the new Session module
** "detect provers" menu

* Contre-exemples de Alt-Ergo

* detect editors
*** check if coqide and also emacs/proof-general is installed


* bug 15629

MARCHE Claude's avatar
MARCHE Claude committed
115
==================== Roadmap for release 0.82 ========================
116

MARCHE Claude's avatar
MARCHE Claude committed
117
Scheduled for 31 october 2013
118

119 120
== New Features to announce ==

MARCHE Claude's avatar
MARCHE Claude committed
121 122 123 124 125 126 127
* lemma functions

* polymorphic recursion permitted

* why.el renamed into why3.el

* new provers: 
MARCHE Claude's avatar
MARCHE Claude committed
128
** veriT 201310
MARCHE Claude's avatar
MARCHE Claude committed
129 130 131 132 133 134 135
** Metitarski 2.2
** Metis 2.3
** Beagle 0.4.1
** Princess 2013-05-13
** Yices2 2.0.4

* new versions of provers:
MARCHE Claude's avatar
MARCHE Claude committed
136
** Alt-Ergo 0.95.2 
MARCHE Claude's avatar
MARCHE Claude committed
137
** CVC4 1.1 (& 1.2 ?)
MARCHE Claude's avatar
MARCHE Claude committed
138 139
** Coq 8.4pl2 
** gappa 1.0.0
MARCHE Claude's avatar
MARCHE Claude committed
140
** SPASS 3.8ds 
MARCHE Claude's avatar
MARCHE Claude committed
141

MARCHE Claude's avatar
MARCHE Claude committed
142 143 144 145 146 147 148
* API: more examples of use 

* why3session
** --stats: changed (detailler, temps, distinction root et subgoals, CLAUDE)
**  --hist: TODO documenter (voir Alain ou Mohamed sur les graphes SMT)

* bug fix: PVS configuration and installation
MARCHE Claude's avatar
MARCHE Claude committed
149 150 151 152 153

* bug fix: leading zeros in decimal literals

* bug fix: PVS output, types are nonempty

154 155 156 157
* improved shape mecanism for session updates (see VSTTE'13 paper).
  Compatibility with session files from version 0.81 and earlier is
  assured.

MARCHE Claude's avatar
MARCHE Claude committed
158 159 160 161 162
* bug fix: Coq tactic now loads dynamic plug-ins

* bug fix: Coq output of poly rec types

* BTS 15493, 15053
MARCHE Claude's avatar
MARCHE Claude committed
163 164 165 166 167 168 169 170
* BTS 13736 fixed
https://gforge.inria.fr/tracker/index.php?func=detail&aid=13736&group_id=2990

** syntax highlighting bugs ?
   some keywords are not colored in the bottom-right window
   (but they are in the top-right window)
   FIXED: it was caused by the language file for alt-ergo superseding the one for why3

171 172 173 174 175 176 177
== Final preparation ==

* faire une passe sur le BTS
* do "make update-coq" and "make", fix Coq realizations if needed
* check that nightly bench is OK
* check that "make xml-validate" is OK
  (see below : copy the dtd on the web)
MARCHE Claude's avatar
MARCHE Claude committed
178
* put 0.82 in file Version
179 180 181 182 183 184
* check headers
* check the file CHANGES, add the release date
* manual in PDF: check that macro \todo is commented out
    in ./macros.tex, and then "make doc"
* manual in HTML: "make doc/html/index.html"
* do "make distrib"
MARCHE Claude's avatar
MARCHE Claude committed
185
* test distrib/why3-0.82.tar.gz
186 187 188 189
* install web page for why2 which includes an updated page for the
  quick migration guide. (sources are in CVS repository
  ~filliatr/ARCHIVE/www/why)
* put on the web page
MARCHE Claude's avatar
MARCHE Claude committed
190 191
 - why3-0.82.tar.gz
   cp distrib/why3-0.82.tar.gz /users/www-perso/projets/why3/download
192 193

 - the manual in PDF
MARCHE Claude's avatar
MARCHE Claude committed
194
   cp doc/manual.pdf /users/www-perso/projets/why3/download/manual-0.82.pdf
195

196
 - the HTML version of the manual (content of doc/html)
MARCHE Claude's avatar
MARCHE Claude committed
197
   cp -r doc/html /users/www-perso/projets/why3/doc-0.82
198

199
 - why3session.dtd
200 201
   cp share/why3session.dtd /users/www-perso/projets/why3/

202 203
 - standard library online, using why3doc, to http://why3.lri.fr/stdlib/
   make stdlibdoc
MARCHE Claude's avatar
MARCHE Claude committed
204
   cp -r doc/stdlibdoc /users/www-perso/projets/why3/stdlib-0.82
205
   rm /users/www-perso/projets/why3/stdlib
MARCHE Claude's avatar
MARCHE Claude committed
206
   ln -s /users/www-perso/projets/why3/stdlib-0.82 \
207 208 209
            /users/www-perso/projets/why3/stdlib
 - API doc, produced using ocamldoc, to http://why3.lri.fr/api/
    make apidoc
MARCHE Claude's avatar
MARCHE Claude committed
210
    cp -r doc/apidoc /users/www-perso/projets/why3/api-0.82
211
    rm /users/www-perso/projets/why3/api
MARCHE Claude's avatar
MARCHE Claude committed
212
    ln -s /users/www-perso/projets/why3/api-0.82 \
213 214
      /users/www-perso/projets/why3/api
   PROBLEME avec style.css
MARCHE Claude's avatar
MARCHE Claude committed
215
 - update the main HTML page (sources are in repository why3-www)
216 217 218
   edit index.html
   make export

MARCHE Claude's avatar
MARCHE Claude committed
219 220 221 222
 - add links to extra resources like
   http://why3.lri.fr/jfla-2012/, http://www.lri.fr/~marche/MPRI-2-36-1/,
   page du cours de l'X (in french ? using Krakatoa/why3 bridge)

223 224 225
 - make everything writeable for the group
   chmod -R g+w /users/www-perso/projets/why3

MARCHE Claude's avatar
MARCHE Claude committed
226
* make a last commit:
MARCHE Claude's avatar
MARCHE Claude committed
227 228 229
 - git commit -m "release 0.82"
 - add tag 0.82 to the git repository, using
   git tag 0.82
MARCHE Claude's avatar
MARCHE Claude committed
230 231 232 233
 - do not forget to push it using
   git push
   git push --tags

Guillaume Melquiond's avatar
Guillaume Melquiond committed
234 235
* add a new version to the bugtracker:
  https://gforge.inria.fr/tracker/admin/?group_id=2990&atid=10293&add_extrafield=1
236

MARCHE Claude's avatar
MARCHE Claude committed
237
* produce the Why3 part of Toccata gallery
238
  -> add also a tar.gz and a ZIP file of it (this is done by doing
MARCHE Claude's avatar
MARCHE Claude committed
239
  "make gallery-files" in the sources of the Toccata web pages)
240 241 242 243 244 245
* Announce the distrib
 - What to put in the announcement: see New Features above
* The next commit : add +git to the version in file Version

== TODOs ==

MARCHE Claude's avatar
MARCHE Claude committed
246
* discriminate, mettre les bons arguments par defaut (ANDREI)
247

MARCHE Claude's avatar
MARCHE Claude committed
248 249 250 251
* tester avant la release sur
** BWare
** Prouveur de Martin
** examples de Frama-C/Jessie et Krakatoa
252

MARCHE Claude's avatar
MARCHE Claude committed
253
* Coq detection (et PVS) (CLAUDE, champ supplementaire compile_support = yes dans le prover-detection-data)
254 255 256
** refuser de detecter Coq si on n'a pas compilé avec le support de Coq
   (i.e. si Coq a ete installé apres)

MARCHE Claude's avatar
MARCHE Claude committed
257 258
* Coq tactic (CLAUDE, GUILLAUME, JCF, ANDREI)
** bug Prod(_,_,_) -> traiter le cas
MARCHE Claude's avatar
MARCHE Claude committed
259 260

* efficiency issues
MARCHE Claude's avatar
MARCHE Claude committed
261
 - understand problems when large number of goals (cf D Mentré examples)
MARCHE Claude's avatar
MARCHE Claude committed
262
 - prouveur de Martin
MARCHE Claude's avatar
MARCHE Claude committed
263

264 265
* Smoke detector and absurd: on pourrait mettre un label particulier
  sur le "false" genéré par absurd, pour indiquer que c'est
MARCHE Claude's avatar
MARCHE Claude committed
266 267
  intentionel que l'on veuille prouver false. FAIT 
  Un tel cas pourrait etre
268 269
  traité de facon speciale par le smoke detector avec option "deep",
  pour eviter une fausse alarme.
MARCHE Claude's avatar
MARCHE Claude committed
270
  PAS FAIT
271 272

* faire le menage dans les transformations d'induction : _int _ty
MARCHE Claude's avatar
MARCHE Claude committed
273
  _ty_lex, FAIT et DOCUMENTER PAS FAIT
274 275 276

* Documentation
 - (ANDREI) make the glossary available
MARCHE Claude's avatar
MARCHE Claude committed
277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292
 - (CLAUDE) complete api.tex: explain how to build/apply
   transformations, write new functions on terms 
 - LEON: add a section "further reading"

* bug fix: 16454 (ne pas envoyer des triggers arithmetiques) (GUILLAUME)

* bug fix: 15652 (ghost code detection)

* support for new provers
** Alt-Ergo 0.95.2 DONE
** CVC4 1.2 TODO: pb avec les booleens 
** Coq 8.4pl2 TODO: probleme tactique Why3 ???
** Metitarski TODO: improve it (CLAUDE, GUILLAUME)
** others ?


293

Guillaume Melquiond's avatar
Guillaume Melquiond committed
294

MARCHE Claude's avatar
MARCHE Claude committed
295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410

==================== Roadmap for release 0.81 ========================

released on March 25th, 2013

== New Features to announce ==

  o [logic] accept type expressions in clone substitutions
  o [whyml] support for relation chains (e.g., "e1 = e2 < e3")
  * [whyml] every exception raised in a function must be listed
    in as "raises { ... }" clause. A postcondition may be omitted
    and equals to "true" by default.
  * [whyml] if a function definition contains a "writes { ... }"
    clause, then every write effect must be listed. If a function
    definition contains a "reads { ... }" clause, then every read
    _and_ write effect must be listed.
  * [drivers] syntax rules, metas, and preludes are inherited
    through cloning. Keyword "cloned" becomes unnecessary and
    is not accepted anymore.
  o [why3ide] allow several files on the command-line
  o [ocaml API] incompatible changes in Set/Map/Hashtbl modules
  o [ocaml API] examples in the manual extended to API for Why3ml programs
  o [stdlib] fixed inconsistency in map.MapPermut theory
  o [prover] fixed Coq 8.4 support for theory real.Trigonometry
  o [prover] support for Gappa up to 0.16.6
  o [prover] support for Z3 4.2, 4.3.*
  o [prover] support for Alt-Ergo 0.95.1
  o [prover] support for CVC4
  o [prover] support for PVS 6
  o [prover] experimental support for mathematica
  o [prover] experimental support for MathSAT5
  o [examples] several new examples, including solutions to the
    VerifyThis@fm2012 challenges

== Final preparation ==

* faire une passe sur le BTS
* do "make update-coq" and "make", fix Coq realizations if needed
* check that nightly bench is OK
* check that "make xml-validate" is OK
  (see below : copy the dtd on the web)
* put 0.81 in file Version
* check headers
* check the file CHANGES, add the release date
* manual in PDF: check that macro \todo is commented out
    in ./macros.tex, and then "make doc"
* manual in HTML: "make doc/html/index.html"
* do "make distrib"
* test distrib/why3-0.81.tar.gz
* install web page for why2 which includes an updated page for the
  quick migration guide. (sources are in CVS repository
  ~filliatr/ARCHIVE/www/why)
* put on the web page
 - why3-0.81.tar.gz
   cp distrib/why3-0.81.tar.gz /users/www-perso/projets/why3/download

 - the manual in PDF
   cp doc/manual.pdf /users/www-perso/projets/why3/download/manual-0.81.pdf

 - the HTML version of the manual (content of doc/html)
   cp -r doc/html /users/www-perso/projets/why3/doc-0.81

 - why3session.dtd
   cp share/why3session.dtd /users/www-perso/projets/why3/

 - standard library online, using why3doc, to http://why3.lri.fr/stdlib/
   make stdlibdoc
   cp -r doc/stdlibdoc /users/www-perso/projets/why3/stdlib-0.81
   rm /users/www-perso/projets/why3/stdlib
   ln -s /users/www-perso/projets/why3/stdlib-0.81 \
            /users/www-perso/projets/why3/stdlib
 - API doc, produced using ocamldoc, to http://why3.lri.fr/api/
    make apidoc
    cp -r doc/apidoc /users/www-perso/projets/why3/api-0.81
    rm /users/www-perso/projets/why3/api
    ln -s /users/www-perso/projets/why3/api-0.81 \
      /users/www-perso/projets/why3/api
   PROBLEME avec style.css
 - update the main HTML page (sources are in repository why3-www)
   edit index.html
   make export

 - add links to extra resources like
   http://why3.lri.fr/jfla-2012/, http://www.lri.fr/~marche/MPRI-2-36-1/,
   page du cours de l'X (in french ? using Krakatoa/why3 bridge)

 - make everything writeable for the group
   chmod -R g+w /users/www-perso/projets/why3

* make a last commit:
 - git commit -m "release 0.81"
 - add tag 0.81 to the git repository, using
   git tag 0.81
 - do not forget to push it using
   git push
   git push --tags

* add a new version to the bugtracker:
  https://gforge.inria.fr/tracker/admin/?group_id=2990&atid=10293&add_extrafield=1

* produce the Why3 part of Toccata gallery
  -> add also a tar.gz and a ZIP file of it (this is done by doing
  "make gallery-files" in the sources of the Toccata web pages)
* Announce the distrib
 - What to put in the announcement: see New Features above
* The next commit : add +git to the version in file Version

== TODOs ==

* extraction vers Caml
 - PRIORITAIRE, JCF, ANDREI

* Documentation
 - (CLAUDE) complete api.tex: explain how to build theories


411 412 413
==================== Roadmap for release 0.80 ========================

Change in programs' input syntax deserves incrementing version to 0.80
414

415
scheduled on Oct 2012
416

MARCHE Claude's avatar
MARCHE Claude committed
417 418
== New Features to announce ==

419 420
Programs:
  o new concrete syntax for programs
421
  o new API for programs
422
  o type invariants
423
  o ghost code
424

425
Transformations:
426 427
  o induction (experimental, undocumented)
  o bisection (experimental, undocumented)
428

429
Provers support:
430
  o support for Coq 8.4
431
  o dropped support for Coq 8.2
432
  o support for forthcoming PVS 6.0, including realizations
433
  o support for iProver and Zenon
434

435
Misc:
Claude Marche's avatar
Claude Marche committed
436
  o improved output of "why3session latex"
MARCHE Claude's avatar
MARCHE Claude committed
437
    (incompatible changes in LaTeX macros)
Claude Marche's avatar
Claude Marche committed
438
  o [replayer] new option -q for running quietly
439 440 441 442 443
  o a warning is emitted for unused bound logic variables in "forall",
    "exists" and "let"
  o a warning is emitted for any occurrence of a formula of the form
    "exists x, P -> Q". Formulas of this form are usually a user
    mistake. If this is intended, one can write "exists x, not P \/ Q"
Claude Marche's avatar
Claude Marche committed
444
    instead
MARCHE Claude's avatar
MARCHE Claude committed
445

446
Bug fixes:
447
  o Coq output uses type classes to ensure Why3 types are inhabited
MARCHE Claude's avatar
MARCHE Claude committed
448 449 450 451
  o fixed bug on merging config files which prevented the use
    of Why3 back-end of the Frama-C/Jessie plugin when Coq is
    not installed. (Bug 14672 of the Bug Tracking System)
  o fixed bugs 13503 and 13375 of the Bug Tracking System
MARCHE Claude's avatar
MARCHE Claude committed
452 453 454

== Final preparation ==

MARCHE Claude's avatar
MARCHE Claude committed
455
* faire une passe sur le BTS
456
* do "make update-coq" and "make", fix Coq realizations if needed
MARCHE Claude's avatar
MARCHE Claude committed
457 458
* check that nightly bench is OK
* check that "make xml-validate" is OK
MARCHE Claude's avatar
MARCHE Claude committed
459
  (see below : copy the dtd on the web)
MARCHE Claude's avatar
MARCHE Claude committed
460
* put 0.80 in file Version
MARCHE Claude's avatar
MARCHE Claude committed
461
* check headers
462
* check the file CHANGES, add the release date
MARCHE Claude's avatar
MARCHE Claude committed
463 464
* manual in PDF: check that macro \todo is commented out
    in ./macros.tex, and then "make doc"
465
* manual in HTML: "make doc/html/index.html"
MARCHE Claude's avatar
MARCHE Claude committed
466
* do "make distrib"
MARCHE Claude's avatar
MARCHE Claude committed
467
* test the distrib why3-0.80.tar.gz
MARCHE Claude's avatar
MARCHE Claude committed
468
* make a last commit:
469
 - add tag 0.80 to the git repository, using git tag 0.80
MARCHE Claude's avatar
MARCHE Claude committed
470
 - do not forget to push it using git push --tags
471 472 473
* install web page for why2 which includes an updated page for the
  quick migration guide. (sources are in CVS repository
  ~filliatr/ARCHIVE/www/why)
MARCHE Claude's avatar
MARCHE Claude committed
474
* put on the web page
MARCHE Claude's avatar
MARCHE Claude committed
475
 - why3-0.80.tar.gz
476
 - the HTML version of the manual (content of doc/html)
MARCHE Claude's avatar
MARCHE Claude committed
477
 - why3session.dtd
MARCHE Claude's avatar
MARCHE Claude committed
478
 - standard library online, using why3doc, to http://why3.lri.fr/stdlib/
479 480 481 482 483
   make stdlibdoc
   cp -r doc/stdlibdoc /users/www-perso/projets/why3/stdlib-0.80
   rm /users/www-perso/projets/why3/stdlib)
   ln -s /users/www-perso/projets/why3/stdlib-0.80 \
            /users/www-perso/projets/why3/stdlib
MARCHE Claude's avatar
MARCHE Claude committed
484
 - API doc, produced using ocamldoc, to http://why3.lri.fr/api/
485 486 487
    make apidoc
    cp -r doc/apidoc /users/www-perso/projets/why3/api-0.80
    rm /users/www-perso/projets/why3/api
MARCHE Claude's avatar
MARCHE Claude committed
488
    ln -s /users/www-perso/projets/why3/api-0.80 \
489 490
      /users/www-perso/projets/why3/api
   PROBLEME avec style.css
MARCHE Claude's avatar
MARCHE Claude committed
491 492
 - update the main HTML page (sources are in why3-papers/www)

493
* produce the Why3 part of ProVal gallery
494
  -> add also a tar.gz and a ZIP file of it (this is done by doing
MARCHE Claude's avatar
MARCHE Claude committed
495
  "make gallery-files" in the sources of the web pages)
MARCHE Claude's avatar
MARCHE Claude committed
496 497 498 499 500 501
* Announce the distrib
 - What to put in the announcement: see New Features above
* The next commit : add +git to the version in file Version

== TODOs ==

502
* DONE (JCF) reject global "val"s in typing environment for logic decls.
MARCHE Claude's avatar
MARCHE Claude committed
503

504
* DONE appliquer les changements de syntaxe des programmes dans la doc : aussi bien dans le tutorial que dans la BNF des manpages
505 506


507
* DONE Sortie PVS, avec mecanisme de realization
508

MARCHE Claude's avatar
MARCHE Claude committed
509
* DONE mettre au propre les loc des fichiers de sessions, en particulier
MARCHE Claude's avatar
MARCHE Claude committed
510 511
  les noms de fichiers doivent etre relatifs au fichier de session
  lui-meme. Utiliser Sysutil.relativize_filename a bon escient.
MARCHE Claude's avatar
MARCHE Claude committed
512

513 514
* DONE sessions: mettre la dtd sur le web et changer l'entête des sessions pour qu'elles
   pointent dessus
515 516


517
* DONE (PRIORITAIRE) Coq output
518 519 520 521 522 523
 - corriger l'incoherence, comprendre si on veut vraiment accepter

  function x : 'a
  (cf: en caml cela ne marche pas)
 Solution proposee: utiliser des types classes, en particulier Inhabited

524
* DONE (PRIORITAIRE), JCF et ANDREI, clone de module
525 526 527 528 529 530 531 532 533 534 535 536 537 538
 - demarche: ecrire une API avec smart constructors garantissant
   le bon typage, et clone sera en premier lieu un de ces constructors
 - cas d'utilisation: range d'entiers de Jessie, Flottants -> double ou single
   containeurs pour Adacore et Claire
 - NON PRIORITAIRE ?
  + regions : strong update
  + ghost code
  + logic symbols used in programs






MARCHE Claude's avatar
MARCHE Claude committed
539 540 541 542 543 544 545 546 547
==================== Roadmap for release 0.73 ========================

== New Features to announce ==

New features:
  o [Why3ml] new construct "abstract e { q }"
  o [Coq output] default tactic is now "intros ..." with a pattern
    that matches the structure of the goal
  o [why3replayer] option -obsolete-only
MARCHE Claude's avatar
MARCHE Claude committed
548
  o co-inductive predicates
MARCHE Claude's avatar
MARCHE Claude committed
549 550
  o new option -e for "why3session latex" allows to specify when to
    split tables in parts
MARCHE Claude's avatar
MARCHE Claude committed
551 552 553 554
  o [Sessions] a small change in the format. This hopefully improves
    the association of old goals and new goals when the input is
    modified.  For compatibility, Why3 is still able to read session
    files in the old format.
555
  o [Provers] support for Z3 4.0
MARCHE Claude's avatar
MARCHE Claude committed
556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574

Bug fix:
  o completed support for the "Out Of Memory" prover result
  o [Coq output] quotes in identifiers remain quotes in Coq
  o workaround for a bug about modulo operator in Alt-Ergo 0.94
  o fixed a consistency issue with set.Fset theory


== Final preparation ==

* check that nightly bench is OK
* put 0.73 in file Version
* 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.73.tar.gz
* make a last commit:
575
 - add tag 0.73 to the git repository
576 577
 - do not forget to push it using git push --tags

MARCHE Claude's avatar
MARCHE Claude committed
578 579
* put on the web page
 - why3-0.73.tar.gz
580 581 582 583 584 585
 - standard library online, using why3doc, to http://why3.lri.fr/stdlib/
   (make stdlibdoc ;
    cp -r doc/stdlibdoc /users/www-perso/projets/why3/stdlib-0.73;
    ln -s /users/www-perso/projets/why3/stdlib-0.73 \
            /users/www-perso/projets/why3/stdlib)
 - API doc, produced using ocamldoc, to http://why3.lri.fr/api/
MARCHE Claude's avatar
MARCHE Claude committed
586
    Note: check that URL of API doc is correct in doc/api.tex line 9.
587 588 589 590
     (make apidoc ;
    cp -r doc/apidoc /users/www-perso/projets/why3/api-0.73;
    ln -s /users/www-perso/projets/why3/api-0.73 \
            /users/www-perso/projets/why3/api    )
MARCHE Claude's avatar
MARCHE Claude committed
591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610
 - update the main HTML page (sources are in why3-papers/www)

* 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

== TODOs ==

* DONE Ajouter un result de prouveur "outofmemory" analogue a "timeout"

* Why3ML new language constructs
** NOT NEEDED ANYMORE sandbox
** DONE abstract e { q }
** DELAYED contract e { q }

* replayer
** DONE option pour ne rejouer que si obsolete

* Documentation
MARCHE Claude's avatar
MARCHE Claude committed
611
 - DELAYED document co-inductive predicates
MARCHE Claude's avatar
MARCHE Claude committed
612 613
 - DONE (CLAUDE) revoir documentation du smoke detector

MARCHE Claude's avatar
MARCHE Claude committed
614 615
==================== Roadmap for release 0.72 ========================

616
== New Features to announce ==
MARCHE Claude's avatar
MARCHE Claude committed
617

618 619 620 621 622 623
* Coq realizations. See manual Chapter xx
* Coq tactic. See manual Chapter xx
* tool why3session, including commands latex, html, stats. See manual Section xx
* tool why3doc. See manual Section xx
* Support for several versions of the same prover, for prover upgrade.
See manual Section xx
MARCHE Claude's avatar
MARCHE Claude committed
624
* Improved IDE:
625
 - left scrollbar, selection of shown or hidden provers, font enlargement
626 627
 - integration of the support for prover upgrade
 - support for selection of alternate editors
628 629
* Complete support for limiting provers' memory usage
* Improved support of Microsoft Windows OS
MARCHE Claude's avatar
MARCHE Claude committed
630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647
* 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
648 649
 - standard library online, using why3doc (make stdlibdoc),
   to http://why3.lri.fr/stdlib/
650
 - API doc, produced using ocamldoc (make apidoc), to http://why3.lri.fr/api/
MARCHE Claude's avatar
MARCHE Claude committed
651
    Note: check that URL of API doc is correct in doc/api.tex line 9.
652
 - update the main HTML page (sources are in why3-papers/www)
MARCHE Claude's avatar
MARCHE Claude committed
653

MARCHE Claude's avatar
MARCHE Claude committed
654 655 656 657
* 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
658
* Announce the why3 tactic on Coq Club
MARCHE Claude's avatar
MARCHE Claude committed
659

MARCHE Claude's avatar
MARCHE Claude committed
660 661
== TODOs ==

662

663
* DONE bug CVC3 avec la division par 0, cf examples/tests-provers/cvc3.why
MARCHE Claude's avatar
MARCHE Claude committed
664

665 666 667
* DONE Document the Coq plugin and tactic
** DONE option timelimit <n>
** DONE renommer "coq-plugin" en "coq-tactic"
668

669
* DONE (JCF, ANDREI) add all examples from the VSTTE 2012 competition
MARCHE Claude's avatar
MARCHE Claude committed
670

671
* DONE (CLAUDE) Ajouter page provers sur le site web why3
MARCHE Claude's avatar
MARCHE Claude committed
672
** !TODO! relire
673

MARCHE Claude's avatar
MARCHE Claude committed
674
* Documentation
MARCHE Claude's avatar
MARCHE Claude committed
675

676
 - DONE traiter les \todo :
677

678 679 680
 DONE install.tex:179:% \todo{que devient l'option -to-known-prover de why3session ?
 DONE manpages.tex:790:% \todo{A adapter en fonction de la decision sur l'upgrade de prover}
 DONE manpages.tex:809:\section{The \texttt{why3doc} tool} \todo{Documenter}
681 682


683 684 685
 - (ANDREI) complete technical.tex: section "Drivers of external
   provers"

686
 - DONE (GUILLAUME) Realisations Coq, comment fait l'utilisateur pour faire
MARCHE Claude's avatar
MARCHE Claude committed
687 688 689 690 691 692 693 694
   ses realisations ne pas oublier de dire que les dependances avec le
   .why ou .mlw: ne sera pas vérifié

 - DONE Documenter l'utilisation de plusieurs versions du meme
   prouveur comme CVC3 et Z3

 - DONE (ANDREI) ajouter option a why3config pour ajouter association
   ident-executable
695
   DONE remplacer le ":" par " " (Arg.Tuple)
696

697
 - DONE (CLAUDE) Documenter les popups qui peuvent apparaitre dans why3ide
MARCHE Claude's avatar
MARCHE Claude committed
698 699
   quand les prouveurs ont changé. Et les mettre au point:

700
   . DONE Lors d'un replay, le dialogue "replace proof" apparait un nombre
MARCHE Claude's avatar
MARCHE Claude committed
701 702 703 704
     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...)

705
   . DONE le dialogue "replace proof" est de toute facon trop large, et les
MARCHE Claude's avatar
MARCHE Claude committed
706 707
   choix possibles sont confus.

708
 - DONE (CLAUDE) meme ordre d'idee: ne pas ecraser "default editor" et
MARCHE Claude's avatar
MARCHE Claude committed
709
   "timelimit"
710
   en fait c'était déjà le cas
MARCHE Claude's avatar
MARCHE Claude committed
711

712
* DONE permettre d'utiliser emacs/proof general a la place de coqide depuis
MARCHE Claude's avatar
MARCHE Claude committed
713
  why3ide
714
*** DONE allow to choose which one the IDE Preferences
715

MARCHE Claude's avatar
MARCHE Claude committed
716
* (CLAUDE) why3session
717
 - DONE passe sur la documentation ecrite par Francois reecrite par Guillaume
718
 - DONE "why3replayer -latex" remplacé par "why3session latex"
719 720
 - DONE "why3html" remplacé par "why3session html"
 - DONE "why3stats" (src/ide/stats.ml) remplacé par "why3session info --stats"
MARCHE Claude's avatar
MARCHE Claude committed
721

722
* (JCF) ameliorer why3doc
723
 - DONE rajouter la production des liens
724
 - DONE produire un index.html
MARCHE Claude's avatar
MARCHE Claude committed
725

726
* DONE provers
MARCHE Claude's avatar
MARCHE Claude committed
727 728 729 730 731 732 733 734
 - DONE (CLAUDE) Ensure that we kill a prover after some time
   (ressurect %T ? with a meaning like twice the value of %t ?),
   because we cannot be sure they always honor their own -timeout
   option.

 - DONE (ANDREI) better use of Alt-Ergo's builtin theories: records,
   enumeration types (Alt-Ergo >= 0.94) => at least two drivers for
   Alt-Ergo, depending on its version number
MARCHE Claude's avatar
MARCHE Claude committed
735

736
* DONE fix bugs and update the BTS
737
 - DONE (CLAUDE) Refreshing the IDE pane for prover output
MARCHE Claude's avatar
MARCHE Claude committed
738

739
* DONE (CLAUDE) IDE:
MARCHE Claude's avatar
MARCHE Claude committed
740
 - DONE enlarge font (menu + shortcut Ctrl-+)
741
 - DONE Ctrl-A to select all rows
MARCHE Claude's avatar
MARCHE Claude committed
742 743 744 745
 - DONE Do not save if not needed
 - DONE ne pas ecrire saving sessions si on ne sauve pas la session
 - DONE add a scrollbar for the left panel

MARCHE Claude's avatar
MARCHE Claude committed
746 747
* DONE (FRANCOIS) move Session module and its dependencies into the
  Why3 library
MARCHE Claude's avatar
MARCHE Claude committed
748 749 750 751 752
 - 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
753

MARCHE Claude's avatar
MARCHE Claude committed
754
======================= Roadmap for release 0.71 ========================
MARCHE Claude's avatar
MARCHE Claude committed
755

MARCHE Claude's avatar
MARCHE Claude committed
756
* DONE Final preparation:
MARCHE Claude's avatar
MARCHE Claude committed
757 758 759 760 761 762 763 764 765 766 767 768 769 770 771
** 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:
772
*** DONE increment the magic number in config
MARCHE Claude's avatar
MARCHE Claude committed
773
*** add a tag to the git repository
774
*** The next commit : increment why3 version
MARCHE Claude's avatar
MARCHE Claude committed
775

776 777 778
* misc
** DONE fix bug with term shapes, not taking triggers into account
** DONE remove prover coq-realize
MARCHE Claude's avatar
MARCHE Claude committed
779

MARCHE Claude's avatar
MARCHE Claude committed
780 781 782 783 784 785 786 787 788 789
* 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
790 791 792
* 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
793
=== Roadmap for third release 0.70, july 2011 ========================
794

795 796
* Final preparation: put on the web page
** why3-0.70.tar.gz
797
** DONE manual in PDF: check that macro \todo can be commented out
798
   from ./macros.tex
799 800
** 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
801 802 803 804 805 806
** 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
807
   - IDE: not necessary to exit to change the input file: just use "reload"
808

809
* The last commit (A):
810
  ** DONE increment the magic number in config
811 812
  ** add a tag to the git repository
  ** The next commit : increment de why3 version
813

814 815
* 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
816

817 818
* DONE document "Make obsolete" (A+C)

819
* DONE update IDE section of starting.tex (C)
820

821
* DONE update doc for why3replayer
MARCHE Claude's avatar
MARCHE Claude committed
822

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

826
* DONE document new IDE features (C)
MARCHE Claude's avatar
MARCHE Claude committed
827

828 829
* DONE doc: citer l'article Boogie 2011 quelque part

Andrei Paskevich's avatar
Andrei Paskevich committed
830 831 832 833 834
* 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)

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

837 838 839 840 841 842
* 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

843 844 845 846
* 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

847
* DONE desactiver "Save" (et editable=false dans la fenetre)
848

849 850
* DONE mettre "Quit" en dernier (C)

851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870
* 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
871

872
* DONE IDE: no more threads
MARCHE Claude's avatar
MARCHE Claude committed
873

874 875 876 877 878
* 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 Filliatre's avatar
Jean-Christophe Filliatre committed
879

880
* DONE IDE: implement "inline" (use transformation inline_goal)
Jean-Christophe Filliatre's avatar
Jean-Christophe Filliatre committed
881
  ** problem 1: detect that transformation did nothing
MARCHE Claude's avatar
MARCHE Claude committed
882
  ** DONE problem 2: reimport from db does apply inline correctly
MARCHE Claude's avatar
MARCHE Claude committed
883

884 885
* DONE IDE: debug "remove" et "clean" qui provoquent des segfaults !!

Jean-Christophe Filliatre's avatar
Jean-Christophe Filliatre committed
886 887
* IDE: ajouter "invalid" comme cas de resultats de preuve
  (utiliser call_provers.proof_result dans gmain)
888
  DONE
MARCHE Claude's avatar
MARCHE Claude committed
889 890


891
=== Roadmap for second release 0.64 ========================================
892

Jean-Christophe Filliatre's avatar
Jean-Christophe Filliatre committed
893 894
* fix local installation
  ** fix local executables names (DONE)
895

Jean-Christophe Filliatre's avatar
Jean-Christophe Filliatre committed
896 897 898 899 900 901 902
* 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,
903
     Partially done - libdir, datadir, loadpath, ... are not written in
Jean-Christophe Filliatre's avatar
Jean-Christophe Filliatre committed
904
     why.conf if they correspond to the default value.
905 906


907
* IDE, file names in DB: use only file names relative to the db file
908
  DONE
909

Jean-Christophe Filliatre's avatar
Jean-Christophe Filliatre committed
910
=== Roadmap for December 2010 ================================================
MARCHE Claude's avatar
MARCHE Claude committed
911 912 913

== Documentation ==

MARCHE Claude's avatar
MARCHE Claude committed
914
1 Introduction (done: suppressed)
915
2 getting started (Claude: done, to be read by others)
MARCHE Claude's avatar
MARCHE Claude committed
916
3 Syntax, tutorial (done: Andrei)
917
4 tutorial for API:
918
** build a task (Claude: done, to be read by others)
MARCHE Claude's avatar
MARCHE Claude committed
919 920 921 922 923
** 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:
924
  (Claude: done, although quite sparse, to be read by others)
925
7 Manpages
926 927
7.1 Compilation, Installation (done)
7.2 external provers (done)
MARCHE Claude's avatar
MARCHE Claude committed
928 929 930 931
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
932
7.7 whybench (done, to be read by others)
MARCHE Claude's avatar
MARCHE Claude committed
933 934 935
7.8 why.conf (done)
7.9 drivers (to be done later)
7.10 transformations (done)
936
8 API: Andrei + Francois
937
  (should we really add that in the doc ?)
MARCHE Claude's avatar
MARCHE Claude committed
938 939
** on remplace par la version HTML a mettre sur la forge INRIA (Francois)
** TODO: mettre un titre au HTML engendré
MARCHE Claude's avatar
MARCHE Claude committed
940 941 942 943 944

== IDE ==

(Claude)

MARCHE Claude's avatar
MARCHE Claude committed
945 946 947 948
* database, session save and restore (done)
* Coq output (done)
* Gappa output (done)
* debug hide goals (TODO)
949
* add "context" options (partially done)
MARCHE Claude's avatar
MARCHE Claude committed
950
** semantics not clear, should be clarified, documented and
951
   implemented accordingly
MARCHE Claude's avatar
MARCHE Claude committed
952
* add transf "inline goal" (to be done later)
953
* add button "remove"
MARCHE Claude's avatar
MARCHE Claude committed
954 955 956
** removing goals: done
** removing transformation: done, but subgoals stay in db (not critical)
* add button "replay" (to be done later)
957
** semantics: replay obsolete proofs
MARCHE Claude's avatar
MARCHE Claude committed
958 959 960

== Misc ==

MARCHE Claude's avatar
MARCHE Claude committed
961 962 963
* README (done)
* INSTALL (done)
* LICENSE (done)
MARCHE Claude's avatar
MARCHE Claude committed
964
* OCAML-LICENSE (done)
965
* TODO: licence pour les boomy icons
MARCHE Claude's avatar
MARCHE Claude committed
966

MARCHE Claude's avatar
MARCHE Claude committed
967 968
* debuguer cpulimit pour gappa (pb de return code)

MARCHE Claude's avatar
MARCHE Claude committed
969
* option --version a tous les executables (done, except IDE: bug 11604)
970
** + affichage dans l'IDE (done)
MARCHE Claude's avatar
MARCHE Claude committed
971
* Builtin arrays in provers (done)
MARCHE Claude's avatar
MARCHE Claude committed
972
* make install (done)
MARCHE Claude's avatar
MARCHE Claude committed
973
* make distrib (done)
MARCHE Claude's avatar
MARCHE Claude committed
974
* "make -j" (done)
975
* META for ocamlfind (done)
MARCHE Claude's avatar
MARCHE Claude committed
976
* headers (done)
MARCHE Claude's avatar
MARCHE Claude committed
977

MARCHE Claude's avatar
MARCHE Claude committed
978 979 980 981 982 983
== 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
984
from Why versions 2.xx.
Andrei Paskevich's avatar
Andrei Paskevich committed
985 986

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

MARCHE Claude's avatar
MARCHE Claude committed
990
The main new features with respect to Why 2.xx are the following.
MARCHE Claude's avatar
MARCHE Claude committed
991 992 993 994

1) Completely redesigned input syntax for logic declarations

* new syntax for terms and formulas
Andrei Paskevich's avatar
Andrei Paskevich committed
995 996 997
* enumerated and algebraic data types, pattern matching
* recursive definitions of logic functions and predicates,
  with termination checking
MARCHE Claude's avatar
MARCHE Claude committed
998
* inductive definitions of predicates
Andrei Paskevich's avatar
Andrei Paskevich committed
999 1000
* declarations are structured in components called "theories",
  which can be reused and instantiated
MARCHE Claude's avatar
MARCHE Claude committed
1001 1002 1003 1004 1005 1006 1007

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
Andrei Paskevich committed
1008
3) Source code organized as a library with a documented API,
MARCHE Claude's avatar
MARCHE Claude committed
1009
to allow access to Why3 features programmatically.
MARCHE Claude's avatar
MARCHE Claude committed
1010 1011 1012 1013 1014 1015

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
1016
* ability to edit proofs for interactive provers (Coq only for the moment)
MARCHE Claude's avatar
MARCHE Claude committed
1017 1018 1019 1020 1021 1022 1023 1024
  on any subtask

5) Extensible architecture via plugins

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


Andrei Paskevich's avatar
Andrei Paskevich committed
1025
Beware that some Why features are not yet available in Why3:
MARCHE Claude's avatar
MARCHE Claude committed
1026 1027

* There is a VC generator distributed in Why3 in an experimental stage
Andrei Paskevich's avatar
Andrei Paskevich committed
1028 1029
  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
1030 1031 1032 1033

* 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
1034 1035 1036 1037 1038 1039 1040 1041
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
1042 1043 1044 1045 1046 1047 1048 1049



--------------------- 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
1050
from Why. The detailed announcement is attached below.
MARCHE Claude's avatar
MARCHE Claude committed
1051 1052 1053 1054 1055 1056 1057 1058

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
1059
and process the generated Why3 file "<file>.jessie/why/<file>_why3.why"
MARCHE Claude's avatar
MARCHE Claude committed
1060 1061 1062 1063 1064 1065 1066
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
1067
* ability to call Coq on a given VC to provide a proof script. Incidentally,
MARCHE Claude's avatar
MARCHE Claude committed
1068
  this feature can be used to analyse the VC to understand why it is
1069
  not proved automatically.
MARCHE Claude's avatar
MARCHE Claude committed
1070 1071 1072 1073 1074 1075 1076 1077
* 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
MARCHE Claude committed
1078