Re: Outdated warning

[G. Branden Robinson]

Hi Dave,

At 2023-08-03T23:35:02-0500, Dave Kemper wrote:
> On 4/22/23, G. Branden Robinson <g.branden.robinson@gmail.com> wrote:
> > At 2023-04-22T20:03:29+0200, Alejandro Colomar wrote:
> >> I found some spurious warning using 1.23.0-rc3 while linting some
> >> mdoc(7) page:
> > [...]
> >> mdoc warning: .Nx: Unknown NetBSD version '9.0' (#263)
> >> make: *** [share/mk/build/catman.mk:91: .tmp/man/man1/basenc.1.cat.set]
> >> Error 1
> >> make: *** Deleting file '.tmp/man/man1/basenc.1.cat.set'
> >>
> >> NetBSD 9.0 dates from 2020.
> >
> > We don't appear to have a volunteer who's willing to diligently keep
> > tmac/mdoc/doc-syms up to date.  (Except, annoyingly, a lot of the OS
> > strings are actually in tmac/mdoc/doc-common.)
> ...
> > But I have an idea for mitigating the problem.  It involves `soquiet`,
> > /etc, and distributors.  Hit me up again after 1.23.0 final drops.
> 
> The time has arrived, and we're all on the edges of our seats.

I'm sure.  :P

It's pretty straightforward, and I meant `msoquiet`.

Much as groff mm now loads a site-specific localization file,

https://git.savannah.gnu.org/cgit/groff.git/commit/?id=62a5f6b87ccc69ba5c6df32b087f58eaa131d55f

but doesn't complain if the file doesn't exist, we could have mdoc load
a site-local file as well.

diff --git a/tmac/doc.tmac b/tmac/doc.tmac
index 6267d2a08..411f6820e 100644
--- a/tmac/doc.tmac
+++ b/tmac/doc.tmac
@@ -268,6 +268,7 @@
 .
 .mso mdoc/doc-common
 .mso mdoc/doc-syms
+.msoquiet mdoc/doc-site
 .
 .
 .\" NS doc-macro-name global string

This file can be created by distributors to define whatever strings (or
"syms" in mdoc's insular lexicon) it needs.  It's cleaner than patching
doc-syms (or doc-common).

That's all.  Nothing fancy.  But too big a change for the master branch
in late April, when we were good and frozen.

Regards,
Branden

signature.asc
Description: PGP signature