Subject: Re: ntp.conf man page
To: NetBSD Users Mailing List <netbsd-users@netbsd.org>
From: Douglas A. Tutty <dtutty@porchlight.ca>
List: netbsd-users
Date: 11/03/2007 22:01:22
On Sat, Nov 03, 2007 at 10:03:29AM -0500, Jeremy C. Reed wrote:
> On Sat, 3 Nov 2007, matthew sporleder wrote:
> 
> > Is there a reason the ntp.conf man page is missing from my netbsd
> > system and not available on man.netbsd.org?
> 
> We don't have an ntp.conf man page. The upstream doesn't provide an 
> ntp.conf man page.
> 
> The documentation is provided by the upstream as HTML. See 
> /usr/share/doc/html/ntp/
> /usr/share/doc/html/ntp/index.html
> 
> Any volunteers to create and maintain mandoc versions? (Maybe Debian or 
> other has them?)

Debian has a policy that everything has a man page.  In this case, the
man page directs you to the html docs.

My _personal_ feeling is that man pages are great for a little bit more
help than you get with app --help.  Anything more than that is best in
html.  Perhaps mutt or links or something should be in the same install
set as the man system.  If you're going to read docs on the box, you may
as well have all the tools to read the docs.

Doug.