aboutsummaryrefslogtreecommitdiff
path: root/clock/src
diff options
context:
space:
mode:
authorAndreas Grois <andi@grois.info>2021-11-29 00:18:44 +0100
committerAndreas Grois <andi@grois.info>2021-11-29 00:18:44 +0100
commit9549395257a22d4f03f5175602adf9980802a6cd (patch)
treeecd9e47063c2682cc394274e98a864edf8d1b8be /clock/src
parentdea589f85ca99fbba60a67c008499d9824a852b9 (diff)
Update pulse help string and add a few serde renames.
Diffstat (limited to 'clock/src')
-rw-r--r--clock/src/lib.rs2
1 files changed, 1 insertions, 1 deletions
diff --git a/clock/src/lib.rs b/clock/src/lib.rs
index 76f5ea7..adde06e 100644
--- a/clock/src/lib.rs
+++ b/clock/src/lib.rs
@@ -184,7 +184,7 @@ Seconds = <float>
The format is directly passed on to chrono and uses the strftime format. For available formatting options please see https://docs.rs/chrono/0.4.19/chrono/format/strftime/index.html or the strftime(3) man page.
For the RefreshRate you can choose between two options. Unless you have a very special use case, you'll likely want to use the UtcSynchronized option. As the name implies this mode aims to update in sync with your computer's system clock. For instance, if you set it to update every second, the text of the clock will update within a few milliseconds after a full second of the system clock passed.
-Since it synchronizes with UTC, and time zones are in general offset by multiples of 30 minutes, 30 minutes has been chosen as maximum time between updates. Following the "make invalid states unrepresentable" paradigm, the actual update rate is set as a fraction of 30 minutes. For example, if you want to update every second, the "PerThirtyMinutes" field needs to be set to 1800. If you need updates every minute, you'll want toset "PerThirtyMinutes" to 30. Beware that setting PerThirtyMinutes above 36000 is not supported.
+Since it synchronizes with UTC, and time zones are in general offset by multiples of 30 minutes, 30 minutes has been chosen as maximum time between updates. Following the "make invalid states unrepresentable" paradigm, the actual update rate is set as a fraction of 30 minutes. For example, if you want to update every second, the "PerThirtyMinutes" field needs to be set to 1800. If you need updates every minute, you'll want to set "PerThirtyMinutes" to 30. Beware that setting PerThirtyMinutes above 36000 is not supported.
The other option, "NotSynchronized" is for cases where 30/n minutes as an update rate is not desired. This simply waits approximately Seconds seconds between updates, but does not care about any synchronization to UTC. In other words, if you set this to 24 hours update rate, but launch the program at noon, that's when your date will update instead of midnight. Long story short, this mode only exists because it was easy to implement, and will probably never be useful to anybody."#
);