[ntp:hackers] Re: magnitudes for ntpq variables
shoppa at trailing-edge.com
Fri Mar 31 23:38:04 UTC 2006
Harlan Stenn <stenn at ntp.isc.org> wrote:
> Tim said:
> > That said, I will VOLUNTEER to convert whatever HTML Dave produces
> > into man pages. In fact, I will contribute a tool that does this
> > function (and with 99% certainty, that tool will be in Perl and
> > will make use of a couple of CPAN HTML-parser modules.)
> Have you seen http://ntp.isc.org/bugs/show_bug.cgi?id=348 ?
Ah, somebody else already did it once! It looks as straightforward
as I'd expect. Indentation will be worked on.
> And I'd really appreciate any and all help with improving the docs that
> will be able to be produced once 4.2.1 has been released and GNU AutoGen
> is "brought in".
Sometime next week I think I'll have a first pass at tweaking the output.
If it's OK with you guys, I will limit my scope to taking in Dave's
HTML and putting out man pages. I may suggest changes to Makefiles
(and AutoGen will probably a key element there) but leave that to others.
Is there a discussion about AutoGen in the context of NTP releases that
I can catch up on? Are you thinking about using it for documentation
only, or for enforcing boilerplate in all the source modules?
> > Yes, such a tool could be stymied by really obtuse WYSIWYG HTML tools
> > but I trust Dave not to use those.
> Dave uses, as I recall, Adobe GoLive.
By far not the worst tool in terms of content parsability.
How will AutoGen relate to Dave's usage of GoLive? We're gonna leave
the HTML alone, or we're going to enforce boilerplate there with AutoGen?
More information about the hackers