Put back UUID example of setting custom hdf5 binaries

JuliaIO · Sep 8, 2023 · b333081 · b333081
1 parent af086d1
commit b333081
Showing 1 changed file with 11 additions and 0 deletions.
diff --git a/docs/src/index.md b/docs/src/index.md
@@ -63,6 +63,17 @@ set_preferences!(
  "libhdf5_hl" => "/usr/lib/x86_64-linux-gnu/hdf5/mpich/libhdf5_hl.so", force = true)
 ```
 
+If HDF5 cannot be loaded, it may be useful to use the UUID to change these settings:
+
+```julia
+using Preferences, UUIDs
+
+set_preferences!(
+ UUID("f67ccb44-e63f-5c2f-98bd-6dc0ccc4ba2f"), # UUID of HDF5.jl,
+ "libhdf5" => "/usr/lib/x86_64-linux-gnu/hdf5/mpich/libhdf5.so",
+ "libhdf5_hl" => "/usr/lib/x86_64-linux-gnu/hdf5/mpich/libhdf5_hl.so", force = true)
+```
+
 Also see the file `test/configure_packages.jl` for an example.
 
 Both, the MPI preferences and the preferences for HDF5.jl write to a file called LocalPreferences.toml in the project directory. After performing the described steps this file could look like the following: