Re: [PATCH 2/4] man/{ncurses.3x,terminfo.head}: Drop version reporting from body text.

[G. Branden Robinson]

Hi Thomas,

At 2024-03-16T11:46:57-0400, Thomas Dickey wrote:
> On Fri, Mar 15, 2024 at 11:49:07AM -0500, G. Branden Robinson wrote:
> > It's not necessary now that (as of patch 20230617) ncurses man pages
> > put this information in the man page footer.  (The patch level is
> > omitted, but that too can be done.)
> 
> maybe not - in a perfect universe, users could identify versions of
> ncurses without the patch level, but in practice having that
> information helps with a lot of bug reports.

I'm sure it does.  I admit I wondered why you hadn't been putting it in
the `TH` calls of _all_ the man pages.

I can prepare a patch to do just that.  I'll also check to see if the
patch level is zero-length and leave it (and a leading dot) out if so.

Is 6.5 happening today, or maybe next week?  Are you gating the release
on this?

> Here's another problematic site - 
> https://linux.die.net/man/3/ncurses

Oh yes, the notorious "where man pages go to die" dot net.

> The only nice thing about that one is that it has the patch level :-)

It certainly lets you know how close to the bleeding edge they keep
their documentation...

By the same token, nothing we do to change the ncurses man pages will be
reflected there.

To his credit, Michael Kerrisk is much more diligent about this, even if
his converter (like all man2html converters) has problems.

https://man7.org/linux/man-pages/dir_by_project.html

The elision of _all_ of the groff page summaries does hurt my feelings.
😅

https://man7.org/linux/man-pages/dir_by_project.html#groff

Regards,
Branden

signature.asc
Description: PGP signature