Update the description of the package

Author: IvanUkhov

Cargo.toml

@@ -1,13 +1,13 @@
 [package]
 name = "netlib-src"
-version = "0.7.1"
+version = "0.7.2"
 license = "Apache-2.0/MIT"
 authors = [
     "Corey Richardson <[email protected]>",
     "Ivan Ukhov <[email protected]>",
     "Mason Smith <[email protected]>",
 ]
-description = "The package provides BLAS and LAPACK using the Netlib implementation."
+description = "The package provides an implementation of BLAS and LAPACK via Netlib."
 homepage = "https://github.com/cmr/netlib-src"
 repository = "https://github.com/cmr/netlib-src"
 readme = "README.md"

README.md

@@ -1,8 +1,7 @@
-# netlib-src [![Package][package-img]][package-url] [![Build][build-img]][build-url]
+# netlib-src [![Package][package-img]][package-url] [![Documentation][documentation-img]][documentation-url] [![Build][build-img]][build-url]
 
-The package provides [BLAS][1] and [LAPACK][2] using the [Netlib][3]
-implementation. By default, the package will build and use a bundled Netlib,
-which requires a Fortran and C compiler.
+The package provides an implementation of [BLAS] and [LAPACK] via [Netlib]. The
+usage of the package is explained [here][usage].
 
 The following Cargo features are supported:
 
@@ -11,28 +10,20 @@ The following Cargo features are supported:
 * `static` to link to Netlib statically, and
 * `system` to skip building the bundled Netlib.
 
-## Where are all the FFI definitions?
-
-This package provides only an implementation of BLAS and LAPACK. Bindings are
-available in [blas-sys][4] and [lapack-sys][5], and wrappers are available in
-[blas][6] and [lapack][7].
-
 ## Contribution
 
 Your contribution is highly appreciated. Do not hesitate to open an issue or a
 pull request. Note that any contribution submitted for inclusion in the project
 will be licensed according to the terms given in [LICENSE.md](LICENSE.md).
 
-[1]: https://en.wikipedia.org/wiki/Basic_Linear_Algebra_Subprograms
-[2]: https://en.wikipedia.org/wiki/LAPACK
-[3]: http://www.netlib.org/lapack
-
-[4]: https://github.com/stainless-steel/blas-sys
-[5]: https://github.com/stainless-steel/lapack-sys
-[6]: https://github.com/stainless-steel/blas
-[7]: https://github.com/stainless-steel/lapack
+[blas]: https://en.wikipedia.org/wiki/BLAS
+[lapack]: https://en.wikipedia.org/wiki/LAPACK
+[netlib]: http://www.netlib.org/
+[usage]: https://blas-lapack-rs.github.io/usage
 
 [build-img]: https://travis-ci.org/cmr/netlib-src.svg?branch=master
 [build-url]: https://travis-ci.org/cmr/netlib-src
+[documentation-img]: https://docs.rs/netlib-src/badge.svg
+[documentation-url]: https://docs.rs/netlib-src
 [package-img]: https://img.shields.io/crates/v/netlib-src.svg
 [package-url]: https://crates.io/crates/netlib-src

src/lib.rs

@@ -1 +1,17 @@
+//! Implementation of [BLAS] and [LAPACK] via [Netlib]
+//!
+//! The usage of the package is explained [here][usage].
+//!
+//! The following Cargo features are supported:
+//!
+//! * `cblas` to build CBLAS (enabled by default),
+//! * `lapacke` to build LAPACKE (enabled by default),
+//! * `static` to link to Netlib statically, and
+//! * `system` to skip building the bundled Netlib.
+//!
+//! [blas]: https://en.wikipedia.org/wiki/BLAS
+//! [lapack]: https://en.wikipedia.org/wiki/LAPACK
+//! [netlib]: http://www.netlib.org/
+//! [usage]: https://blas-lapack-rs.github.io/usage
+
 #![no_std]