From cce74aa585ab9f18f136666386d545d66b14113d Mon Sep 17 00:00:00 2001
From: Dominique Orban <dominique.orban@gmail.com>
Date: Fri, 26 Aug 2022 23:46:56 -0400
Subject: [PATCH] more instructions for Homebrew users

---
 docs/src/index.md | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/docs/src/index.md b/docs/src/index.md
index 4475d35..bcf2a46 100644
--- a/docs/src/index.md
+++ b/docs/src/index.md
@@ -142,12 +142,16 @@ mpirun -np 4 julia examples/mumps_mpi.jl
 **Note: MUMPS is already precompiled with Yggdrasil for all platforms except Windows.**
 
 To use your custom MUMPS, set the environment variable `JULIA_MUMPS_LIBRARY_PATH`
-to point to the shared library before `using MUMPS`. Note that MUMPS version 5.5.1 is needed.
-
-For example:
-```julia
-ENV["JULIA_MUMPS_LIBRARY_PATH"] = "~/Applications/MUMPS_5.5.1/lib"
-using MUMPS
+to point to the shared library before `using MUMPS`.
+Note that the same version of MUMPS as used by the `MUMPS_jll` artifact is needed.
+
+For example, macOS users may install precompiled MUMPS binaries from the Homebrew tap `dpo/mumps-jl` as follows:
+```bash
+brew tap dpo/mumps-jl
+brew install mpich-mumps
+export JULIA_MUMPS_LIBRARY_PATH=$(brew --prefix)/opt/mpich-mumps/lib
 ```
 
-Alternatively, you can create an entry in `.julia/config/startup.jl` or set these permanently through your operating system.
+Apple Silicon users should remember to use `arch x86_64 brew` to refer to Intel binaries run through Rosetta, as we do not (yet) ship Silicon binaries of MUMPS via Homebrew.
+
+The `JULIA_MUMPS_LIBRARY_PATH` environment variable may be set permanently in the shell's startup file, or in `$HOME/.julia/config/startup.jl`.