From 82e07cbe6c8a04352dd8117c8df8e0f92ed6c4cc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?V=C3=ADt=20Ku=C4=8Dera?=
<26327373+vkucera@users.noreply.github.com>
Date: Wed, 26 Nov 2025 17:57:17 +0100
Subject: [PATCH 1/9] Restructure aliBuild installation instructions. Improve
text.
---
docs/gettingstarted/installing.md | 136 +++++++++++++-----------------
1 file changed, 60 insertions(+), 76 deletions(-)
diff --git a/docs/gettingstarted/installing.md b/docs/gettingstarted/installing.md
index 186ef5e3..d11002f1 100644
--- a/docs/gettingstarted/installing.md
+++ b/docs/gettingstarted/installing.md
@@ -5,48 +5,46 @@ title: Installing O2 and O2Physics
# Installing O2 and O2Physics
-ALICE software has several dependencies: aliBuild takes care of downloading them for you. aliBuild
-can also automatically download precompiled binaries if possible.
+Building software has become an increasingly complicated operation, as our software has many dependencies and we expect it to work both on your laptop and on the Grid.
+In addition, we support many Linux distributions and recent macOS versions.
-## Installing aliBuild
+ALICE uses [aliBuild](https://alisw.github.io/alibuild/) to build software.
-Building software has become an increasingly complicated operation, as our software has many dependencies and we expect it to work both on your laptop and on the Grid. In addition, we support many Linux distributions and recent macOS versions.
-
-ALICE uses aliBuild to build software. aliBuild:
+aliBuild
* knows how to build software via per-package recipes,
* manages the dependencies consistently,
+* can automatically download precompiled binaries if possible,
* rebuilds only what's necessary,
-* allows several versions of the same software to be installed at the same time.
-
-### Operating systems we support
+* allows several versions of the same software to be installed side by side.
-#### Prerequisites
+## Install aliBuild
-According to your operating system, please follow the prerequisites below. You will find a list of packages to install and configurations to perform.
+According to your operating system, please follow the corresponding instructions below.
-##### Primary supported platform
+Primary supported platforms:
-* [CentOS 7](#prereq-for-centos7)
-* [CentOS/AlmaLinux 8](#prereq-for-centos8)
-* [AlmaLinux 9](#prereq-for-alma9)
+* [CentOS 7](#alibuild-for-centos7)
+* [CentOS 8, AlmaLinux 8](#alibuild-for-centos8)
+* [AlmaLinux 9](#alibuild-for-alma9)
-##### Platforms supported on a best-effort basis
+Platforms supported on a best-effort basis:
-* [macOS Sonoma and Sequoia (14.0, 15.0)](#prereq-for-macos)
-* [Ubuntu (20.04 LTS, 22.04 LTS, 24.04 LTS)](#prereq-for-ubuntu)
-* [Fedora](#prereq-for-fedora)
+* [macOS](#alibuild-for-macos): Sonoma (14), Sequoia (15)
+* [Ubuntu](#alibuild-for-ubuntu): 20.04 LTS, 22.04 LTS, 24.04 LTS
+* [Fedora](#alibuild-for-fedora)
* Linux Mint
* Follow the instructions for the Ubuntu version your Linux Mint version is based on.
- * Specify the corresponding Ubuntu architecture when running the `aliBuild` command using the `-a` option (e.g. `-a ubuntu2004_x86-64` for Ubuntu 20.04). Use the `-a` option also with the `alienv` command.
+ * Specify the corresponding Ubuntu architecture when running `aliBuild` commands using the `-a` option (e.g. `-a ubuntu2404_x86-64` for Ubuntu 24.04). Use the `-a` option also with `alienv` commands.
If your operating system is *not* in any list, it does not mean our software won't work on it; it will be just more difficult for you to get support for it.
-Only in case you cannot install aliBuild in the way described above, you can install aliBuild manually. This procedure should only be used as a fall-back, in case you cannot follow the instructions for your operating system linked above.
+Only in case you cannot install aliBuild in the way described below, you can install aliBuild manually.
+This procedure should only be used as a fallback, in case you cannot follow the instructions for your operating system linked above.
-
aliBuild prerequisites for CentOS7
+### CentOS 7 {#alibuild-for-centos7}
-With root permission, i.e. `sudo` or as `root`install the prerequisits using:
+With root permissions, i.e. `sudo` or as `root`, install the prerequisites and aliBuild using:
```bash
cat << EOF > /etc/yum.repos.d/alice-system-deps.repo
@@ -62,9 +60,9 @@ yum update -y
yum install -y alibuild
```
- aliBuild prerequisites for CentOS8
+### CentOS 8, AlmaLinux 8 {#alibuild-for-centos8}
-With root permission, i.e. `sudo` or as `root` install the prerequisits using:
+With root permissions, i.e. `sudo` or as `root`, install the prerequisites and aliBuild using:
```bash
yum install -y epel-release
@@ -85,9 +83,9 @@ yum update -y
yum install -y alice-o2-full-deps alibuild
```
- aliBuild prerequisites for AlmaLinux9
+### AlmaLinux 9 {#alibuild-for-alma9}
-With root permission, i.e. `sudo` or as `root`install the prerequisits using:
+With root permissions, i.e. `sudo` or as `root`, install the prerequisites and aliBuild using:
```bash
dnf install -y epel-release dnf-plugins-core
@@ -105,69 +103,54 @@ dnf update -y
dnf install -y alice-o2-full-deps alibuild
```
-aliBuild prerequisites for macOS
+### macOS {#alibuild-for-macos}
-**Get Xcode**
+#### Get Xcode
Xcode bundles the necessary tools to build software in the apple ecosystem including compilers, build systems and version control.
-* Download it from the [App Store](https://itunes.apple.com/gh/app/xcode/id497799835?mt=12)
-* Open once installed. It will ask to install additional components - approve the action.
-* Open a terminal (Applicaions>Utilities>Terminal) and install the command line tools using:
-* `sudo xcode-select --install`
-* Approve the license conditions by
-`sudo xcodebuild -license`
+* Download it from the [App Store](https://itunes.apple.com/gh/app/xcode/id497799835?mt=12) and install it.
+* Open once installed. It will ask to install additional components. Approve the action.
+* Open a terminal (Applicaions>Utilities>Terminal) and install the command line tools using: `sudo xcode-select --install`
+* Approve the license conditions by: `sudo xcodebuild -license`
-**Get Homebrew**
+#### Get Homebrew
-[Homebrew](https://brew.sh/) is a command-line package manager for macOS used to install software packages similar to `yum` on CentOS or `apt` on Ubuntu.
+[Homebrew](https://brew.sh/) is a command-line package manager for macOS used to install software packages (similar to `yum` on CentOS or `apt` on Ubuntu).
* Install Homebrew using the [instructions on their webpage](https://brew.sh/).
-* Once installed detect any problems regarding Homebrew and your system using: `brew doctor`
+* Detect any problems regarding Homebrew and your system using: `brew doctor`.
-**Uninstall ROOT**
+#### Uninstall ROOT
-If you have an existing ROOT installation on your system, this will interfere with the aliBuild installation, and will cause difficult-to-debug compilation errors.
+If you have an existing ROOT installation on your system, it will interfere with the aliBuild installation and will cause difficult-to-debug compilation errors.
Please uninstall any existing copy of ROOT on your system. The uninstallation method depends on how you installed it. For example, if you originally installed ROOT using Homebrew, you should uninstall it using `brew uninstall root`.
After uninstalling ROOT, remove any reference to ROOT from your `.zprofile`, `.zshrc` and any other shell configuration files. Then close and re-open your terminal window.
-**Install the required packages**
+#### Install the required packages
Note that Homebrew does not run as root. Do not prepend sudo to any of the following commands.
-* Install the prerequisites and aliBuild via:
-```brew install alisw/system-deps/o2-full-deps alisw/system-deps/alibuild```
-* Set up Homebrew in your shell by running the following command:
-```echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile```
+* Install the prerequisites and aliBuild via: `brew install alisw/system-deps/o2-full-deps alisw/system-deps/alibuild`
+* Set up Homebrew in your shell by: `echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile`
* Close Terminal and reopen it to apply changes.
-aliBuild prerequisites for Ubuntu
-
-ALICE software on Ubuntu is supported on a best effort basis. There is no guarantee that software builds or runs correctly. Support requests might have low priority. We were able to successfully build on:
+### Ubuntu {#alibuild-for-ubuntu}
-* Ubuntu 20.04 LTS
-* Ubuntu 22.04 LTS
-* Ubuntu 24.04 LTS
+#### Install required system packages
-**Install required system packages**
-
-With root permissions, i.e. sudo, update your package sources:
+Update your package sources and install the required system packages:
```bash
sudo apt update -y
-```
-
-With root permissions, i.e. `sudo`, install the following packages:
-
-```bash
sudo apt install -y curl libcurl4-gnutls-dev build-essential gfortran libmysqlclient-dev xorg-dev libglu1-mesa-dev libfftw3-dev libxml2-dev git unzip autoconf automake autopoint texinfo gettext libtool libtool-bin pkg-config bison flex libperl-dev libbz2-dev swig liblzma-dev libnanomsg-dev rsync lsb-release environment-modules libglfw3-dev libtbb-dev python3-dev python3-venv python3-pip graphviz libncurses-dev software-properties-common gtk-doc-tools
```
-**Installing aliBuild**
+#### Install aliBuild {#install-alibuild-for-ubuntu}
-AliBuild, our build tool, is installed as a standard ubuntu package, provided you enable the alisw PPA repository. This is done with:
+Add the [alisw PPA repository](https://launchpad.net/~alisw/+archive/ubuntu/ppa) and install aliBuild as an Ubuntu package:
```bash
sudo add-apt-repository ppa:alisw/ppa
@@ -175,9 +158,9 @@ sudo apt update
sudo apt install python3-alibuild
```
-aliBuild prerequisites for Fedora
+### Fedora {#alibuild-for-fedora}
-With root permissions, i.e. `sudo` or as `root` install the prerequisites using:
+With root permissions, i.e. `sudo` or as `root`, install the prerequisites and aliBuild using:
```bash
yum install -y epel-release
@@ -198,9 +181,9 @@ yum update -y
yum install -y alice-o2-full-deps alibuild
```
-### Configure aliBuild
+## Configure aliBuild
-After you are done installing alibuild you need to configure it by adding the two following lines to your `~/.bashrc`, `~/.bash_profile`, `~/.zshrc` or `~/.zprofile` (depending on your operating system and configuration):
+After installing aliBuild, configure it by adding the following lines to your `~/.bashrc`, `~/.bash_profile`, `~/.zshrc` or `~/.zprofile` (depending on your operating system and configuration):
```bash
export ALIBUILD_WORK_DIR="$HOME/alice/sw"
@@ -211,9 +194,9 @@ The first line tells what directory is used as "build cache", the second line in
You need to close and reopen your terminal for the change to be effective. The directory `~/alice/sw` will be created the first time you run aliBuild.
-Note that this directory tends to grow in size over time, and it is the one you need to remove in case of cleanups.
+Note that this directory tends to grow in size over time and it is the one you need to [clean up](#delete-obsolete-builds) occasionally.
-When `aliBuild`is installed on your computer and your prerequisits are statisfied, you can move to the next step.
+When `aliBuild` is installed on your computer and your prerequisites are satisfied, you can move to the next step.
See also [shell rc utilities](../tools/README.md#shell-rc-utilities).
@@ -221,7 +204,7 @@ See also [shell rc utilities](../tools/README.md#shell-rc-utilities).
We assume your work area is `~/alice`.
Start with a clean shell where you are not in an `alienv` environment.
-Create the directory and move to it (all the following commands need to be executed in this folder):
+Create the directory and move to it (all the following commands need to be executed in this directory):
```bash
mkdir -p ~/alice
@@ -236,11 +219,13 @@ aliBuild init O2Physics@master
```
If you perform `ls` under your work directory, you will see the packages you have downloaded via
-`aliBuild init`, plus an `alidist` directory.
+`aliBuild init`, plus the `alidist` directory.
+
+The `alidist` directory contains software recipes, telling aliBuild how the software is built.
-The `alidist` directory contains software recipes, telling aliBuild how the software is built. Your
-`alidist` directory and your software source code are Git directories **managed by you**: you need
-to keep them up-to-date manually.
+```warning
+Your `alidist` directory and your software source code are Git repositories **managed by you**. You need to keep them up to date manually.
+```
## Check your prerequisites
@@ -248,8 +233,7 @@ to keep them up-to-date manually.
aliDoctor O2Physics
```
-aliDoctor will warn you that some packages have to be built as they could not be found from the
-system.
+aliDoctor will warn you if some packages have to be built as they could not be found on the system.
## Build and rebuild
@@ -311,8 +295,8 @@ Load the latest O2Physics version you have built.
alienv enter O2Physics/latest
```
-The `alienv enter` command drops you to a new shell with the O2Physics environment. Unload the packages by simply exiting the environment with
-the `exit` command.
+The `alienv enter` command drops you to a new shell with the O2Physics environment.
+Unload the packages by simply exiting the environment with the `exit` command.
```warning
Dependencies are loaded automatically. Do not attempt to load O2 or ROOT as well! You will find them automatically in the environment. `alienv enter` is verbose and will inform you about the loaded packages.
From 9ebc3008c9a12edf7ef1ed5fd0c5f603ec1c4dc1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?V=C3=ADt=20Ku=C4=8Dera?=
<26327373+vkucera@users.noreply.github.com>
Date: Wed, 26 Nov 2025 18:02:31 +0100
Subject: [PATCH 2/9] Add instructions for component-based build.
---
docs/gettingstarted/installing.md | 14 ++++++++++++++
1 file changed, 14 insertions(+)
diff --git a/docs/gettingstarted/installing.md b/docs/gettingstarted/installing.md
index d11002f1..d368f26f 100644
--- a/docs/gettingstarted/installing.md
+++ b/docs/gettingstarted/installing.md
@@ -241,6 +241,20 @@ aliDoctor will warn you if some packages have to be built as they could not be f
aliBuild build O2Physics
```
+To set the maximum number of parallel jobs `N`, provide the `-j N` option.
+
+### Component-based build
+
+To build only parts of O2Physics, provide a space-separated list of requested directories (followed by `/install`) using the `O2PHYSICS_COMPONENTS` variable, e.g.:
+
+```bash
+O2PHYSICS_COMPONENTS="Common/install Tools/install Tutorials/install" aliBuild build O2Physics
+```
+
+```warning
+On Linux, the components providing the required linked shared libraries also need to be included (e.g. `Tools/ML` for `O2Physics::MLCore`).
+```
+
See the [Troubleshooting](../troubleshooting/README.md) section for debugging tips if the build fails.
## Delete obsolete builds
From 133fdb42288ee54af6210f47db2f55ef1e900311 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?V=C3=ADt=20Ku=C4=8Dera?=
<26327373+vkucera@users.noreply.github.com>
Date: Wed, 26 Nov 2025 18:53:45 +0100
Subject: [PATCH 3/9] Move cleanup after installation use
---
docs/gettingstarted/installing.md | 50 +++++++++++++++----------------
1 file changed, 25 insertions(+), 25 deletions(-)
diff --git a/docs/gettingstarted/installing.md b/docs/gettingstarted/installing.md
index d368f26f..064987a5 100644
--- a/docs/gettingstarted/installing.md
+++ b/docs/gettingstarted/installing.md
@@ -257,6 +257,31 @@ On Linux, the components providing the required linked shared libraries also nee
See the [Troubleshooting](../troubleshooting/README.md) section for debugging tips if the build fails.
+## Use your local software installations
+
+You will not find the packages you have built immediately available on your shell.
+We provide a tool called `alienv` that configures your shell according to the packages you want to load.
+`alienv` is capable of switching between different versions of the same package without a hassle.
+
+Load the latest O2Physics version you have built.
+
+```bash
+alienv enter O2Physics/latest
+```
+
+The `alienv enter` command drops you to a new shell with the O2Physics environment.
+Unload the packages by simply exiting the environment with the `exit` command.
+
+```warning
+Dependencies are loaded automatically. Do not attempt to load O2 or ROOT as well! You will find them automatically in the environment. `alienv enter` is verbose and will inform you about the loaded packages.
+```
+
+```tip
+If you have built several Git branches of O2Physics, you can enter the environment of a given branch `[branch]` with `alienv enter O2Physics/latest-[branch]-o2`.
+
+You can list all your available packages with `alienv q`.
+```
+
## Delete obsolete builds
With frequent rebuilding of packages, obsolete builds can pile up and occupy a lot of precious
@@ -297,31 +322,6 @@ you can make aliBuild delete the rest with a little trick.
by running `aliBuild build` for each development package.
3. Let aliBuild delete all the other builds by running `aliBuild clean`.
-## Use your local software installations
-
-You will not find the packages you have built immediately available on your shell.
-We provide a tool called `alienv` that configures your shell according to the packages you want to load.
-`alienv` is capable of switching between different versions of the same package without a hassle.
-
-Load the latest O2Physics version you have built.
-
-```bash
-alienv enter O2Physics/latest
-```
-
-The `alienv enter` command drops you to a new shell with the O2Physics environment.
-Unload the packages by simply exiting the environment with the `exit` command.
-
-```warning
-Dependencies are loaded automatically. Do not attempt to load O2 or ROOT as well! You will find them automatically in the environment. `alienv enter` is verbose and will inform you about the loaded packages.
-```
-
-```tip
-If you have built several Git branches of O2Physics, you can enter the environment of a given branch `[branch]` with `alienv enter O2Physics/latest-[branch]-o2`.
-
-You can list all your available packages with `alienv q`.
-```
-
## Building partially for development using ninja
```note
From 6021f4e426fe3b1000861b057284b65bef617efc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?V=C3=ADt=20Ku=C4=8Dera?=
<26327373+vkucera@users.noreply.github.com>
Date: Wed, 26 Nov 2025 18:58:22 +0100
Subject: [PATCH 4/9] Fix typo
---
docs/gettingstarted/installing.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/gettingstarted/installing.md b/docs/gettingstarted/installing.md
index 064987a5..995ac4c6 100644
--- a/docs/gettingstarted/installing.md
+++ b/docs/gettingstarted/installing.md
@@ -111,7 +111,7 @@ Xcode bundles the necessary tools to build software in the apple ecosystem inclu
* Download it from the [App Store](https://itunes.apple.com/gh/app/xcode/id497799835?mt=12) and install it.
* Open once installed. It will ask to install additional components. Approve the action.
-* Open a terminal (Applicaions>Utilities>Terminal) and install the command line tools using: `sudo xcode-select --install`
+* Open a terminal (Applications>Utilities>Terminal) and install the command line tools using: `sudo xcode-select --install`
* Approve the license conditions by: `sudo xcodebuild -license`
#### Get Homebrew
From 6a680a7bc4dbfe36a4a8d4be2ef2392eb5e49a8d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?V=C3=ADt=20Ku=C4=8Dera?=
<26327373+vkucera@users.noreply.github.com>
Date: Wed, 26 Nov 2025 19:18:00 +0100
Subject: [PATCH 5/9] Add note about optional O2 source
---
docs/gettingstarted/installing.md | 12 ++++++++----
1 file changed, 8 insertions(+), 4 deletions(-)
diff --git a/docs/gettingstarted/installing.md b/docs/gettingstarted/installing.md
index 995ac4c6..b843ffa0 100644
--- a/docs/gettingstarted/installing.md
+++ b/docs/gettingstarted/installing.md
@@ -204,18 +204,18 @@ See also [shell rc utilities](../tools/README.md#shell-rc-utilities).
We assume your work area is `~/alice`.
Start with a clean shell where you are not in an `alienv` environment.
-Create the directory and move to it (all the following commands need to be executed in this directory):
+Create the directory and move to it. (All the following commands need to be executed in this directory.):
```bash
mkdir -p ~/alice
cd ~/alice
```
-Download O2 and O2Physics:
+Download O2Physics (and optionally O2):
```bash
-aliBuild init O2@dev
aliBuild init O2Physics@master
+aliBuild init O2@dev # optional
```
If you perform `ls` under your work directory, you will see the packages you have downloaded via
@@ -223,6 +223,10 @@ If you perform `ls` under your work directory, you will see the packages you hav
The `alidist` directory contains software recipes, telling aliBuild how the software is built.
+```note
+You only need the O2 source code if you need to modify it. Otherwise aliBuild will install the O2 version defined in `alidist` as a dependency of O2Physics.
+```
+
```warning
Your `alidist` directory and your software source code are Git repositories **managed by you**. You need to keep them up to date manually.
```
@@ -301,7 +305,7 @@ dependency packages and downloaded `.tar.gz` archives.
In general, it's good practice to run `aliBuild clean` always after `aliBuild build`.
This might not be enough, as aliBuild will not delete any build directory pointed to by a symlink
-that has "latest" in its name, even when that build is not needed by any other package anymore.
+that has "latest" in its name, even when that build is not needed by any other package any more.
Manual intervention is therefore sometimes needed.
### Deep cleanup
From 0a8d56cf08cd5565097b0d5345154f9f77ebf378 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?V=C3=ADt=20Ku=C4=8Dera?=
<26327373+vkucera@users.noreply.github.com>
Date: Wed, 26 Nov 2025 19:20:05 +0100
Subject: [PATCH 6/9] Adjust basic build instructions
---
docs/gettingstarted/installing.md | 6 ++++--
1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/docs/gettingstarted/installing.md b/docs/gettingstarted/installing.md
index b843ffa0..a7a8093f 100644
--- a/docs/gettingstarted/installing.md
+++ b/docs/gettingstarted/installing.md
@@ -241,12 +241,16 @@ aliDoctor will warn you if some packages have to be built as they could not be f
## Build and rebuild
+Build (or rebuild) full O2Physics with:
+
```bash
aliBuild build O2Physics
```
To set the maximum number of parallel jobs `N`, provide the `-j N` option.
+See the [Troubleshooting](../troubleshooting/README.md) section for debugging tips if the build fails.
+
### Component-based build
To build only parts of O2Physics, provide a space-separated list of requested directories (followed by `/install`) using the `O2PHYSICS_COMPONENTS` variable, e.g.:
@@ -259,8 +263,6 @@ O2PHYSICS_COMPONENTS="Common/install Tools/install Tutorials/install" aliBuild b
On Linux, the components providing the required linked shared libraries also need to be included (e.g. `Tools/ML` for `O2Physics::MLCore`).
```
-See the [Troubleshooting](../troubleshooting/README.md) section for debugging tips if the build fails.
-
## Use your local software installations
You will not find the packages you have built immediately available on your shell.
From e09154119e4c69c390c784d450da97feee9e2df8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?V=C3=ADt=20Ku=C4=8Dera?=
<26327373+vkucera@users.noreply.github.com>
Date: Wed, 26 Nov 2025 19:35:01 +0100
Subject: [PATCH 7/9] Minor edits
---
docs/gettingstarted/installing.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/docs/gettingstarted/installing.md b/docs/gettingstarted/installing.md
index a7a8093f..10c22a00 100644
--- a/docs/gettingstarted/installing.md
+++ b/docs/gettingstarted/installing.md
@@ -37,7 +37,7 @@ Platforms supported on a best-effort basis:
* Follow the instructions for the Ubuntu version your Linux Mint version is based on.
* Specify the corresponding Ubuntu architecture when running `aliBuild` commands using the `-a` option (e.g. `-a ubuntu2404_x86-64` for Ubuntu 24.04). Use the `-a` option also with `alienv` commands.
-If your operating system is *not* in any list, it does not mean our software won't work on it; it will be just more difficult for you to get support for it.
+If your operating system is *not* listed, it does not mean our software won't work on it; it will be just more difficult for you to get support for it.
Only in case you cannot install aliBuild in the way described below, you can install aliBuild manually.
This procedure should only be used as a fallback, in case you cannot follow the instructions for your operating system linked above.
@@ -224,7 +224,7 @@ If you perform `ls` under your work directory, you will see the packages you hav
The `alidist` directory contains software recipes, telling aliBuild how the software is built.
```note
-You only need the O2 source code if you need to modify it. Otherwise aliBuild will install the O2 version defined in `alidist` as a dependency of O2Physics.
+You only need the O2 source code if you need to modify it. Otherwise, aliBuild will install the O2 version defined in `alidist` as a dependency of O2Physics.
```
```warning
From f3687b7d827e859940c05a86173972a058a4a8e2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?V=C3=ADt=20Ku=C4=8Dera?=
<26327373+vkucera@users.noreply.github.com>
Date: Wed, 26 Nov 2025 19:44:42 +0100
Subject: [PATCH 8/9] Mention development package
---
docs/gettingstarted/installing.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/gettingstarted/installing.md b/docs/gettingstarted/installing.md
index 10c22a00..918bd2fc 100644
--- a/docs/gettingstarted/installing.md
+++ b/docs/gettingstarted/installing.md
@@ -218,7 +218,7 @@ aliBuild init O2Physics@master
aliBuild init O2@dev # optional
```
-If you perform `ls` under your work directory, you will see the packages you have downloaded via
+If you perform `ls` under your work directory, you will see the development packages you have downloaded via
`aliBuild init`, plus the `alidist` directory.
The `alidist` directory contains software recipes, telling aliBuild how the software is built.
From fde0d6eb458b277ad53eec3f74de3a3b4a74288c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?V=C3=ADt=20Ku=C4=8Dera?=
<26327373+vkucera@users.noreply.github.com>
Date: Wed, 26 Nov 2025 20:22:24 +0100
Subject: [PATCH 9/9] Rephrase
---
docs/gettingstarted/installing.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/gettingstarted/installing.md b/docs/gettingstarted/installing.md
index 918bd2fc..ffc7b203 100644
--- a/docs/gettingstarted/installing.md
+++ b/docs/gettingstarted/installing.md
@@ -20,7 +20,7 @@ aliBuild
## Install aliBuild
-According to your operating system, please follow the corresponding instructions below.
+Please follow the corresponding instructions below, according to your operating system.
Primary supported platforms: