[PATCH] Fix markup in sntp.8

[Cy Schubert]

In message <20160824132150.ui75ty7qx6azsrnu at roberto-aw.eurocontrol.fr>, 
Ollivie
r Robert writes:
> 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 proje
> ct, 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 versio
> ns of some of the HTML pages but this was tedious work, never upstreamed beca
> use 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.

Interesting. The current NTP maintainer (Halan Stenn) seems to have taken 
the same approach, though sometimes including the code to build man pages 
and at other times only HTML doc. The pkg-plist for the port now has a mix 
of both. Some of the doc is HTML pages while other is man pages. And, it 
varies from release to release, which is why I'm somewhat reluctant to 
remove what we have in usr.sbin/ntp/doc, anticipating that it will change 
yet again at some future release.


-- 
Cheers,
Cy Schubert <Cy.Schubert at cschubert.com>
FreeBSD UNIX:  <cy at FreeBSD.org>   Web:  http://www.FreeBSD.org

	The need of the many outweighs the greed of the few.