General:

* WHIZARD 2.7+ currently runs only with the NAGFOR 6.2 (or newer) and
  gfortran 5.1.0 (or newer) Fortran compilers as well as Intel ifort
  18.0.0 (or newer). gfortran 6.5 has a severe regression, and cannot
  be used, as well as Intel ifort 19.0.0/1.

  [See the file EXTENSIONS for the list of Fortran 2003/2008/2018 
   features that the compiler must support.]

* WHIZARD 2.7+ incorporates all features from WHIZARD 1, making the
  legacy branch obsolete now.
  
* Please report bugs and problems or performance issues
  at our Launchpad site:
  https://launchpad.net/whizard
  or send an email to our support email address:
  <whizard@desy.de>

Known (recent) bugs:

* WHIZARD 2.8.1 and earlier does not compile with OCaml versions 4.08.0
  and newer due to a deletion of a deprecated feature in the OCaml language.
  This is fixed in 2.8.2+ of WHIZARD. For older WHIZARD versions, please
  downgrade your OCaml version to anything between versions 4.02.x and 4.07.x.

* MPI version of WHIZARD: version 2.6.3 could produce the MPI-parallelized
  version only from the svn repository, and not from the release tarball.
  This was corrected for version 2.6.4.

* In version 2.6.0 the top threshold calculations do not work due to a
  regression. This is fixed in 2.6.1. In version 2.6.1 all processes
  with BSM resonances having PDG codes with 7 digits are broken. This is
  fixed in version 2.6.2.

Compilers and OS specialties:

* MAC OS X Darwin >= 10.11:
  The security measures of the new Darwin systems do not allow e.g.
  environment variables passed to subprocesses. This does not change
  anything for the installed WHIZARD, but the testsuite (make check)
  will not work before make install has been executed. make distcheck 
  will not work on El Capitan. There is also the option to disable
  the System Integrity Protocol (SIP) of El Capitan by booting in
  Recovery Mode, open a terminal and type 'csrutil disable'. However, we
  do not recommend to do so.

Manual:

* For WHIZARD 2.8, the manual is still quite sparse. We are working on
  that. Regular updates independent from the subreleases can be found
  on the Hepforge webpage:
  https://whizard.hepforge.org/manual.pdf

Old bugs in old versions:

* In version 2.3.0 there is a regression which produces invalid O'Mega
  matrix element code for SUSY processes with gluino propagators. This
  is fixed in 2.3.1+.

* With gfortran 4.9.1, the auto_components feature (incl. the smtest_5
  self test) does not work in v2.2.2 due to a regression in that compiler.
  This is fixed both in v2.2.3+ of WHIZARD as well as in v4.9.2+ of
  gfortran.

* gfortran 4.9.2 contains several bugs/regressions from GNU's ongoing 
  efforts to implement the Fortran 2008 status. This can lead to
  problems in some of WHIZARD's release versions, though most versions
  include workarounds. Please try to use at least minor version 3 of
  the 4.9.X series.
