ntpd daemon

[Isaac Dunham]

On Tue, Mar 03, 2015 at 03:58:12PM +0000, Laszlo Papp wrote:
> On Tue, Mar 3, 2015 at 3:54 PM, Denys Vlasenko <vda.linux at googlemail.com> wrote:
> > On Tue, Mar 3, 2015 at 2:56 PM, Laszlo Papp <lpapp at kde.org> wrote:
> >> On Mon, Mar 2, 2015 at 5:07 PM, Denys Vlasenko <vda.linux at googlemail.com> wrote:
> >>> On Mon, Mar 2, 2015 at 10:39 AM, Laszlo Papp <lpapp at kde.org> wrote:
> >>>> Either way, since I have spent a couple of hours before realizing it,
> >>>> I think it would be beneficial to briefly extend documentation. It may
> >>>> sound trivial for people familiar enough with "ntp", but for me it was
> >>>> not. Usually, in networking, servers and clients are different things,
> >>>> not rarely significantly. You can call me silly or any other way that
> >>>> you like, but it would have helped me to have a few more words about
> >>>> the usage of this option.
> >>>
> >>> Propose a change to ntpd --help
> >>
> >> Apparently you did that yourself:
> >>
> >> http://git.busybox.net/busybox/commit/?id=3aef814c0b08d9703280b4772060ce5016c683c4
> >>
> >> I think there are still at least two issues in the peer documentation:
> >>
> >>         -p PEER Obtain time from PEER (may be repeated)
> >>                 If -p is not given, read /etc/ntp.conf
> >>
> >> 1) It does not mention that it aborts if the peer is unavailable, e.g.
> >> unresolvable hostname.
> >> 2) It does not mention what the format of /etc/ntp.conf is. It may be
> >> obvious for you, but for me it is not. I assume it is some standard
> >> format, but what is the standard? Any reference to it, etc?
> >
> > It's "standard" ntpd compat. google "man ntp.conf"
> 
> I know, but that is not the point I am trying to make. Reading the
> help output without investigating about the code, it is unclear for
> the user what format the file has. It can be "standard", it can be
> busybox specific, etc.
> 
> Also, do not forget about the other point. That is also important and
> well-hidden.

How is this patch for clarifying the documentation?


-------------- next part --------------
A non-text attachment was scrubbed...
Name: ntpd.diff
Type: text/x-diff
Size: 831 bytes
Desc: not available
URL: <http://lists.busybox.net/pipermail/busybox/attachments/20150303/99feb7ea/attachment-0001.bin>