From 718422591a603223ff64f7d056d4b2f986109530 Mon Sep 17 00:00:00 2001
From: xengineering <me@xengineering.eu>
Date: Tue, 30 Jan 2024 20:26:00 +0100
Subject: doc: Move 'setup-alpine' to configuration section

This was never part of an installation but instead of a configuration
step.
---
 doc/documentation.tex | 33 ++++++++++++++++++++-------------
 1 file changed, 20 insertions(+), 13 deletions(-)

(limited to 'doc/documentation.tex')

diff --git a/doc/documentation.tex b/doc/documentation.tex
index d45de73..b4aeb78 100644
--- a/doc/documentation.tex
+++ b/doc/documentation.tex
@@ -191,29 +191,36 @@ umount /dev/<name>1
 sync
 \end{verbatim}
 
-Afterwards the SD card can be inserted into the Raspberry Pi. To do initial
-configuration it should be connected to a screen via HDMI. Also a keyboard has
-to be connected via USB. A mouse is not required. Finally the Pi should be
-powered up by connecting a USB power supply to the corresponding USB power
-input of the Raspberry Pi. Text from the boot process should be displayed on
-the screen.
+Afterwards the SD card can be ejected. The installation is completed while the
+system configuration is not covered.
+
+\section{Configure Alpine Linux for soundbox}
+
+An Alpine Linux installation can be configured as a soundbox host with the
+steps explained in the given section.
+
+For this configuration the SD card with an Alpine Linux installation has to be
+inserted into the Raspberry Pi. Furthermore a keyboard, monitor and USB power
+supply has to be connected. A mouse is not required. As soon as the power
+supply is attached text from the boot process should be shown on the monitor.
+
+\subsection{Basic Alpine Linux setup}
 
 After logging in with the username \texttt{root} and no password basic system
 configuration on Alpine Linux can be done interactively with
 \texttt{setup-alpine}. The Alpine Linux installation
 guide\footnote{\href{https://wiki.alpinelinux.org/wiki/Installation}{https://wiki.alpinelinux.org/wiki/Installation}}
-contains further details. When a diskless installation is chosen the
-configuration changes have to be made persistent with the \texttt{lbu} command.
-Otherwise they will be lost on the next reboot.
+contains further details. A diskless installation should be chosen for
+soundbox. This makes sure that the operating system is running from random
+access memory (RAM) and thus the system can be powered off by just removing the
+power supply.
 
 \begin{verbatim}
 setup-alpine
-lbu commit -d
 \end{verbatim}
 
-With this setup the Alpine Linux installation is completed.
-
-\section{Configure Alpine Linux for soundbox}
+These changes are only temporary until they are made persistent as described in
+section~\ref{lbu-persistence}.
 
 \subsection{Package installation}
 
-- 
cgit v1.2.3-70-g09d2

