From 6344a4685bfbf84cdee85540de5234882b2fc265 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Beno=C3=AEt=20Legat?= <benoit.legat@gmail.com>
Date: Wed, 15 May 2019 23:33:18 +0200
Subject: [PATCH 1/2] Add manual build instructions

---
 README.md | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index e3bd414..cea30ae 100644
--- a/README.md
+++ b/README.md
@@ -7,8 +7,20 @@
 [![][docs-stable-img]][docs-stable-url]
 [![][docs-latest-img]][docs-latest-url]
 
+If you get
+```
+ERROR: LoadError: LibraryProduct(nothing, ["libarpack"], :libarpack, "Prefix(~/.julia/packages/Arpack/cu5By/deps/usr)") is not satisfied, cannot generate deps.jl!
+```
+when building Arpack, download the source of the [v3.5.0 of arpack-ng](https://github.com/opencollab/arpack-ng/releases/tag/3.5.0),
+extract it in some `<directory>`, build it and do
+```
+$ cp <directory>/arpack-ng-3.5.0/SRC/.libs/libarpack.so.2.0.0 ~/.julia/packages/Arpack/cu5By/deps/usr/lib/
+$ julia -e 'import Pkg; Pkg.build("Arpack")'
+  Building Arpack → `~/.julia/packages/Arpack/UiiMc/deps/build.log`
+```
+
 [docs-latest-img]: https://img.shields.io/badge/docs-latest-blue.svg
 [docs-latest-url]: http://JuliaLinearAlgebra.github.io/Arpack.jl/latest/
 
 [docs-stable-img]: https://img.shields.io/badge/docs-stable-blue.svg
-[docs-stable-url]: http://JuliaLinearAlgebra.github.io/Arpack.jl/stable/
\ No newline at end of file
+[docs-stable-url]: http://JuliaLinearAlgebra.github.io/Arpack.jl/stable/

From eb7409580854af5ef1af704e497f00a846aa8915 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Beno=C3=AEt=20Legat?= <benoit.legat@gmail.com>
Date: Wed, 19 Jun 2019 13:55:58 +0200
Subject: [PATCH 2/2] Add more explanations

---
 README.md | 25 +++++++++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index cea30ae..3c1c512 100644
--- a/README.md
+++ b/README.md
@@ -7,12 +7,33 @@
 [![][docs-stable-img]][docs-stable-url]
 [![][docs-latest-img]][docs-latest-url]
 
+Julia wrapper for the [arpack](https://github.com/opencollab/arpack-ng/) library
+designed to solve large scale eigenvalue problems.
+
+## Installation
+
+You can install Arpack.jl through the Julia package manager:
+```julia
+julia> Pkg.add("Arpack")
+```
+
+Arpack.jl will use [BinaryProvider.jl](https://github.com/JuliaPackaging/BinaryProvider.jl)
+to automatically install the Arpack binaries.
+
+## Custom Installation
+
 If you get
 ```
 ERROR: LoadError: LibraryProduct(nothing, ["libarpack"], :libarpack, "Prefix(~/.julia/packages/Arpack/cu5By/deps/usr)") is not satisfied, cannot generate deps.jl!
 ```
-when building Arpack, download the source of the [v3.5.0 of arpack-ng](https://github.com/opencollab/arpack-ng/releases/tag/3.5.0),
-extract it in some `<directory>`, build it and do
+when building Arpack, it may be because your Julia installation uses your system
+blas for which the symbols are not suffixed by `_64_` while this is required by
+the compiled binaries provided by [BinaryProvider.jl](https://github.com/JuliaPackaging/BinaryProvider.jl).
+This is notably the case on [ArchLinux](https://www.archlinux.org/).
+In these case, compile binaries that do not require this suffix as follows.
+Download the source of the [v3.5.0 of arpack-ng](https://github.com/opencollab/arpack-ng/releases/tag/3.5.0),
+extract it in some `<directory>`, build it and do (note that you may need to
+update `cu6By` to match the one printed in the error message printed above).
 ```
 $ cp <directory>/arpack-ng-3.5.0/SRC/.libs/libarpack.so.2.0.0 ~/.julia/packages/Arpack/cu5By/deps/usr/lib/
 $ julia -e 'import Pkg; Pkg.build("Arpack")'