[Bug 104493] ntp manuals - align with upstream

From: <bugzilla-noreply_at_freebsd.org>
Date: Thu, 14 Nov 2024 13:23:16 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=104493

--- Comment #12 from WATANABE Kazuhiro <CQG00620@nifty.ne.jp> ---
(In reply to Alexander Ziaee from comment #11)
Yes, you should, please.

The "allan" variable has been reverted to a log2 variable since ntp-4.2.6.
The default value is 11.

ntp-4.2.8p18/ntpd/ntp_loopfilter.c:   
> #define CLOCK_ALLAN     11      /* Allan intercept (log2 s) */

The description about the variable in html/miscopt.html has been fixed since
ntp-4.2.8p8.

ntp-4.2.8p18/ChangeLog:   
> (4.2.8p8) 2016/06/02 Released by Harlan Stenn <stenn@ntp.org>
(snip)
> * [Bug 3054] miscopt.html documents the allan intercept in seconds. SWhite.

ntp-4.2.8p18/html/miscopt.html:   
> tinker [allan allan | dispersion dispersion | freq freq | huffpuff
>        huffpuff | panic panic | step step | stepout stepout]
(snip)
>      allan allan
>              Specifies the Allan intercept, which is a parameter of the
>              PLL/FLL clock discipline algorithm, in log2 seconds with
>              default 11 (2048 s).

So ntpd/ntp.conf.def should be fixed on upstream like this:

--- ntp-4.2.8p18/ntpd/ntp.conf.def.orig 2024-05-07 20:21:37.000000000 +0900
+++ ntp-4.2.8p18/ntpd/ntp.conf.def      2024-11-13 22:06:08.452433000 +0900
@@ -3135,7 +3135,7 @@
 The argument becomes the new value for the minimum Allan
 intercept, which is a parameter of the PLL/FLL clock discipline
 algorithm.
-The value in log2 seconds defaults to 7 (1024 s), which is also the lower
+The value in log2 seconds defaults to 11 (2048 s), which is also the lower
 limit.
 .It Cm dispersion Ar dispersion
 The argument becomes the new value for the dispersion increase rate,

-- 
You are receiving this mail because:
You are on the CC list for the bug.