Bugzilla Bug 17405

When installing ntp 4.1.1b-r5, the only documentation that is installed 
in /usr/share/doc. No man pages are installed, although the text for 
such man pages are clearly available in HTML form in the /usr/share/doc 
directory.

Also, the ntp ebuild doesn't provide very good instructions on how to 
actually install it. Is it sufficient to configure /etc/ntp.conf or 
should the /etc/conf.d/ntpd file also be edited? It might also be 
helpful to add the rc-update add ntdp default command to the message.

See the following post for some comments from a frustrated user that
attempted at getting ntp installed and configured correctly:
http://forums.gentoo.org/viewtopic.php?p=240124#240124


Reproducible: Always
Steps to Reproduce:

lack of manpage is invalid ... see Bug 13612

as for lack of proper setup docs, the pkg_postinst() takes care of that ...
i've updated it here:
http://cvs.gentoo.org/cgi-bin/viewcvs.cgi/gentoo-x86/net-misc/ntp/ntp-4.1.1b-r5.ebuild.diff?r1=1.4&r2=1.5

if the user failed to see that msg, its a portage bug and there are bugs open to handle proper display of e* msg's ...

The new messages are better, thanks. If you add the following line too,
they would be even better:

"Finally, install with 'rc-update add ntpd default'."

Sorry about rehashing the man page issue.

i wont add the rc-update thing cause that can be applied to all packages that
install an init.d script ...

basically, people should read the docs on the Gentoo page ...
http://www.gentoo.org/doc/en/rc-scripts.xml

In theory I agree with you and for most packages this would be 
sufficient. It is just that some users (me included) did not 
originally understand that the ntp client is a daemon. 

We erroneously assumed that it was the ntpdate program that was 
the main event, and that it had to be crontab:ed. I though that 
the ntpd daemon was only needed to run a ntp server.

It wasn't until I actually read the docs that I understood that 
ntpd is both a client and a server in one daemon process. This 
is, in my opinion, rather odd for Unix daemons (but there are
probably good reasons for it).

So, to make my point, I still think that the rc-update should
be explicitly mentioned to make it painfully clear that this is
how ntp should be installed.

Sorry about being so verbose and persistent in this, I just 
wanted to make sure that you understood my point.

BTW. Checked up the ntp distribution site. Unbelievable that 
they do not distribute anything but HTML. Not even XML or SGML
doc sources what I could find. Really disappointing...