Re: CVS commit: src/share/tmac

[Valery Ushakov <uwe%stderr.spb.ru@localhost>]

On Tue, Dec 24, 2019 at 16:13:56 -0000, Christos Zoulas wrote:

> In article <20191224113037.GL24362%pony.stderr.spb.ru@localhost>,
> Valery Ushakov  <uwe%stderr.spb.ru@localhost> wrote:
> >On Tue, Dec 24, 2019 at 08:46:49 +0700, Robert Elz wrote:
> >
> >>   |  |but since we run with -ww we
> >>   |  |get the warning about an unbalanced .el
> >> 
> >> That's a broken warning.
> >
> >Amen.  But let's be honest, in this day and age *very* few people can
> >can read troff, never mind write it (and I don't count myself as one),
> >so a warning from groff, however broken, will just confuse and upset
> >the users.  Since silencing this warning doesn't require that much of
> >an effort and doesn't mutilate the code that much, it's easier to just
> >shut it up.
> 
> We should file a bug report with groff though (and optionally supply a fix).

We are sticking to groff 1.19 that is still GPLv2+.  1.20 (released 11
years ago) switched to GPLv3+.  Current version is 1.22.4.  It would
make sense to switch to heirloom doctools (CDDL), but the general
sentiment seems to be that we don't want to have troff in base as it's
not cool, nobody knows how to use it and we don't use it for manpages
anymore anyway. :(

For the in-tree stuff we only use troff for isntall notes and for
(very very old and often out of date) documents in /usr/share/doc

-uwe