Une MAJ de sécurité est nécessaire sur notre version actuelle. Elle sera effectuée lundi 02/08 entre 12h30 et 13h. L'interruption de service devrait durer quelques minutes (probablement moins de 5 minutes).

ROADMAP 56.4 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

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
6
== long-term projects ==
MARCHE Claude's avatar
MARCHE Claude committed
7

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
8 9
* entiers machines

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
10
* modules, raffinement (these de Leon)
MARCHE Claude's avatar
MARCHE Claude committed
11

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
12 13 14 15
* support for higher-order

* extraction, more generally how to turn Why3 into a real programming language (these de Martin)

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
16 17 18 19 20
* rapprocher la logique et les programmes
** variant dans la logique ?
** monter les fonctions de programmes pures dans la logique ?


MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
21 22 23 24 25 26 27 28 29 30
* internal interpreter, test of specifications, quickcheck

* BWare project, support for rewrite rules, improved support for provers,
  extensions of set theory and their Coq realizations.

* LABCOM avec Adacore
** calculs non-linéaires, calculs en virgule flottante
** production de contre-exemples de preuves solides et exprimés dans le langage d’origine
** support efficace des invariants de données
** développer des composants réutilisables prouvés.
MARCHE Claude's avatar
MARCHE Claude committed
31

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
32 33
* jessie3

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

36
  * paper on the module system, its semantics, realizations, avec en
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
37
    particulier la solution avec les types classes
38

MARCHE Claude's avatar
MARCHE Claude committed
39
  * DONE paper on the proof management system
MARCHE Claude's avatar
MARCHE Claude committed
40

Jean-Christophe Filliâtre's avatar
Jean-Christophe Filliâtre committed
41
  * DONE Encodings and transformations (Andrei+Francois FroCos 11)
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
42

43
  * DONE Why presentation at the IVL workshop of CADE:
44 45
    (http://research.microsoft.com/en-us/um/people/moskal/boogie2011/)
    deadline: May 1st
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
46

Jean-Christophe Filliâtre's avatar
Jean-Christophe Filliâtre committed
47
  * Caml code ?
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
48

Jean-Christophe Filliâtre's avatar
Jean-Christophe Filliâtre committed
49
  * logic language for talking to provers
Jean-Christophe Filliâtre's avatar
Jean-Christophe Filliâtre committed
50 51 52
    - DONE (Boogie 11)
    - DONE FOL + poly (FroCos 11)
    -  alg + ind + rec ? + theories
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
53

Jean-Christophe Filliâtre's avatar
Jean-Christophe Filliâtre committed
54
  * VACID-0
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
55 56 57

  * system description (e.g. at CADE, TACAS) DONE at ESOP

Jean-Christophe Filliâtre's avatar
Jean-Christophe Filliâtre committed
58
  * rapports recherche ?
MARCHE Claude's avatar
MARCHE Claude committed
59

MARCHE Claude's avatar
MARCHE Claude committed
60
== stages ==
MARCHE Claude's avatar
MARCHE Claude committed
61

MARCHE Claude's avatar
MARCHE Claude committed
62
* M1. preuve d'un petit compilateur, pas de pb de lieur,
MARCHE Claude's avatar
MARCHE Claude committed
63 64
   eventuellement outils pour les preuves par recurrence
   a la Leino, + fct size automatique
MARCHE Claude's avatar
details  
MARCHE Claude committed
65
  DONE (Stage M1 de Leon)
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
66

MARCHE Claude's avatar
MARCHE Claude committed
67
* M2. Lieur en Why3, POPLmark challenge. vers
MARCHE Claude's avatar
MARCHE Claude committed
68
   un theorie et/ou un module réutilisable de lieurs
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
69 70
  DONE (Stage M2 de Martin)

MARCHE Claude's avatar
MARCHE Claude committed
71
* (M2?) Stage Airbus, "TIP" avec Frama-C/Jessie ou WP/Why/Coq
MARCHE Claude's avatar
MARCHE Claude committed
72
   besoin de la tactique Coq?
73

MARCHE Claude's avatar
MARCHE Claude committed
74
== new major features ==
MARCHE Claude's avatar
MARCHE Claude committed
75

MARCHE Claude's avatar
MARCHE Claude committed
76 77 78 79 80 81 82 83 84
* 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
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
85
 - Fast WP a la Leino (DONE ?)
MARCHE Claude's avatar
MARCHE Claude committed
86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103
 - 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


104 105 106 107 108 109
* 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
110 111
** support de Yices 2 ? interesserait Cesar

112

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
113
==================== Roadmap for next releases ========================
114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140

HighOrd: Coq output and OCaml extraction should produce lambda's from lambda's
and no epsilon

* 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

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

* 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

MARCHE Claude's avatar
MARCHE Claude committed
141
* documentation des nouvelles features higher-order
142

MARCHE Claude's avatar
MARCHE Claude committed
143 144 145 146 147 148
* eliminate_match:
** faire un cas particulier pour "bool", le match pouvant se traduire
   vers ite qui est supporté par pas mal de prouveurs
** introduire des symboles _match non polymorphes differents pour
   chaque instance necessaires. plutot qu'un seul symbole _match
   polymorphe.
149

150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167
==================== Roadmap for release 0.87 ========================

DATE : ?

Release Notes (details in file CHANGES):

== TODO ==

* Coq realization of bitvector theory

* make counter-examples feature more robust

* support for both isabelle 2014 and 2015

* review support for division operators by SMT provers

* take some time to fix some bugs of the BTS: 18029 at least

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
168 169
==================== Roadmap for release 0.86 ========================

MARCHE Claude's avatar
MARCHE Claude committed
170
DATE : fin avril / début mai
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
171 172 173 174

Release Notes (details in file CHANGES):

* Support for new provers or new versions of provers
MARCHE Claude's avatar
MARCHE Claude committed
175 176
* Stdlib: new theories for sequences and bitvectors
* bug fixes
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
177 178 179

== TODO ==

MARCHE Claude's avatar
MARCHE Claude committed
180 181 182 183
* decide if GUI with tabs is convenient enough
-> onglets dans why3 ide : est-ce apprécié ? OUI
    mais enlever l'onglet "Counterexamples" avant la release

MARCHE Claude's avatar
MARCHE Claude committed
184 185
* for next release: complete realization of bitvector library

MARCHE Claude's avatar
MARCHE Claude committed
186 187
== DONE ==

MARCHE Claude's avatar
MARCHE Claude committed
188 189 190 191 192
* clean up the support for SMTLIB bitvectors: there are 2 theories in the stdlib: thoeries/bv.why and modules/bitvectors.mlw
-> not anymore, but more cleaning can be done: no need to separate all theories in drivers for Z3 and CVC4, since the same theory can be put several times in a driver (or imported sub-drivers)

* DONE plusieurs drivers acceptés sur la ligne de commande (AP)

193 194 195 196
* solve issues with metitarski
. DONE theory PowerReal
. DONE crashes when applied on a WP (see examples/my_cosine.mlw)

197 198 199 200 201 202 203 204 205 206 207 208 209
* determine which is the minumum version of Ocaml to compile, and then
updated configure.in and the manual
-> vérification compilation avec OCaml 3.12 -> Claude va le faire

  . 3.11.2: opam install menhir plante car ocamlfind ne compile pas
  . 3.12.1: Why3 ne compile pas:
    File "src/core/ident.ml", line 208, characters 2-14:
    Error: Unbound value String.iteri
  . 4.00.0: pas teste, et sans doute pas recommande
  . 4.00.1: ca fonctionne

-> ocaml minimal = 4.00.1

MARCHE Claude's avatar
MARCHE Claude committed
210
DONE * sauvegarde de la configuration : à quel endroit dans l'IDE ?
MARCHE Claude's avatar
MARCHE Claude committed
211 212
-> Claude le met dans la fenetre preferences a cote du bouton "Close"

MARCHE Claude's avatar
MARCHE Claude committed
213 214 215 216 217
* support for veriT recent
-> DONE: version 201410

* support for Yices2 recent
-> DONE: 2.3.0, but still does not support quantifiers
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253


== 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-local" is OK
  (see below : copy the dtd on the web)
* put 0.86 in file Version, and then run ./config.status
* check/update the content of the About dialog in src/ide/gconfig.ml
  around lines 550-600
* check headers
* check the file CHANGES, add the release date
* manual in PDF:
** update the date in doc/manual.tex (near \whyversion{})
** check that macro \todo is commented out in doc/macros.tex
** and then "make doc"
  (check that manual in HTML is also generated, doc/html/index.html)
* do "make dist"
* test distrib/why3-0.86.tar.gz
* move distrib from Why3 site to Inria forge:
** upload distrib/why3-0.86.tar.gz to https://gforge.inria.fr/frs/?group_id=2990
* put on the web page
 - the manual in PDF
   cp doc/manual.pdf /users/www-perso/projets/why3/download/manual-0.86.pdf

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

 - why3session.dtd
   cp -f 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.86
MARCHE Claude's avatar
MARCHE Claude committed
254
   ln -s -n -f /users/www-perso/projets/why3/stdlib-0.86 \
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
255 256 257 258
            /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.86
MARCHE Claude's avatar
MARCHE Claude committed
259
    ln -s -n -f /users/www-perso/projets/why3/api-0.86 \
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
260 261 262
      /users/www-perso/projets/why3/api

 - update the main HTML page (sources are in repository why3-www)
MARCHE Claude's avatar
MARCHE Claude committed
263 264
   edit index.html, change at least all occurrences of 0.85 by 0.86, and
     update the url for download
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
265 266 267 268 269 270 271 272 273 274 275 276 277 278
   make (to check validity)
   make export

* make a last commit:
 - git commit -am "release 0.86"
 - add tag 0.86 to the git repository, using
   git tag 0.86
 - 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

MARCHE Claude's avatar
MARCHE Claude committed
279
* The next commit : add +git to the version in file Version
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
280

MARCHE Claude's avatar
MARCHE Claude committed
281 282
* prepare the OPAM package

MARCHE Claude's avatar
MARCHE Claude committed
283
. obtain a local copy of opam repository, or obtain a former one :
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
284 285 286 287 288 289 290 291 292 293 294

        git clone git@github.com:claudemarche/opam-repository.git
        cd opam-repository/
        git remote add opam https://github.com/ocaml/opam-repository.git

      or, if you already have one, make sure it is up-to-date:

        git fetch opam
        git reset --hard opam/master
        git push

MARCHE Claude's avatar
MARCHE Claude committed
295 296 297 298
. copy former files:

  cp -r packages/why3-base/why3-base-0.85 packages/why3-base/why3-base-0.86
  cp -r packages/why3/why3-0.85 packages/why3/why3-0.86
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
299

MARCHE Claude's avatar
MARCHE Claude committed
300 301
. update packages/why3-base/why3-base-0.86/url:
  url and checksum of why-0.86.tar.gz obtained via
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
302

MARCHE Claude's avatar
MARCHE Claude committed
303
    md5sum distrib/why3-0.86.tar.gz
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
304

MARCHE Claude's avatar
MARCHE Claude committed
305 306 307 308 309
. update packages/why3-base/why3-base-0.86/descr if necessary
. update packages/why3/why3-0.86/descr if necessary
. update packages/why3-base/why3-base-0.86/opam with correct dependencies and such
. update packages/why3/why3-0.86/opam with correct dependencies and such
  (at least the dependency on why3-base should be fixed)
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
310

MARCHE Claude's avatar
MARCHE Claude committed
311 312 313
* test the OPAM package (requires opam 1.2)
    opam pin why3 ./.git
    opam install why3
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
314 315 316 317 318 319 320 321

* make a pull request on OPAM

  git add why3.0.86
  git commit -am "new package version why3 0.86"
  git push
  sur github: creer un pull request

MARCHE Claude's avatar
MARCHE Claude committed
322 323 324
* inform Jerry James <loganjerry@gmail.com> so that he can produce the
  Fedora package

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
325
* produce the Why3 part of Toccata gallery
MARCHE Claude's avatar
MARCHE Claude committed
326 327 328
  (TODO: add the procedure here)
  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
MARCHE Claude's avatar
MARCHE Claude committed
329

MARCHE Claude's avatar
MARCHE Claude committed
330 331 332
* Once the OPAM package is pulled in the main OPAM repository: a
  nnounce the distrib
  What to put in the announcement: see New Features above
MARCHE Claude's avatar
MARCHE Claude committed
333

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
334 335


MARCHE Claude's avatar
MARCHE Claude committed
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 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441
==================== Roadmap for release 0.85 ========================

Release Notes:

Mainly a bug-fix release, in particular to fix two soundness bugs

See CHANGES

== 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-local" is OK
  (see below : copy the dtd on the web)
* put 0.85 in file Version, and then run ./config.status
* check/update the content of the About dialog in src/ide/gconfig.ml
  around lines 550-600
* check headers
* check the file CHANGES, add the release date
* manual in PDF:
** update the date in doc/manual.tex (near \whyversion{})
** check that macro \todo is commented out in doc/macros.tex
** and then "make doc"
  (check that manual in HTML is also generated, doc/html/index.html)
* do "make dist"
* test distrib/why3-0.85.tar.gz
* put on the web page why3-0.85.tar.gz:
  cp distrib/why3-0.85.tar.gz /users/www-perso/projets/why3/download
* inform Jerry James <loganjerry@gmail.com> so that he can test the
  Fedora package
* install web page for why2 which includes an updated page for the
  quick migration guide. (sources are in CVS repository
  ~filliatr/ARCHIVE/www/why).
* move distrib from Why3 site to Inria forge:
** remove /users/www-perso/projets/why3/download/why3-0.85.tar.gz
** upload distrib/why3-0.85.tar.gz to https://gforge.inria.fr/frs/?group_id=2990
* put on the web page
 - the manual in PDF
   cp doc/manual.pdf /users/www-perso/projets/why3/download/manual-0.85.pdf

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

 - why3session.dtd
   cp -f 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.85
   rm /users/www-perso/projets/why3/stdlib
   ln -s /users/www-perso/projets/why3/stdlib-0.85 \
            /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.85
    rm /users/www-perso/projets/why3/api
    ln -s /users/www-perso/projets/why3/api-0.85 \
      /users/www-perso/projets/why3/api

 - update the main HTML page (sources are in repository why3-www)
   edit index.html
   make (to check validity)
   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

* prepare for the OPAM package

. update opam/url: url and checksum of why-0.85.tar.gz
   (use "md5sum distrib/why3-0.85.tar.gz")
. update opam/descr if necessary
. update opam/opam with correct dependencies and such

* make a last commit:
 - git commit -am "release 0.85"
 - add tag 0.85 to the git repository, using
   git tag 0.85
 - 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


* test the OPAM package

  . with opam 1.2:
    opam pin add why3 --kind=git <...>/why3/.git
    (it runs "opam install why3")
  . with opam < 1.2:

    - first step: have a local copy of opam-repository if not done yet, e.g.:

        git clone git@github.com:claudemarche/opam-repository.git
        cd opam-repository/
        git remote add opam https://github.com/ocaml/opam-repository.git

      or, if you already have one, make sure it is up-to-date:

442 443 444
        git fetch opam
        git reset --hard opam/master
        git push
MARCHE Claude's avatar
MARCHE Claude committed
445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464

    - second step: copy why3 opam files into it :

      cd packages/why3
      cp -r <source why3>/opam why3.0.85

    - second step:

      opam repository add local <...>/opam-repository
      opam install why3
      (* test it, e.g.
         cp example/quicksort.mlw ~/tmp
         why3 ide ~/tmp/quicksort.mlw *)
      opam remove why3
      opam repository remove local


* make a pull request on OPAM

  git add why3.0.85
465 466
  git commit -am "new package version why3 0.85"
  git push
MARCHE Claude's avatar
MARCHE Claude committed
467 468 469 470 471 472 473 474 475 476
  sur github: creer un pull request

* 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


Guillaume Melquiond's avatar
Guillaume Melquiond committed
477
==================== Roadmap for release 0.84 ========================
MARCHE Claude's avatar
MARCHE Claude committed
478

MARCHE Claude's avatar
MARCHE Claude committed
479 480 481 482 483 484
== TODOs ==

* verifier support des nouveaux prouveurs: Coq8.4pl4, Isabelle-2014,
  CVC4 1.4, yices2 (quantifiers ?)  beagle ? driver TPTP TFA ? autres ?

* completer le fichier CHANGES
MARCHE Claude's avatar
MARCHE Claude committed
485 486 487 488 489 490
** nouvelle facon d'appeler les outils "why3 xxx ..." DONE
** strategies de preuve, NO for next release only
** transformation "compute_in_goal", DONE, but rewrite rules not documented
** support de nouveaux prouveurs, DONE
** nouvelle structure des fichiers de session et de shape (compatibilité), DONE
** new examples ? BOF
MARCHE Claude's avatar
MARCHE Claude committed
491 492

* ajouter dans les instructions de release ci-dessous la procedure de
MARCHE Claude's avatar
MARCHE Claude committed
493
  fabrication du paquet opam DONE
MARCHE Claude's avatar
MARCHE Claude committed
494

495 496
== New Features to announce ==

MARCHE Claude's avatar
MARCHE Claude committed
497 498 499 500 501 502 503 504 505 506 507
Release Notes:

A major visible change in this release is the way Why3 commands are
invoked: instead of several executables why3, why3config, why3ide,
why3replay, why3session, etc., there is only one Why3 executable
called why3, and the former executables are available as commands given
as first argument, e.g. "why3 config", "why3 ide", etc.

Another quite visible change is that session files are split in two
parts, as detailed below in the detailed changes.

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
508
See CHANGES
509

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
510 511 512 513 514 515 516
== 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-local" is OK
  (see below : copy the dtd on the web)
MARCHE Claude's avatar
MARCHE Claude committed
517
* put 0.84 in file Version, and then run ./config.status
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
518 519 520 521
* check/update the content of the About dialog in src/ide/gconfig.ml
  around lines 550-600
* check headers
* check the file CHANGES, add the release date
MARCHE Claude's avatar
MARCHE Claude committed
522 523 524 525
* manual in PDF:
** update the date in doc/manual.tex (near \whyversion{})
** check that macro \todo is commented out in doc/macros.tex
** and then "make doc"
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
526 527 528
  (check that manual in HTML is also generated, doc/html/index.html)
* do "make dist"
* test distrib/why3-0.84.tar.gz
MARCHE Claude's avatar
MARCHE Claude committed
529 530
* put on the web page why3-0.84.tar.gz:
  cp distrib/why3-0.84.tar.gz /users/www-perso/projets/why3/download
MARCHE Claude's avatar
MARCHE Claude committed
531 532
* inform Jerry James <loganjerry@gmail.com> so that he can test the
  Fedora package
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
533 534
* install web page for why2 which includes an updated page for the
  quick migration guide. (sources are in CVS repository
Guillaume Melquiond's avatar
Guillaume Melquiond committed
535
  ~filliatr/ARCHIVE/www/why).
MARCHE Claude's avatar
MARCHE Claude committed
536 537 538
* move distrib from Why3 site to Inria forge:
** remove /users/www-perso/projets/why3/download/why3-0.84.tar.gz
** upload distrib/why3-0.84.tar.gz to https://gforge.inria.fr/frs/?group_id=2990
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564
* put on the web page
 - the manual in PDF
   cp doc/manual.pdf /users/www-perso/projets/why3/download/manual-0.84.pdf

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

 - 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.84
   rm /users/www-perso/projets/why3/stdlib
   ln -s /users/www-perso/projets/why3/stdlib-0.84 \
            /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.84
    rm /users/www-perso/projets/why3/api
    ln -s /users/www-perso/projets/why3/api-0.84 \
      /users/www-perso/projets/why3/api
   (PROBLEME avec style.css ? Ou est le probleme ?)

 - update the main HTML page (sources are in repository why3-www)
   edit index.html
MARCHE Claude's avatar
MARCHE Claude committed
565
   make (to check validity)
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
566
   make export
567

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
568 569 570
 - 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)
571

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
572 573
 - make everything writeable for the group
   chmod -R g+w /users/www-perso/projets/why3
MARCHE Claude's avatar
MARCHE Claude committed
574

575 576
* prepare for the OPAM package

MARCHE Claude's avatar
MARCHE Claude committed
577
. update opam/url: url and checksum of why-0.84.tar.gz
578 579 580 581
   (use "md5sum distrib/why3-0.84.tar.gz")
. update opam/descr if necessary
. update opam/opam with correct dependencies and such

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
582
* make a last commit:
MARCHE Claude's avatar
MARCHE Claude committed
583
 - git commit -am "release 0.84"
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
584 585 586 587 588
 - add tag 0.84 to the git repository, using
   git tag 0.84
 - do not forget to push it using
   git push
   git push --tags
MARCHE Claude's avatar
MARCHE Claude committed
589

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
590 591 592
* add a new version to the bugtracker:
  https://gforge.inria.fr/tracker/admin/?group_id=2990&atid=10293&add_extrafield=1

593 594 595 596 597 598 599

* test the OPAM package

  . with opam 1.2:
    opam pin add why3 --kind=git <...>/why3/.git
    (it runs "opam install why3")
  . with opam < 1.2:
MARCHE Claude's avatar
MARCHE Claude committed
600

601 602
    - first step: have a local copy of opam-repository if not done yet, e.g.:

MARCHE Claude's avatar
MARCHE Claude committed
603 604 605
        git clone git@github.com:claudemarche/opam-repository.git
        cd opam-repository/
        git remote add opam https://github.com/ocaml/opam-repository.git
606 607 608

      or, if you already have one, make sure it is up-to-date:

MARCHE Claude's avatar
MARCHE Claude committed
609 610 611 612 613 614
        git pull --ff-only opam master

    - second step: copy why3 opam files into it :

      cd packages/why3
      cp -r <source why3>/opam why3.0.84
615 616

    - second step:
MARCHE Claude's avatar
MARCHE Claude committed
617

MARCHE Claude's avatar
MARCHE Claude committed
618
      opam repository add local <...>/opam-repository
619
      opam install why3
MARCHE Claude's avatar
MARCHE Claude committed
620
      (* test it, e.g.
621
         cp example/quicksort.mlw ~/tmp
MARCHE Claude's avatar
MARCHE Claude committed
622
         why3 ide ~/tmp/quicksort.mlw *)
623 624 625 626 627 628 629 630 631 632
      opam remove why3
      opam repository remove local


* make a pull request on OPAM

  git add why3.0.84
  commit et push
  sur github: creer un pull request

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
633 634 635 636 637 638
* 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
MARCHE Claude's avatar
MARCHE Claude committed
639 640


MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
641 642 643 644 645 646

==================== Roadmap for release 0.83 ========================

== New Features to announce ==

See CHANGES
647 648 649

== Final preparation ==

650 651
* inform Jerry James <loganjerry@gmail.com> so that he can test the
  Fedora package
652 653 654 655 656
* 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-local" is OK
  (see below : copy the dtd on the web)
657
* put 0.83 in file Version
658 659
* check/update the content of the About dialog in src/ide/gconfig.ml
  around lines 550-600
660 661 662 663 664 665
* 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"
  (check that manual in HTML is also generated, doc/html/index.html)
* do "make dist"
666
* test distrib/why3-0.83.tar.gz
667 668
* install web page for why2 which includes an updated page for the
  quick migration guide. (sources are in CVS repository
669
  ~filliatr/ARCHIVE/www/why). ADD a colon on new syntax for 0.83. Change Proval into Toccata
670
* put on the web page
671 672
 - why3-0.83.tar.gz
   cp distrib/why3-0.83.tar.gz /users/www-perso/projets/why3/download
673 674

 - the manual in PDF
675
   cp doc/manual.pdf /users/www-perso/projets/why3/download/manual-0.83.pdf
676 677

 - the HTML version of the manual (content of doc/html)
678
   cp -r doc/html /users/www-perso/projets/why3/doc-0.83
679 680 681 682 683 684

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

 - standard library online, using why3doc, to http://why3.lri.fr/stdlib/
   make stdlibdoc
685
   cp -r doc/stdlibdoc /users/www-perso/projets/why3/stdlib-0.83
686
   rm /users/www-perso/projets/why3/stdlib
687
   ln -s /users/www-perso/projets/why3/stdlib-0.83 \
688 689 690
            /users/www-perso/projets/why3/stdlib
 - API doc, produced using ocamldoc, to http://why3.lri.fr/api/
    make apidoc
691
    cp -r doc/apidoc /users/www-perso/projets/why3/api-0.83
692
    rm /users/www-perso/projets/why3/api
693
    ln -s /users/www-perso/projets/why3/api-0.83 \
694 695
      /users/www-perso/projets/why3/api
   (PROBLEME avec style.css ? Ou est le probleme ?)
696

697 698 699 700 701 702 703 704 705 706 707 708
 - 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:
709 710 711
 - git commit -m "release 0.83"
 - add tag 0.83 to the git repository, using
   git tag 0.83
712 713 714 715 716 717 718 719 720 721 722 723 724 725 726
 - 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


MARCHE Claude's avatar
MARCHE Claude committed
727 728
== TODOs ==

MARCHE Claude's avatar
MARCHE Claude committed
729
* DONE replayer: replay should be considered failed if new goals appeared.
MARCHE Claude's avatar
MARCHE Claude committed
730

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
731
* DONE ? fix problems with installed scripts that are missing a proper executable right (mails Frederic Boulanger)
MARCHE Claude's avatar
MARCHE Claude committed
732 733

* Isabelle Support:
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
734
** DONE ? fix the problem with why3_jedit script missing executable bit
MARCHE Claude's avatar
MARCHE Claude committed
735
** DONE add a documentation: start "isabelle why3_jedit" before why3ide, use "Close C-w" to signal the end of edit to why3"
MARCHE Claude's avatar
MARCHE Claude committed
736

MARCHE Claude's avatar
MARCHE Claude committed
737
* extraction vers Caml
738
** DONE utiliser ZArith
MARCHE Claude's avatar
MARCHE Claude committed
739

MARCHE Claude's avatar
MARCHE Claude committed
740
==================== Roadmap for release 0.82 ========================
741

MARCHE Claude's avatar
MARCHE Claude committed
742
Scheduled for 9 december 2013
743

744 745
== New Features to announce ==

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
746 747 748
* input language
** lemma functions
** polymorphic recursion permitted
MARCHE Claude's avatar
MARCHE Claude committed
749
** types "opaques" TODO ???
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
750

MARCHE Claude's avatar
MARCHE Claude committed
751

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
752
* new provers:
MARCHE Claude's avatar
MARCHE Claude committed
753
** veriT 201310
MARCHE Claude's avatar
MARCHE Claude committed
754
** Metitarski 2.2 (contribution by Piotr Trojanek)
MARCHE Claude's avatar
MARCHE Claude committed
755 756 757 758
** Metis 2.3
** Beagle 0.4.1
** Princess 2013-05-13
** Yices2 2.0.4
MARCHE Claude's avatar
MARCHE Claude committed
759
** Isabelle 2013-2 (contribution by Stefan Berghofer)
MARCHE Claude's avatar
MARCHE Claude committed
760 761

* new versions of provers:
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
762
** Alt-Ergo 0.95.2
MARCHE Claude's avatar
MARCHE Claude committed
763
** CVC4 1.1 & 1.2 & 1.3
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
764
** Coq 8.4pl2
MARCHE Claude's avatar
MARCHE Claude committed
765
** gappa 1.0.0
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
766 767 768
** SPASS 3.8ds

* API: more examples of use in  examples/use_api/
MARCHE Claude's avatar
MARCHE Claude committed
769

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
770
* emacs support: why.el renamed into why3.el
MARCHE Claude's avatar
MARCHE Claude committed
771 772 773 774

* why3session
** --stats: changed (detailler, temps, distinction root et subgoals, CLAUDE)

MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
775
* bug fixes:
MARCHE Claude's avatar
MARCHE Claude committed
776
** remove extra leading zeros in decimal literals when a prover don't like them
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
777 778 779
** PVS output: types are always non-empty
** PVS: fixed configuration and installation process
** improved shape mecanism for session updates (see VSTTE'13 paper).
780 781
  Compatibility with session files from version 0.81 and earlier is
  assured.
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
782 783
** Coq tactic: now loads dynamic plug-ins
** Coq output: fixed printing of polymorphic recursive datatypes
MARCHE Claude's avatar
MARCHE Claude committed
784 785 786 787 788
** bug #15493: correct Coq output for polymorphic algebraic data types
** wish #15053: Remove proof time from "Goals proved by only one prover" section of why3session info --stats
** bug #13736: why3ml was slow when there are many inclusions
** bug #16488: decimals in TPTP syntax
** bug #16454: do not send arithmetic triggers anymore to alt-Ergo
MARCHE Claude's avatar
MARCHE Claude committed
789 790
** syntax highlighting bugs: should be fixed by removing the old language
   file alt-ergo.lang from alt-ergo distribution
MARCHE Claude's avatar
MARCHE Claude committed
791

792 793 794 795 796
== 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
MARCHE Claude's avatar
MARCHE Claude committed
797
* check that "make xml-validate-local" is OK
798
  (see below : copy the dtd on the web)
MARCHE Claude's avatar
MARCHE Claude committed
799
* put 0.82 in file Version
800 801 802 803
* 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"
MARCHE Claude's avatar
MARCHE Claude committed
804 805
  (check that manual in HTML is also generated, doc/html/index.html)
* do "make dist"
MARCHE Claude's avatar
MARCHE Claude committed
806
* test distrib/why3-0.82.tar.gz
807 808 809 810
* 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
811 812
 - why3-0.82.tar.gz
   cp distrib/why3-0.82.tar.gz /users/www-perso/projets/why3/download
813 814

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

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

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

823 824
 - standard library online, using why3doc, to http://why3.lri.fr/stdlib/
   make stdlibdoc
MARCHE Claude's avatar
MARCHE Claude committed
825
   cp -r doc/stdlibdoc /users/www-perso/projets/why3/stdlib-0.82
826
   rm /users/www-perso/projets/why3/stdlib
MARCHE Claude's avatar
MARCHE Claude committed
827
   ln -s /users/www-perso/projets/why3/stdlib-0.82 \
828 829 830
            /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
831
    cp -r doc/apidoc /users/www-perso/projets/why3/api-0.82
832
    rm /users/www-perso/projets/why3/api
MARCHE Claude's avatar
MARCHE Claude committed
833
    ln -s /users/www-perso/projets/why3/api-0.82 \
834
      /users/www-perso/projets/why3/api
MARCHE Claude's avatar
MARCHE Claude committed
835
   (PROBLEME avec style.css ? Ou est le probleme ?)
MARCHE Claude's avatar
MARCHE Claude committed
836
 - update the main HTML page (sources are in repository why3-www)
837 838 839
   edit index.html
   make export

MARCHE Claude's avatar
MARCHE Claude committed
840 841 842 843
 - 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)

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

MARCHE Claude's avatar
MARCHE Claude committed
847
* make a last commit:
MARCHE Claude's avatar
MARCHE Claude committed
848 849 850
 - 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
851 852 853 854
 - do not forget to push it using
   git push
   git push --tags

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

MARCHE Claude's avatar
MARCHE Claude committed
858
* produce the Why3 part of Toccata gallery
859
  -> add also a tar.gz and a ZIP file of it (this is done by doing
MARCHE Claude's avatar
MARCHE Claude committed
860
  "make gallery-files" in the sources of the Toccata web pages)
861 862 863 864 865 866
* 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
867
* DONE Patch de johannes pour les noms de fichier pour Isabelle
MARCHE Claude's avatar
MARCHE Claude committed
868

MARCHE Claude's avatar
MARCHE Claude committed
869
* DONE discriminate, mettre les bons arguments par defaut (ANDREI)
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
870

MARCHE Claude's avatar
MARCHE Claude committed
871
* DONE efficiency issues
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
872 873 874 875 876 877
** understand problems when large number of goals (cf D Mentré examples)
** prouveur de Martin
** tester avant la release sur
*** BWare
*** Prouveur de Martin
*** examples de Frama-C/Jessie et Krakatoa
878

879
* DONE Coq detection (et PVS) (CLAUDE, champ supplementaire compile_support = yes dans le prover-detection-data)
880 881 882
** 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
883
* Coq tactic (CLAUDE, GUILLAUME, JCF, ANDREI)
MARCHE Claude's avatar
MARCHE Claude committed
884
** DONE bug Prod(_,_,_) -> traiter le cas
MARCHE Claude's avatar
MARCHE Claude committed
885

886 887
* 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
roadmap  
MARCHE Claude committed
888
  intentionel que l'on veuille prouver false. FAIT
MARCHE Claude's avatar
MARCHE Claude committed
889
  Un tel cas pourrait etre
890 891
  traité de facon speciale par le smoke detector avec option "deep",
  pour eviter une fausse alarme.
MARCHE Claude's avatar
MARCHE Claude committed
892
  PAS FAIT
893 894

* faire le menage dans les transformations d'induction : _int _ty
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
895
  _ty_lex, FAIT et documenter PAS FAIT
896 897 898

* Documentation
 - (ANDREI) make the glossary available
MARCHE Claude's avatar
MARCHE Claude committed
899
 - (CLAUDE) complete api.tex: explain how to build/apply
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
900
   transformations, write new functions on terms
MARCHE Claude's avatar
MARCHE Claude committed
901 902
 - LEON: add a section "further reading"

MARCHE Claude's avatar
MARCHE Claude committed
903
* DONE bug fix: 16454 (ne pas envoyer des triggers arithmetiques) (GUILLAUME)
MARCHE Claude's avatar
MARCHE Claude committed
904

MARCHE Claude's avatar
MARCHE Claude committed
905
* DONE bug fix: 15652 (ghost code detection)
MARCHE Claude's avatar
MARCHE Claude committed
906 907 908

* support for new provers
** Alt-Ergo 0.95.2 DONE
MARCHE Claude's avatar
MARCHE Claude committed
909
** CVC4 1.2 DONE: pb avec les booleens
MARCHE Claude's avatar
MARCHE Claude committed
910
** DONE Coq 8.4pl2: probleme tactique Why3
MARCHE Claude's avatar
MARCHE Claude committed
911
** DONE Metitarski: improve it (CLAUDE, GUILLAUME)
MARCHE Claude's avatar
MARCHE Claude committed
912

MARCHE Claude's avatar
MARCHE Claude committed
913

MARCHE Claude's avatar
MARCHE Claude committed
914
* DONE simplification de (a && false) ne devrait pas etre false
MARCHE Claude's avatar
roadmap  
MARCHE Claude committed
915

MARCHE Claude's avatar
MARCHE Claude committed
916

917

Guillaume Melquiond's avatar
Guillaume Melquiond committed
918

MARCHE Claude's avatar
MARCHE Claude committed
919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034

==================== 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


1035 1036 1037
==================== Roadmap for release 0.80 ========================

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

1039
scheduled on Oct 2012
1040

MARCHE Claude's avatar
MARCHE Claude committed
1041 1042
== New Features to announce ==

1043 1044
Programs:
  o new concrete syntax for programs
1045
  o new API for programs
1046
  o type invariants
1047
  o ghost code
1048

1049
Transformations:
1050 1051
  o induction (experimental, undocumented)
  o bisection (experimental, undocumented)
1052

1053
Provers support:
1054
  o support for Coq 8.4
1055
  o dropped support for Coq 8.2
1056
  o support for forthcoming PVS 6.0, including realizations
1057
  o support for iProver and Zenon
1058

1059
Misc:
Claude Marche's avatar
Claude Marche committed
1060
  o improved output of "why3session latex"
MARCHE Claude's avatar
MARCHE Claude committed
1061
    (incompatible changes in LaTeX macros)
Claude Marche's avatar
Claude Marche committed
1062
  o [replayer] new option -q for running quietly
1063 1064 1065 1066 1067
  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
1068
    instead
MARCHE Claude's avatar
MARCHE Claude committed
1069

1070
Bug fixes:
1071
  o Coq output uses type classes to ensure Why3 types are inhabited
MARCHE Claude's avatar
MARCHE Claude committed
1072 1073 1074 1075
  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
1076 1077 1078

== Final preparation ==

MARCHE Claude's avatar
MARCHE Claude committed
1079
* faire une passe sur le BTS
1080
* do "make update-coq" and "make", fix Coq realizations if needed
MARCHE Claude's avatar
MARCHE Claude committed
1081 1082
* check that nightly bench is OK
* check that "make xml-validate" is OK
MARCHE Claude's avatar
MARCHE Claude committed
1083
  (see below : copy the dtd on the web)
MARCHE Claude's avatar
MARCHE Claude committed
1084
* put 0.80 in file Version
MARCHE Claude's avatar
MARCHE Claude committed
1085
* check headers
1086
* check the file CHANGES, add the release date
MARCHE Claude's avatar
MARCHE Claude committed
1087 1088
* manual in PDF: check that macro \todo is commented out
    in ./macros.tex, and then "make doc"
1089
* manual in HTML: "make doc/html/index.html"
MARCHE Claude's avatar
MARCHE Claude committed
1090
* do "make distrib"
MARCHE Claude's avatar
MARCHE Claude committed
1091
* test the distrib why3-0.80.tar.gz
MARCHE Claude's avatar
MARCHE Claude committed
1092
* make a last commit:
1093
 - add tag 0.80 to the git repository, using git tag 0.80
MARCHE Claude's avatar
MARCHE Claude committed
1094
 - do not forget to push it using git push --tags
1095 1096 1097
* 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
1098
* put on the web page
MARCHE Claude's avatar
MARCHE Claude committed
1099
 - why3-0.80.tar.gz
1100
 - the HTML version of the manual (content of doc/html)
MARCHE Claude's avatar
MARCHE Claude committed
1101
 - why3session.dtd
MARCHE Claude's avatar
MARCHE Claude committed
1102
 - standard library online, using why3doc, to http://why3.lri.fr/stdlib/
1103 1104 1105 1106 1107
   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
1108
 - API doc, produced using ocamldoc, to http://why3.lri.fr/api/
1109 1110 1111
    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
1112
    ln -s /users/www-perso/projets/why3/api-0.80 \
1113 1114
      /users/www-perso/projets/why3/api
   PROBLEME avec style.css
MARCHE Claude's avatar
MARCHE Claude committed
1115 1116
 - update the main HTML page (sources are in why3-papers/www)

1117
* produce the Why3 part of ProVal gallery
1118
  -> add also a tar.gz and a ZIP file of it (this is done by doing
MARCHE Claude's avatar
MARCHE Claude committed
1119
  "make gallery-files" in the sources of the web pages)
MARCHE Claude's avatar
MARCHE Claude committed
1120 1121 1122 1123 1124 1125
* 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 ==

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

1128
* DONE appliquer les changements de syntaxe des programmes dans la doc : aussi bien dans le tutorial que dans la BNF des manpages
1129 1130


1131
* DONE Sortie PVS, avec mecanisme de realization
1132

MARCHE Claude's avatar
MARCHE Claude committed
1133
* DONE mettre au propre les loc des fichiers de sessions, en particulier
MARCHE Claude's avatar
MARCHE Claude committed
1134 1135
  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
1136

1137 1138
* DONE sessions: mettre la dtd sur le web et changer l'entête des sessions pour qu'elles
   pointent dessus
1139 1140


1141
* DONE (PRIORITAIRE) Coq output
1142 1143 1144 1145 1146 1147
 - 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

1148
* DONE (PRIORITAIRE), JCF et ANDREI, clone de module
1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162
 - 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
1163 1164 1165 1166 1167 1168 1169 1170 1171
==================== 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