diff --git a/man/timesyncd.conf.xml b/man/timesyncd.conf.xml
index da2b320a43..9554cbb378 100644
--- a/man/timesyncd.conf.xml
+++ b/man/timesyncd.conf.xml
@@ -47,54 +47,59 @@
NTP=
- A space-separated list of NTP server host
- names or IP addresses. During runtime this list is combined
- with any per-interface NTP servers acquired from
+ A space-separated list of NTP server host names or IP addresses. During runtime this
+ list is combined with any per-interface NTP servers acquired from
systemd-networkd.service8.
- systemd-timesyncd will contact all configured system or
- per-interface servers in turn until one is found that
- responds. When the empty string is assigned, the list of
- NTP servers is reset, and all assignments prior to this one
- will have no effect. This setting defaults to an empty
- list.
+ systemd-timesyncd will contact all configured system or per-interface servers in
+ turn, until one responds. When the empty string is assigned, the list of NTP servers is reset, and
+ all prior assignments will have no effect. This setting defaults to an empty list.
FallbackNTP=
- A space-separated list of NTP server host
- names or IP addresses to be used as the fallback NTP servers.
- Any per-interface NTP servers obtained from
+ A space-separated list of NTP server host names or IP addresses to be used as the
+ fallback NTP servers. Any per-interface NTP servers obtained from
systemd-networkd.service8
- take precedence over this setting, as do any servers set via
- NTP= above. This setting is hence only used
- if no other NTP server information is known. When the empty
- string is assigned, the list of NTP servers is reset,
- and all assignments prior to this one will have no effect.
- If this option is not given, a compiled-in list of NTP servers
- is used instead.
+ take precedence over this setting, as do any servers set via NTP= above. This
+ setting is hence only relevant if no other NTP server information is known. When the empty string is
+ assigned, the list of NTP servers is reset, and all prior assignments will have no effect. If this
+ option is not given, a compiled-in list of NTP servers is used.
RootDistanceMaxSec=
- Maximum acceptable root distance. Takes a time value (in seconds).
+ Maximum acceptable root distance, i.e. the maximum estimated time required for a
+ packet to travel to the server we are connected to from the server with the reference clock. If
+ the current server does not satisfy this limit, systemd-timesyncd will switch
+ to a different server.
+
+ Takes a time value. The default unit is seconds, but other units may be specified, see
+ systemd.time5.
Defaults to 5 seconds.
PollIntervalMinSec=
PollIntervalMaxSec=
- The minimum and maximum poll intervals for NTP messages.
- Each setting takes a time value (in seconds).
- PollIntervalMinSec= must not be smaller than 16 seconds.
- PollIntervalMaxSec= must be larger than PollIntervalMinSec=.
- PollIntervalMinSec= defaults to 32 seconds, and
- PollIntervalMaxSec= defaults to 2048 seconds.
+ The minimum and maximum poll intervals for NTP messages. Polling starts at the
+ minimum poll interval, and is adjusted within the specified limits in response to received packets.
+
+
+ Each setting takes a time value. The default unit is seconds, but other units may be specified,
+ see systemd.time5.
+ PollIntervalMinSec= defaults to 32 seconds and must not be smaller than
+ 16 seconds. PollIntervalMaxSec= defaults to 34 min 8 s (2048 seconds) and must be
+ larger than PollIntervalMinSec=.
ConnectionRetrySec=
- Specifies the delaying attempts to contact servers after network is online. Takes a time value (in seconds).
- Defaults to 30 seconds and must not be smaller than 1 seconds.
+ Specifies the minimum delay before subsequent attempts to contact a new NTP server
+ are made.
+
+ Takes a time value. The default unit is seconds, but other units may be specified, see
+ systemd.time5.
+ Defaults to 30 seconds and must not be smaller than 1 second.