From 3938184f70b0a354098c88cac4a30e742f1ffc82 Mon Sep 17 00:00:00 2001
From: Pierre Blanchard <pierre.blanchard@arm.com>
Date: Fri, 31 May 2024 11:07:41 +0000
Subject: [PATCH] Fix links in docs and light updates.

Change-Id: I7de1554ae78670c3afc60b250fb9f7f3f1ba7df7
---
 docs/build-with-cmake.md |  2 +-
 docs/compile.xhtml       | 24 +++++++++++++++---------
 2 files changed, 16 insertions(+), 10 deletions(-)

diff --git a/docs/build-with-cmake.md b/docs/build-with-cmake.md
index 45fb942f..6c8c7f3d 100644
--- a/docs/build-with-cmake.md
+++ b/docs/build-with-cmake.md
@@ -121,7 +121,7 @@ optimized, or any other special set of flags.
   * `RelWithDebInfo`: builds optimized code with debug information as well
 
 - `CMAKE_INSTALL_PREFIX`: The prefix the use when running `make install`.
-			  Defaults to /usr/local on GNU/Linux and MacOS.
+			  Defaults to /usr/local on GNU/Linux and macOS.
 			  Defaults to C:/Program Files on Windows.
 
 - `CMAKE_C_FLAGS_RELEASE` : The optimization options used by the compiler.
diff --git a/docs/compile.xhtml b/docs/compile.xhtml
index 285bb9c3..7eee7cee 100644
--- a/docs/compile.xhtml
+++ b/docs/compile.xhtml
@@ -22,7 +22,7 @@
   <li><a class="underlined" href="compile.xhtml">Compiling and installing the library</a></li>
     <ul class="disc">
       <li><a href="#preliminaries">Preliminaries</a></li>
-      <li><a href="#cmakevars">Common CMake variables</a></li>
+      <li><a href="#quickstart">Quick start</a></li>
       <li><a href="#linux">Compiling and installing the library on Linux</a></li>
       <li><a href="#MSVC">Compiling the library with Microsoft Visual C++</a></li>
       <li><a href="#hello">Compiling and running "Hello SLEEF"</a></li>
@@ -62,7 +62,7 @@ the <a class="underlined" href="https://gitlab.kitware.com/cmake/community/-/wik
 introductions in the wiki</a>.
 </p>
 
-<h2>Quick start</h2>
+<h2 id="quickstart">Quick start</h2>
 
 <p class="noindent">
 You will find quick start instructions in the sources or via GitHub in the
@@ -70,14 +70,22 @@ You will find quick start instructions in the sources or via GitHub in the
 file.
 </p>
 
+<p class="noindent">
+A more detailed description of CMake usage is provided in the
+<a class="underlined" href="https://github.com/shibatch/sleef/blob/master/docs/build-with-cmake.md">docs/build-with-cmake.md</a>
+file, along with
+<a class="underlined" href="https://github.com/shibatch/sleef/blob/master/docs/build-with-cmake.md#sleef-variables">a list of CMake variables</a>
+relevant to users.
+</p>
+
 <h2 id="linux">Compiling and installing the library on Linux</h2>
 
 <p class="noindent">
-  In order to build the library, you need to install OpenMP. In order
-  to test the library, you need to install libmpfr, libssl and
-  libfftw3. Availability of these libraries are checked upon execution
-  of cmake. Please change the directory to sleef-3.X and run the
-  following commands.
+  In order to build the library, you may want to install OpenMP (optional).
+  In order to test the library, you need to install libmpfr, libssl and
+  libfftw3 (optional). Availability of these libraries are checked upon
+  execution of cmake.
+  Please change the directory to sleef-3.X and run the following commands.
 
   <pre class="command">$ sudo apt-get install libmpfr-dev libssl-dev libfftw3-dev
 $ cmake -S . -B build/ ..
@@ -87,8 +95,6 @@ $ sudo cmake --install build/ --prefix /path/to/install/dir
   </pre>
 </p>
 
-<br/>
-
 <p>
   In order to uninstall the libraries and headers, run the following command.
 </p>