Add more rationale in the man page
authorSteve McIntyre <steve@einval.com>
Fri, 17 Oct 2014 15:37:55 +0000 (16:37 +0100)
committerSteve McIntyre <steve@einval.com>
Fri, 17 Oct 2014 15:37:55 +0000 (16:37 +0100)
debian/changelog
fake-hwclock.8

index ab4c50d..ed9aefd 100644 (file)
@@ -1,3 +1,9 @@
+fake-hwclock (0.9) UNRELEASED; urgency=medium
+
+  * Add more rationale in the man page.
+
+ -- Steve McIntyre <93sam@debian.org>  Wed, 01 Oct 2014 12:34:30 +0100
+
 fake-hwclock (0.8) unstable; urgency=medium
 
   * Add protection around save, don't go backwards unless forced.
index 4bafb50..6090c36 100644 (file)
@@ -14,6 +14,15 @@ the system is rebooted. Since lots of software assumes that time only moves
 forward this is a bad thing. NTP can (and should where practical) be used to
 sync with an external timeserver but it is not available early in the boot
 process and may be unavailable for other reasons.
+
+The design expectation of \fBfake-hwclock\fP is that it will be run
+very late at shutdown and very early at boot. This will ensure that
+fsck has a vaguely sensible idea of system time at boot and won't
+complain that the last-modified time in the filesystem is not hugely
+in the past or future. Some users may not worry about this too use
+case, in which case it is possible to modify the init system
+configuration to move things earlier/later as appropriate.
+
 .SH DESCRIPTION
 \fBfake-hwclock\fP sets and queries a fake "hardware clock" which stores the
 time in a file. This program may be run by the system administrator