From owner-svn-src-head@freebsd.org Wed Aug 22 14:10:52 2018 Return-Path: Delivered-To: svn-src-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 7BF7B108A0F0 for ; Wed, 22 Aug 2018 14:10:52 +0000 (UTC) (envelope-from ian@freebsd.org) Received: from outbound1b.ore.mailhop.org (outbound1b.ore.mailhop.org [54.200.247.200]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 0B525761BF for ; Wed, 22 Aug 2018 14:10:51 +0000 (UTC) (envelope-from ian@freebsd.org) X-MHO-RoutePath: aGlwcGll X-MHO-User: 281687b8-a615-11e8-93fa-f3ebd9db2b94 X-Report-Abuse-To: https://support.duocircle.com/support/solutions/articles/5000540958-duocircle-standard-smtp-abuse-information X-Originating-IP: 67.177.211.60 X-Mail-Handler: DuoCircle Outbound SMTP Received: from ilsoft.org (unknown [67.177.211.60]) by outbound1.ore.mailhop.org (Halon) with ESMTPSA id 281687b8-a615-11e8-93fa-f3ebd9db2b94; Wed, 22 Aug 2018 14:10:43 +0000 (UTC) Received: from rev (rev [172.22.42.240]) by ilsoft.org (8.15.2/8.15.2) with ESMTP id w7MEAhX9093826; Wed, 22 Aug 2018 08:10:43 -0600 (MDT) (envelope-from ian@freebsd.org) Message-ID: <1534947042.27158.175.camel@freebsd.org> Subject: Re: svn commit: r338195 - head/share/man/man5 From: Ian Lepore To: Mateusz Piotrowski <0mp@FreeBSD.org>, src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Date: Wed, 22 Aug 2018 08:10:42 -0600 In-Reply-To: <201808221330.w7MDUnrC071262@repo.freebsd.org> References: <201808221330.w7MDUnrC071262@repo.freebsd.org> Content-Type: text/plain; charset="ISO-8859-1" X-Mailer: Evolution 3.18.5.1 FreeBSD GNOME Team Port Mime-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.27 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Aug 2018 14:10:52 -0000 On Wed, 2018-08-22 at 13:30 +0000, Mateusz Piotrowski wrote: > Author: 0mp (ports committer) > Date: Wed Aug 22 13:30:48 2018 > New Revision: 338195 > URL: https://svnweb.freebsd.org/changeset/base/338195 > > Log: >   Note that ntpd_sync_on_start is a preferred alternative to ntpdate_enable. >    >   A similar note is already present in the description of the >   ntpd_sync_on_start variable. >    >   This patch adds a note to the description of the ntpdate_enable variable. >   This way it would be easier to spot.  Otherwise a user might skip the part >   of the manual describing ntpd_sync_on_start if they stop reading after >   learning about ntpdate_enable. >    >   Reviewed by: bcr >   Approved by: mat (mentor) >   Differential Revision: https://reviews.freebsd.org/D16519 > > Modified: >   head/share/man/man5/rc.conf.5 > > Modified: head/share/man/man5/rc.conf.5 > ============================================================================== > --- head/share/man/man5/rc.conf.5 Wed Aug 22 13:25:41 2018 (r338194) > +++ head/share/man/man5/rc.conf.5 Wed Aug 22 13:30:48 2018 (r338195) > @@ -24,7 +24,7 @@ >  .\" >  .\" $FreeBSD$ >  .\" > -.Dd June 27, 2018 > +.Dd August 22, 2018 >  .Dt RC.CONF 5 >  .Os >  .Sh NAME > @@ -2562,6 +2562,14 @@ This command is intended to >  synchronize the system clock only >  .Em once >  from some standard reference. > +.Pp > +Note that the use of the > +.Va ntpd_sync_on_start > +variable is a preferred alternative to the > +.Xr ntpdate 8 > +utility as > +.Xr ntpdate 8 > +is to be retired from the NTP distribution. >  .It Va ntpdate_config >  .Pq Vt str >  Configuration file for > Fwiw, the ntp project has claimed that ntpdate is deprecated for at least 15 years that I know of, maybe longer. It doesn't look like it's ever actually going away. If the program itself went away, we would likely reimplement our rc.d/ntpdate to use sntp(1) instead. That said, ntpd_sync_on_start is the better option, and this doc update is a good one. There may be a few special situations where people want to update the time once at boot or periodically via cron because they can't run ntpd continuously, but ntpd_sync_on_start=yes is the right thing for most people. -- Ian