From: Miroslav Lichvar <mlichvar@redhat.com>
Date: Mon, 17 Sep 2018 16:02:36 +0000 (+0200)
Subject: doc: improve description of minsamples directive
X-Git-Tag: 3.4~2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ea6e8d85a37e364ce45320325c87cc51ff46885c;p=thirdparty%2Fchrony.git

doc: improve description of minsamples directive
---

diff --git a/doc/chrony.conf.adoc b/doc/chrony.conf.adoc
index c4c7f689..4b1239f4 100644
--- a/doc/chrony.conf.adoc
+++ b/doc/chrony.conf.adoc
@@ -661,6 +661,13 @@ The *minsamples* directive sets the default minimum number of samples that
 *chronyd* should keep for each source. This setting can be overridden for
 individual sources in the <<server,*server*>> and <<refclock,*refclock*>>
 directives. The default value is 6. The useful range is 4 to 64.
++
+Forcing *chronyd* to keep more samples than it would normally keep reduces
+noise in the estimated frequency and offset, but slows down the response to
+changes in the frequency and offset of the clock. The offsets in the
+<<chronyc.adoc#tracking,*tracking*>> and
+<<chronyc.adoc#sourcestats,*sourcestats*>> reports (and the _tracking.log_ and
+_statistics.log_ files) may be smaller than the actual offsets.
 
 === Source selection