From 7831cd2d74cc99659cf03e8b05ca4c7d7a3baea8 Mon Sep 17 00:00:00 2001
From: "Wuttke, Joachim" <j.wuttke@fz-juelich.de>
Date: Mon, 7 Aug 2023 15:21:42 +0200
Subject: [PATCH] Update linux.md: glibc details under "Prerequisites"

---
 hugo/content/installation/install/linux.md | 53 +++++++++++-----------
 1 file changed, 26 insertions(+), 27 deletions(-)

diff --git a/hugo/content/installation/install/linux.md b/hugo/content/installation/install/linux.md
index 2043e802b37..4fb107010b7 100644
--- a/hugo/content/installation/install/linux.md
+++ b/hugo/content/installation/install/linux.md
@@ -5,7 +5,9 @@ weight = 30
 
 ## Install on Linux
 
-#### Prequisite: Python
+### Prequisites
+
+##### Python
 
 As a prerequisite, Python must be installed.
 Check the version with `python3 --version`.
@@ -14,7 +16,20 @@ can be inferred from the available installers at {{% files-versioned %}}/linux_x
 
 In the following, we assume that `python` is an alias for `python3`.
 
-#### Install BornAgain as Python-only package
+##### glibc
+
+Our BornAgain binaries (pip package and installer) are built on Debian 11 and require (https://www.gnu.org/software/libc/)[glibc] version 2.31 or higher.
+
+To see which glibc version is available on your system, run 
+```
+$ ldd --version
+```
+Versions for other Linux distributions can be seen at 
+https://repology.org/project/glibc/versions
+
+### Installation methods
+
+##### as Python-only package
 
 If the BornAgain GUI is not required as only Python scripting mode is to be used,
 then BornAgain can be installed as a Python package from the `pip` repository:
@@ -22,7 +37,15 @@ then BornAgain can be installed as a Python package from the `pip` repository:
 $ python -m pip install bornagain
 ```
 
-#### Install using our installer
+##### as a Debian package
+
+A BornAgain Debian/Ubuntu package (Python and GUI) is provided by external maintainers
+  at https://tracker.debian.org/pkg/bornagain.
+
+The only drawback is that versions may be lagging behind,
+in *unstable* by a couple of months, in *stable* by several years.
+
+##### using our installer
 
 A Linux installer for BornAgain (Python and GUI)
 can be downloaded from {{% files-versioned %}}/linux_x64.
@@ -47,27 +70,3 @@ $ ./bin/bornagain
 The GUI package was tested with the standard X11 window system.
 If you are using the alternative Wayland window system,
 please let us know about your experience.
-
-#### Compatibility with the platform
-
-BornAgain is built on Debian 11 and requires standard C library of version **2.31 or higher** (GLIBC version).
-
-This appies to both pip package and the installer.
-
-To see which GLIBC version is available on your system, run 
-```
-$ ldd --version
-```
-
-GLIBC versions of other Linux distributions can be seen at 
-https://repology.org/project/glibc/versions
-
-#### Install BornAgain as a Debian package
-
-A BornAgain Debian/Ubuntu package (Python and GUI) is provided by external maintainers
-  at https://tracker.debian.org/pkg/bornagain.
-
-The only drawback is that versions may be lagging behind,
-in *unstable* by a couple of months, in *stable* by several years.
-
-{{% children  %}}
-- 
GitLab