Start to prepare release candidate ELPA-2019.05.001.rc

Still to do:
- ABI versioning
- API version number
- Release notes
- Changelog
- Issues
- remove deprecated features
- update of API documentation
parent 4770eb38
......@@ -2,7 +2,7 @@
## Preamble ##
This file provides documentation on how to build the *ELPA* library in **version ELPA-2018.11.001**.
This file provides documentation on how to build the *ELPA* library in **version ELPA-2019.05.001.rc1**.
With release of **version ELPA-2017.05.001** the build process has been significantly simplified,
which makes it easier to install the *ELPA* library.
......@@ -10,13 +10,13 @@ The old, obsolete legacy API will be deprecated in the future !
Allready now, all new features of ELPA are only available with the new API. Thus, there
is no reason to keep the legacy API arround for too long.
The release ELPA 2018.11.001 will be the last release, where the legacy API is
The release ELPA 2018.11.001 was the last release, where the legacy API has been
enabled by default (and can be disabled at build time).
With release ELPA 2019.05.001 the legacy API will be disabled by default, however,
With release ELPA 2019.05.001 the legacy API is disabled by default, however,
can be still switched on at build time.
Most likely with the release ELPA 2019.11.001 the legacy API will be deprecated and not supported anymore.
The release of ELPA 2018.11.001 changes the ABI and API, since more functions have an error argument. In C this error argument is required, in Fortran it is optional.
The release of ELPA 2019.05.001.rc1 changes the ABI and API, since it allows to also build the C-functions with optional error arguments
## How to install *ELPA* ##
......
......@@ -3,6 +3,9 @@
For more details and recent updates please visit the online [issue system] (https://gitlab.mpcdf.mpg.de/elpa/elpa/issues)
Issues which are not mentioned in a newer release are (considered as) solved.
### ELPA 2019.11.001.rc1 release ###
- same issues as in ELPA 2017.11.001
### ELPA 2018.11.001 release ###
- same issues as in ELPA 2017.11.001
......
......@@ -2,22 +2,20 @@
## Current Release ##
The current release is ELPA 2018.11.001 The current supported API version
is 20181113. This release supports the earliest API version 20170403.
The current release is ELPA 2019.05.001.rc1 The current supported API version
is 20190501. This release supports the earliest API version 20170403.
The old, obsolete legacy API will be deprecated in the future !
Allready now, all new features of ELPA are only available with the new API. Thus, there
is no reason to keep the legacy API arround for too long.
The release ELPA 2018.11.001 will be the last release, where the legacy API is
The release ELPA 2018.11.001 was the last release, where the legacy API has been
enabled by default (and can be disabled at build time).
With release ELPA 2019.05.001 the legacy API will be disabled by default, however,
With release ELPA 2019.05.001 the legacy API is disabled by default, however,
can be still switched on at build time.
Most likely with the release ELPA 2019.11.001 the legacy API will be deprecated and
not supported anymore.
Note that the release ELPA 2018.11.001 introduces error codes to all functions, and thus an ABI and API change was neccessary
[![Build
status](https://gitlab.mpcdf.mpg.de/elpa/elpa/badges/master/build.svg)](https://gitlab.mpcdf.mpg.de/elpa/elpa/commits/master)
......@@ -117,7 +115,7 @@ the possible configure options.
## Using *ELPA*
Please have a look at the "**USERS_GUIDE**" file, to get a documentation or at the [online]
(http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2018.11.001/html/index.html) doxygen
(http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2019.05.001.rc1/html/index.html) doxygen
documentation, where you find the definition of the interfaces.
## Contributing to *ELPA*
......
This file contains the release notes for the ELPA 2018.11.001 version
This file contains the release notes for the ELPA 2019.05.001.rc1 version
What is new?
-------------
......
......@@ -146,7 +146,7 @@ Local documentation (via man pages) should be available (if *ELPA* has been inst
For example "man elpa2_print_kernels" should provide the documentation for the *ELPA* program which prints all
the available kernels.
Also a [online doxygen documentation] (http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2018.11.001/html/index.html)
Also a [online doxygen documentation] (http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2019.05.001.rc1/html/index.html)
for each *ELPA* release is available.
......@@ -13,7 +13,7 @@ Local documentation (via man pages) should be available (if *ELPA* has been inst
For example "man elpa2_print_kernels" should provide the documentation for the *ELPA* program, which prints all
the available kernels.
Also a [online doxygen documentation] (http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2018.11.001/html/index.html)
Also a [online doxygen documentation] (http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2019.05.001.rc1/html/index.html)
for each *ELPA* release is available.
......@@ -36,9 +36,9 @@ The old, obsolete legacy API will be deprecated in the future !
Allready now, all new features of ELPA are only available with the new API. Thus, there
is no reason to keep the legacy API arround for too long.
The release ELPA 2018.11.001 will be the last release, where the legacy API is
The release ELPA 2018.11.001 was the last release, where the legacy API has been
enabled by default (and can be disabled at build time).
With release ELPA 2019.05.001 the legacy API will be disabled by default, however,
With release ELPA 2019.05.001 the legacy API is disabled by default, however,
can be still switched on at build time.
Most likely with the release ELPA 2019.11.001 the legacy API will be deprecated and
not supported anymore.
......@@ -200,7 +200,7 @@ The following table gives a list of all supported parameters which can be used t
## III) List of computational routines ##
The following compute routines are available in *ELPA*: Please have a look at the man pages or [online doxygen documentation] (http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2018.11.001/html/index.html) for details.
The following compute routines are available in *ELPA*: Please have a look at the man pages or [online doxygen documentation] (http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2019.05.001.rc1/html/index.html) for details.
| Name | Purpose | since API version |
......
......@@ -22,7 +22,7 @@ The *ELPA* library consists of two main parts:
Both variants of the *ELPA* solvers are available for real or complex singe and double precision valued matrices.
Thus *ELPA* provides the following user functions (see man pages or [online] (http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2018.11.001/html/index.html) for details):
Thus *ELPA* provides the following user functions (see man pages or [online] (http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2019.05.001.rc1/html/index.html) for details):
- elpa_get_communicators : set the row / column communicators for *ELPA*
- elpa_solve_evp_complex_1stage_{single|double} : solve a {single|double} precision complex eigenvalue proplem with the *ELPA 1stage* solver
......
......@@ -52,8 +52,8 @@ fi
AC_MSG_CHECKING(whether legacy interface should be provided)
AC_ARG_ENABLE([legacy-interface],
AS_HELP_STRING([--disable-legacy-interface],
[do not build legacy API, default yes]),
AS_HELP_STRING([--enable-legacy-interface],
[build legacy API, default no]),
[
if test x"$enableval" = x"yes"; then
enable_legayc=yes
......@@ -61,7 +61,7 @@ AC_ARG_ENABLE([legacy-interface],
enable_legacy=no
fi
],
[enable_legacy=yes])
[enable_legacy=no])
AC_MSG_RESULT([${enable_legacy}])
AM_CONDITIONAL([ENABLE_LEGACY],[test x"$enable_legacy" = x"yes"])
if test x"${enable_legacy}" = x"yes"; then
......@@ -1448,21 +1448,21 @@ m4_foreach_w([elpa_m4_kind],[real complex],[
])
])
echo " "
echo "***********************************************************************"
echo "* ELPA 2018.11.001 will be the last release where the old, obsolete, *"
echo "* legacy API is enabled by default! In the 2019.05.001 release *"
echo "* the legacy API will be still available (but as default switched *"
echo "* off). With the 2019.11.001 release it will be abolished! *"
echo "***********************************************************************"
echo " "
echo " "
#echo " "
#echo "***********************************************************************"
#echo "* This is a the first release candidate of ELPA 2018.11.001.rc1 *"
#echo "* There might be still some changes until the final release of *"
#echo "* ELPA 2018.11.001 *"
#echo "* ELPA 2018.11.001 will be the last release where the old, obsolete, *"
#echo "* legacy API is enabled by default! In the 2019.05.001 release *"
#echo "* the legacy API will be still available (but as default switched *"
#echo "* off). With the 2019.11.001 release it will be abolished! *"
#echo "***********************************************************************"
#echo " "
#echo " "
echo "***********************************************************************"
echo "* This is a the first release candidate of ELPA 2019.05.001.rc1 *"
echo "* There might be still some changes until the final release of *"
echo "* ELPA 2019.05.001 *"
echo "***********************************************************************"
echo " "
if test x"$enable_kcomputer" = x"yes" ; then
echo " "
......
......@@ -19,7 +19,7 @@
%define with_openmp 0
Name: elpa
Version: 2018.11.001
Version: 2019.05.001.rc1
Release: 1
Summary: A massively parallel eigenvector solver
License: LGPL-3.0
......
AC_PREREQ([2.69])
AC_INIT([elpa_test_project],[2018.11.001], elpa-library@rzg.mpg.de)
elpaversion="2018.11.001"
AC_INIT([elpa_test_project],[2019.05.001.rc1], elpa-library@rzg.mpg.de)
elpaversion="2019.05.001.rc1"
AC_CONFIG_SRCDIR([src/test_real.F90])
AM_INIT_AUTOMAKE([foreign -Wall subdir-objects])
......
AC_PREREQ([2.69])
AC_INIT([elpa_test_project],[2018.11.001], elpa-library@rzg.mpg.de)
elpaversion="2018.11.001"
AC_INIT([elpa_test_project],[2019.05.001.rc1], elpa-library@rzg.mpg.de)
elpaversion="2019.05.001.rc1"
AC_CONFIG_SRCDIR([src/test_real.F90])
AM_INIT_AUTOMAKE([foreign -Wall subdir-objects])
......
AC_PREREQ([2.69])
AC_INIT([elpa2_test_project],[2018.11.001], elpa-library@rzg.mpg.de)
elpaversion="2018.11.001"
AC_INIT([elpa2_test_project],[2019.05.001.rc1], elpa-library@rzg.mpg.de)
elpaversion="2019.05.001.rc1"
AC_CONFIG_SRCDIR([src/test_real2.F90])
AM_INIT_AUTOMAKE([foreign -Wall subdir-objects])
......
AC_PREREQ([2.69])
AC_INIT([elpa_test_project],[2018.11.001], elpa-library@rzg.mpg.de)
elpaversion="2018.11.001"
AC_INIT([elpa_test_project],[2019.05.001.rc1], elpa-library@rzg.mpg.de)
elpaversion="2019.05.001.rc1"
AC_CONFIG_SRCDIR([src/test_real.c])
AM_INIT_AUTOMAKE([foreign -Wall subdir-objects])
......
AC_PREREQ([2.69])
AC_INIT([elpa_test_project],[2018.11.001], elpa-library@rzg.mpg.de)
elpaversion="2018.11.001"
AC_INIT([elpa_test_project],[2019.05.001.rc1], elpa-library@rzg.mpg.de)
elpaversion="2019.05.001.rc1"
AC_CONFIG_SRCDIR([src/test_real2.c])
AM_INIT_AUTOMAKE([foreign -Wall subdir-objects])
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment