documentation

Author: galabovaa

docs/src/installation.md

@@ -1,6 +1,6 @@
 # Install HiGHS
 
-## Compile from source 
+## Compile from source
 
 HiGHS uses CMake as build system, and requires at least version
 3.15. Details about building from source using CMake can be found in `HiGHS/cmake/README.md`.
@@ -11,62 +11,64 @@ HiGHS does not have any external dependencies, however, the new interior point s
 
 #### BLAS
 
-On Linux, libblas and libopenblas are supported. We recomment libopenblas for its better performance. Install with 
+On Linux, libblas and libopenblas are supported. We recomment libopenblas for its better performance, and it is found by default if available on the system. Install with
 
 ```
 sudo apt update
 sudo apt install libopenblas-dev
 ```
 
-On MacOS no BLAS installation is required because HiPO uses [Apple Accelerate](https://developer.apple.com/accelerate/).
+On MacOS no BLAS installation is required because HiPO uses [Apple Accelerate](https://developer.apple.com/accelerate/) by default.
 
-On Windows, OpenBLAS is required. It could be installed via [vcpkg](https://learn.microsoft.com/en-us/vcpkg/get_started/overview) with 
+On Windows, OpenBLAS is required. It could be installed via [vcpkg](https://learn.microsoft.com/en-us/vcpkg/get_started/overview) with
 
 ```
 vcpkg install openblas[threads]
 ```
 Note, that `[threads]` is required for HiPO.
 
+To specify explicitly which BLAS vendor to look for, `BLA_VENDOR` coud be set in CMake, e.g. `-DBLA_VENDOR=Apple` or `-DBLA_VENDOR=OpenBLAS`. Alternatively, to specify which BLAS library to use, set `BLAS_LIBRARIES` to the full path of the library e.g. `-DBLAS_LIBRARIES=/path_to/libopenblas.so`.
+
 #### Metis
-There are some known issues with Metis so the recommented version is in [this fork](https://github.com/galabovaa/METIS/tree/510-ts), branch 510-ts. This is version 5.10 with several patches for more reliable build and execution. Clone the repository with 
+There are some known issues with Metis so the recommented version is in [this fork](https://github.com/galabovaa/METIS/tree/510-ts), branch 510-ts. This is version 5.10 with several patches for more reliable build and execution. Clone the repository with
 ```
 git clone https://github.com/galabovaa/METIS.git
 cd METIS
 git checkout 510-ts
 ```
 
-Then build with 
+Then build with
 ```
 cmake -S. -B build
 -DGKLIB_PATH=/path_to_METIS_repo/GKlib
--DCMAKE_INSTALL_PREFIX=path_to_installs_dir 
+-DCMAKE_INSTALL_PREFIX=path_to_installs_dir
 cmake --build build
-cmake --install build 
+cmake --install build
 ```
 
-On Windows, do not forget to specify configuration type 
+On Windows, do not forget to specify configuration type
 ```
 cmake --build build --config Release
 ```
 
-### HiPO 
+### HiPO
 
-To install HiPO, on Linux and MacOS, run 
+To install HiPO, on Linux and MacOS, run
 ```
-cmake -S. -B build -DHIPO=ON -DMETIS_ROOT=path_to_installs_dir 
+cmake -S. -B build -DHIPO=ON -DMETIS_ROOT=path_to_installs_dir
 ```
 On Windows, you also need to specify the path to OpenBLAS. If it was installed with vcpkg as suggested above, add the path to `vcpkg.cmake` to the CMake flags, e.g.
 ```
 -DCMAKE_TOOLCHAIN_FILE="C:/vcpkg/scripts/buildsystems/vcpkg.cmake"
 ```
 
-## Bazel build 
+## Bazel build
 
-Alternatively, building with Bazel is supported for Bazel-based projects. To build HiGHS, from the root directory, run 
+Alternatively, building with Bazel is supported for Bazel-based projects. To build HiGHS, from the root directory, run
 
 ```
 bazel build //...
-``` 
+```
 
 ## Install via a package manager
 
@@ -105,7 +107,7 @@ filename.
 
 ## [Building HiGHS with NVidia GPU support](@id gpu-build)
 
-HiGHS must be built, from the root directory, with 
+HiGHS must be built, from the root directory, with
 
 ```
 cmake -S. -Bbuild -DCUPDLP_GPU=ON
@@ -117,21 +119,21 @@ This uses [FindCUDAToolkit](https://cmake.org/cmake/help/latest/module/FindCUDAT
 
 #### Find CUDA
 
-If CUDA is not found automatically, there is an extra option `-DCUPDLP_FIND_CUDA=ON`, to be used with `-DCUPDLP_GPU=ON`, which instead uses `cuPDLP-C`'s `FindCUDAConf.cmake`. 
+If CUDA is not found automatically, there is an extra option `-DCUPDLP_FIND_CUDA=ON`, to be used with `-DCUPDLP_GPU=ON`, which instead uses `cuPDLP-C`'s `FindCUDAConf.cmake`.
 
-This requires the environment variable `CUDA_HOME` to be set to the directory with the CUDA installation. Having set this, run 
+This requires the environment variable `CUDA_HOME` to be set to the directory with the CUDA installation. Having set this, run
 
 ```
 cmake -S. -Bbuild -DCUPDLP_GPU=ON -DCUPDLP_FIND_CUDA=ON
 cmake --build build --parallel
 ```
 
-to build HiGHS. 
+to build HiGHS.
 
 ### Bazel build with Cuda
 
-Alternatively, for Bazel run 
+Alternatively, for Bazel run
 
 ```
 bazel build //... --//:cupdlp_gpu
-``` 
+```