Date: Wed, 24 Aug 2016 15:21:50 +0200 From: Ollivier Robert <roberto@keltia.freenix.fr> To: Cy Schubert <Cy.Schubert@komquats.com> Cc: Benjamin Kaduk <bjk@freebsd.org>, Steve Kargl <sgk@troutmask.apl.washington.edu>, cy@freebsd.org, freebsd-doc@freebsd.org, delphij@freebsd.org Subject: Re: [PATCH] Fix markup in sntp.8 Message-ID: <20160824132150.ui75ty7qx6azsrnu@roberto-aw.eurocontrol.fr> In-Reply-To: <201608240341.u7O3ex9c004738@slippy.cwsent.com> References: <bjk@freebsd.org> <alpine.GSO.1.10.1608232129270.5272@multics.mit.edu> <201608240341.u7O3ex9c004738@slippy.cwsent.com>
next in thread | previous in thread | raw e-mail | index | archive | help
According to Cy Schubert on Tue, Aug 23, 2016 at 08:40:59PM -0700: > This gets a little complicated. Even though the man pages, like > sntp.man.in, are in the vendor branch and in contrib, they're actually > installed from usr.sbin/ntp/doc. It's not "right" and it should be. Using > the vendor supplied man pages is preferred and is on my list of things to > do. Having said that, as ntp ports (ntp and ntp-devel) maintainer, I've > seen a fair bit of fluctuation with ntp documentation where sometimes there > are man pages and at other times the man pages are replaced by html > documents. The issue with this is that it will create a bit of churn for > ntp in src/ because sometime man pages will be available and sometimes not. > The solution (I think) is to use vendor supplied man pages when available > and when not, either not use the man pages in usr.sbin/ntp/doc or svn cp > missing man pages back. To summarize, this needs to be thought out a little > more in regard to revering to previous man pages when those in the > distribution are deleted in lieu of html documentation (yet again). But I > digress, this is getting off topic. Historically speaking, there were never any manpages written by the NTP project, Dave Mills was having big eyesight issues and only ever wrote HTML pages. At some point a long time ago, some freebsd people did wrote manpage versions of some of the HTML pages but this was tedious work, never upstreamed because Dr. Mills was not interested. This effort was stopped a long time ago and we did make do with whatever the project released. Now that Dr. Mills has retired, I don't really know what NTP is now doing in that respect. Cheers, -- Ollivier ROBERT -=- FreeBSD: The Power to Serve! -=- roberto@keltia.net In memoriam to Ondine, our 2nd child: http://ondine.keltia.net/
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20160824132150.ui75ty7qx6azsrnu>