Re: I just pushed ntsstats and ntskestats

2023-09-26 Thread Hal Murray via devel


> After glancing at the tops and bottoms fo some of the HTML docs, I think I
> have some issues to correct.

I think the last line of the man pages used to have the version number.  I'm 
not seeing that now.

Is that because I'm doing something special to get the date in the version 
string ( --build-desc=xxx to waf) or did that fall throug the cracks somehow?  
(Or was it my imagination?)



-- 
These are my opinions.  I hate spam.



___
devel mailing list
devel@ntpsec.org
https://lists.ntpsec.org/mailman/listinfo/devel


Re: I just pushed ntsstats and ntskestats

2023-09-26 Thread James Browning via devel
> On 09/24/2023 6:09 PM PDT Hal Murray via devel  wrote:
> 
>  
> There was a request for ntpviz to show NTS traffic.  We now have the log 
> files 
> to make that possible.

That's good, I had some ntpviz glue that works with a different way
of doing that. I'll check if I can graft it to work with yours.

> Please look at the indentation around the info for the *stats options in both 
> the man page for ntp.conf and the html pages for ntp_conf and monopt.

I think the entire section need to be reformatted, but I'm not sure
how yet.

> The web pages have a box around the sample lines for the log file.  That's 
> missing from the man pages.

Ah, I misread that earlier; you'd probably have to stick the samples
in a table for that to show in man.

After glancing at the tops and bottoms fo some of the HTML docs, I
think I have some issues to correct. As previously mentioned ntp_conf 
has a Mills reference that might go away.

The horizontal rules at the bottom of decode, driver_howto,
driver_trimble and kernpps are not consistent with the rest of the
HTML docs. The driver_* pages seem to be inconsistently formatted.

rate seems to have a duplicated footnote. dirver_howto and rollover
are the only docs with images at the end, and sitmap has seemingly
inconsistent 'links to top' and many missing links.
___
devel mailing list
devel@ntpsec.org
https://lists.ntpsec.org/mailman/listinfo/devel


Re: I just pushed ntsstats and ntskestats

2023-09-26 Thread Matthew Selsky via devel
On Mon, Sep 25, 2023 at 04:29:37PM -0700, Hal Murray via devel wrote:

> I have a slight preference for double, but it doesn't really matter.
> 
> I've seen some example with double on the left bar and single on the 
> top/bottom.
> That was probably the web version.

Hi Hal,

Do you have an example of something that renders the way that you want? I don't 
think the man page backend for asciidoc renders "delimited literal block" in a 
special way (see 
https://docs.asciidoctor.org/asciidoc/latest/verbatim/literal-blocks/ for the 
asciidoc description).
I'll see if I can find the man page backend code for asciidoc to see what it's 
doing.

> I thought I send in an Issue but can't find it...
> 
> Please check the bottom few lines on the man pages.  At least one of them 
> didn't get updated to use our trailer stuff and still has the Mills version.

Which man page shows this issue?


Cheers,
-Matt
___
devel mailing list
devel@ntpsec.org
https://lists.ntpsec.org/mailman/listinfo/devel