Merge pull request #3956 from martin-frbg/issue3955

Update Reference-LAPACK README to 3.11.0

Author: martin-frbg

lapack-netlib/README.md

@@ -1,6 +1,8 @@
 # LAPACK
 
 [![Build Status](https://travis-ci.org/Reference-LAPACK/lapack.svg?branch=master)](https://travis-ci.org/Reference-LAPACK/lapack)
+![CMake](https://github.com/Reference-LAPACK/lapack/actions/workflows/cmake.yml/badge.svg)
+![Makefile](https://github.com/Reference-LAPACK/lapack/actions/workflows/makefile.yml/badge.svg)
 [![Appveyor](https://ci.appveyor.com/api/projects/status/bh38iin398msrbtr?svg=true)](https://ci.appveyor.com/project/langou/lapack/)
 [![codecov](https://codecov.io/gh/Reference-LAPACK/lapack/branch/master/graph/badge.svg)](https://codecov.io/gh/Reference-LAPACK/lapack)
 [![Packaging status](https://repology.org/badge/tiny-repos/lapack.svg)](https://repology.org/metapackage/lapack/versions)
@@ -31,15 +33,18 @@
 * VERSION 3.7.1 : June 2017
 * VERSION 3.8.0 : November 2017
 * VERSION 3.9.0 : November 2019
+* VERSION 3.9.1 : April 2021
+* VERSION 3.10.0 : June 2021
+* VERSION 3.10.1 : April 2022
+* VERSION 3.11.0 : November 2022
 
 LAPACK is a library of Fortran subroutines for solving the most commonly
 occurring problems in numerical linear algebra.
 
 LAPACK is a freely-available software package. It can be included in commercial
 software packages (and has been). We only ask that that proper credit be given
 to the authors, for example by citing the LAPACK Users' Guide. The license used
-for the software is the modified BSD license, see:
-https://github.com/Reference-LAPACK/lapack/blob/master/LICENSE
+for the software is the [modified BSD license](https://github.com/Reference-LAPACK/lapack/blob/master/LICENSE).
 
 Like all software, it is copyrighted. It is not trademarked, but we do ask the
 following: if you modify the source for these routines we ask that you change
@@ -49,11 +54,8 @@ We will gladly answer any questions regarding the software. If a modification
 is done, however, it is the responsibility of the person who modified the
 routine to provide support.
 
-LAPACK is available from github at:
-https://github.com/reference-lapack/lapack
-
-LAPACK releases are also available on netlib at:
-http://www.netlib.org/lapack/
+LAPACK is [available from GitHub](https://github.com/Reference-LAPACK/lapack).
+LAPACK releases are also [available on netlib](http://www.netlib.org/lapack/).
 
 The distribution contains (1) the Fortran source for LAPACK, and (2) its
 testing programs.  It also contains (3) the Fortran reference implementation of
@@ -65,45 +67,47 @@ CBLAS, a C interface to the BLAS, and (5) LAPACKE, a C interface to LAPACK.
 
 ## Installation
 
- - LAPACK can be installed with `make`. The configuration have to be set in the
+ - LAPACK can be installed with `make`. The configuration must be set in the
    `make.inc` file. A `make.inc.example` for a Linux machine running GNU compilers
    is given in the main directory. Some specific `make.inc` are also available in
    the `INSTALL` directory.
- - LAPACK includes also the CMake build. You will need to have CMake installed
-   on your machine (CMake is available at http://www.cmake.org/). CMake will
-   allow an easy installation on a Windows Machine.
-   An example CMake build is:
+ - LAPACK includes also the [CMake](https://cmake.org/) build.  You will need
+   to have CMake installed on your machine.  CMake will allow an easy
+   installation on a Windows Machine.  An example CMake build to install the
+   LAPACK library under `$HOME/.local/lapack/` is:
    ```sh
    mkdir build
    cd build
    cmake -DCMAKE_INSTALL_LIBDIR=$HOME/.local/lapack ..
-   cmake --build -j . --target install
+   cmake --build . -j --target install
    ```
-   That installs the LAPACK library under $HOME/.local/lapack/
- - Specific information to run LAPACK under Windows is available at
-   http://icl.cs.utk.edu/lapack-for-windows/lapack/.
-
+ - LAPACK can be built and installed using [vcpkg](https://github.com/Microsoft/vcpkg/) dependency manager:
+   ```sh
+   git clone https://github.com/Microsoft/vcpkg.git
+   cd vcpkg
+   ./bootstrap-vcpkg.sh  # ./bootstrap-vcpkg.bat for Windows
+   ./vcpkg integrate install
+   ./vcpkg install lapack
+   ```
+   The lapack port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please [create an issue or pull request](https://github.com/Microsoft/vcpkg) on the vcpkg repository.
 
 ## User Support
 
 LAPACK has been thoroughly tested, on many different types of computers. The
 LAPACK project supports the package in the sense that reports of errors or poor
 performance will gain immediate attention from the developers. Such reports,
 descriptions of interesting applications, and other comments should be sent by
-electronic mail to [email protected].
-
-For further information on LAPACK please read our FAQ at
-http://www.netlib.org/lapack/#_faq.
+email to [the LAPACK team](mailto:[email protected]).
 
 A list of known problems, bugs, and compiler errors for LAPACK is
-maintained on netlib
-http://www.netlib.org/lapack/release_notes.html.
-Please see as well
-https://github.com/Reference-LAPACK/lapack/issues.
+[maintained on netlib](http://www.netlib.org/lapack/release_notes.html).
+Please see as well the [GitHub issue tracker](https://github.com/Reference-LAPACK/lapack/issues).
 
-A User forum is also available to help you with the LAPACK library at
-http://icl.cs.utk.edu/lapack-forum/.
-You can also contact directly the LAPACK team at [email protected].
+For further information on LAPACK please read our [FAQ](http://www.netlib.org/lapack/faq.html)
+and [Users' Guide](http://www.netlib.org/lapack/lug/lapack_lug.html).
+A [user forum](http://icl.cs.utk.edu/lapack-forum/) and specific information for
+[running LAPACK under Windows](http://icl.cs.utk.edu/lapack-for-windows/lapack/).
+is also available to help you with the LAPACK library.
 
 
 ## Testing
@@ -114,14 +118,9 @@ you run the test suite.
 For complete information on the LAPACK Testing please consult LAPACK Working
 Note 41 "Installation Guide for LAPACK".
 
-## User Guide
-
-To view an HTML version of the Users' Guide please refer to the URL
-  http://www.netlib.org/lapack/lug/lapack_lug.html.
 
 ## LAPACKE
 
-LAPACK now includes the LAPACKE package.  LAPACKE is a Standard C language API
-for LAPACK This was born from a collaboration of the LAPACK and INTEL Math
-Kernel Library teams. See:
-http://www.netlib.org/lapack/#_standard_c_language_apis_for_lapack.
+LAPACK now includes the [LAPACKE](http://www.netlib.org/lapack/lapacke.html)
+package.  LAPACKE is a Standard C language API for LAPACK that was born from a
+collaboration of the LAPACK and INTEL Math Kernel Library teams.