diff --git a/man/systemd-sleep.conf.xml b/man/systemd-sleep.conf.xml
index f7e753990a..f984bcb33f 100644
--- a/man/systemd-sleep.conf.xml
+++ b/man/systemd-sleep.conf.xml
@@ -86,14 +86,20 @@
suspend-then-hibernate
- A low power state where the system is initially suspended (the state is stored in
- RAM). If the system supports low-battery alarms (ACPI _BTP), then the system will be woken up by
- the ACPI low-battery signal and hibernated (the state is then stored on disk). Also, if not
- interrupted within the timespan specified by HibernateDelaySec= or the estimated
- timespan until the system battery charge level goes down to 5%, then the system will be woken up by the
- RTC alarm and hibernated. The estimated timespan is calculated from the change of the battery
- capacity level after the time specified by SuspendEstimationSec= or when
- the system is woken up from the suspend.
+ A low power state where the system is initially suspended (the state is stored in RAM).
+ When the battery level is too low (less than 5%) or a certain timespan has passed, whichever
+ happens first, the system is automatically woken up and then hibernated. This establishes a balance
+ between speed and safety.
+
+ If the system has no battery, it would be hibernated after HibernateDelaySec=
+ has passed. If not set, then defaults to 2h.
+
+ If the system has battery and HibernateDelaySec= is not set, low-battery
+ alarms (ACPI _BTP) are tried first for detecting battery percentage and wake up the system for hibernation.
+ If not available, or HibernateDelaySec= is set, the system would regularly wake
+ up to check the time and detect the battery percentage/discharging rate. The rate is used to
+ schedule the next detection. If that is also not available, SuspendEstimationSec=
+ is used as last resort.
@@ -194,8 +200,8 @@
The amount of time the system spends in suspend mode before the system is
automatically put into hibernate mode. Only used by
systemd-suspend-then-hibernate.service8.
- If the system has a battery, then defaults to the estimated timespan until the system battery charge level goes down to 5%.
- If the system has no battery, then defaults to 2h.
+ Refer to suspend-then-hibernate for details on how this option interacts with
+ other options/system battery state.
@@ -206,10 +212,10 @@
The RTC alarm will wake the system after the specified timespan to measure the system battery
- capacity level and estimate battery discharging rate, which is used for estimating timespan until the system battery charge
- level goes down to 5%. Only used by
+ capacity level and estimate battery discharging rate. Only used by
systemd-suspend-then-hibernate.service8.
- Defaults to 1h.
+ Refer to suspend-then-hibernate for details on how this option interacts with
+ other options/system battery state.