doc quirks

[Eric S. Raymond]

Hal Murray <hmurray at megapathdsl.net>:
> 
> > Dave Mills designed it that way.  It wouldn't be difficult to change, but
> > I'm trying to avoid moving away from his look and feel before we have him
> > recruited/co-opted. 
> 
> Here is a sample ntpq page from NTP Classic, starting after the cartoon:
> 
> More Help
> [HR]
> Synopsis
> ntpq [-46dinp] [-c command] [host] [...]
> Description
> 
> The ntpq utility program is used to ...
> 
> Here is the top of our ntpq.html:
> 
> More Help
> [HR]
> Program Manual Pages
> [HR]
>     ntpd - Network Time Protocol (NTP) daemon
>     ntpdig - Simple Network Time Protocol (SNTP) client
>     ntpq - standard NTP query program
>     ntpfrob - frob the local clock hardware
>     ntpkeygen - generate public and private keys
>     ntpleapfetch(8) fetch and manage leap-offset file
>     ntpdsim(8) - Network Time Protocol (NTP) simulator
>     ntptime - read and set kernel time variables
>     ntptrace - trace a chain of NTP servers back to the primary source
>     Site Map
> (There are links behind most of those text strings.)
> [HR]
> Synopsis
> [HR]
> ntpq [-46dinpw] [-c command] [host] [...]
> 
> Description
> [HR]
> The ntpq utility program is used to ...
> 
> -------------
> 
> docs/ntpq.txt includes:
>   include::includes/manual.txt[]
> It's also included by ntpdsim, ntpkeygen, ntpleapfetch, and sitemap
> 
> That's the source of the extra clump of links.  It looks reasonable if I 
> delete that line, but I'm not sure that's the appropriate fix.

It will be, once we don't have adhering to Dave Mills's present ideas about
correct page design as a major goal of the Web UI. That is most
likely to occur after we make the pilgrimage to Delaware and I get
a chance to have a nice long chat with him about it.
-- 
		<a href="http://www.catb.org/~esr/">Eric S. Raymond</a>