diff --git a/man/bootup.xml b/man/bootup.xml
index bba3bd2d7d..a0aafe5e79 100644
--- a/man/bootup.xml
+++ b/man/bootup.xml
@@ -47,9 +47,9 @@
necessary file systems and spawning all configured services.
On shutdown, the system manager stops all services, unmounts all non-busy file systems (detaching
- the storage technologies backing them), and then (optionally) jumps into the exitrd, which is backed by
- tmpfs, and unmounts/detaches the remaining file systems, including the real root. As a last step,
- the system is powered down.
+ the storage technologies backing them), and then (optionally) jumps into the exitrd. The exitrd is backed
+ by tmpfs and unmounts/detaches the remaining file systems, including the real root. As a last step, the
+ system is powered down.
Additional information about the system boot process may be
found in
diff --git a/man/os-release.xml b/man/os-release.xml
index 1ff112e057..6fb3e1bb1a 100644
--- a/man/os-release.xml
+++ b/man/os-release.xml
@@ -53,9 +53,9 @@
precedence over /usr/lib/os-release.
Applications should check for the former, and exclusively use its
data if it exists, and only fall back to
- /usr/lib/os-release if it is missing.
- Applications should not read data from both files at the same
- time. /usr/lib/os-release is the recommended
+ /usr/lib/os-release if that is missing.
+ Applications should not combine the data from both files.
+ /usr/lib/os-release is the recommended
place to store OS release information as part of vendor trees.
/etc/os-release should be a relative symlink
to /usr/lib/os-release, to provide