Re: [PATCH v2] man*/: ffix (migrate to `MR`)

[G. Branden Robinson]

[dropped Ingo, Jakub]

Hi Alex,

At 2023-08-12T17:35:32+0200, Alejandro Colomar wrote:
> On 2023-08-01 16:12, G. Branden Robinson wrote:
> > At 2023-08-01T15:35:10+0200, Alejandro Colomar wrote:
> >> Still I think this should be documented in our commit.  Would you
> >> please send a paragraph (and the position at which you'd place it)
> >> with which I can amend the commit?
> > 
> > Yes.  That was on oversight on my part; I was scrubbing out all font
> > changes (with "-P -cbou") because my concern was with unexpected
> > changes to adjustment and hyphenation.  The style change for man
> > page topics (from bold to italics) was a "known factor" (to me).
> 
> Would you mind sending an updated commit message?

I did, but you found a fresh problem, this time with part 1, so I guess
we'll be going to v4!  :-O  Also I'm going to make an attempt to drive
the part 1 change with sed as well.  Just to see if I can, and to see
what happens.

> Heh, I noticed some weirdness about it, but it happened to be after a
> -rCHECKSTYLE, so it seemed like it could be some improvements that you
> had applied upstream to CHECKSTYLE.  =3 definitely made sense to that
> register.

GNU troff(1) does not raise a diagnostic if a register assignment is
followed by garbage.  That's disappointing.

Filed.  https://savannah.gnu.org/bugs/?64559

> > Please double-check for that before pushing to kernel.org.
> 
> Please send one that I don't need to modify.  I don't like modifying
> other's stuff, in case I break it.  :)

Did v3 2/2 show up for you without quoted-printable damage?

> >>>> and against man-pages(7) recommendations.
> >>
> >> Well, we should update those to use MR.
> > 
> > And man(7) too, I guess.  What do you think?
> 
> I want to kill that page.  Please have a look at it, take anything
> good that it has for groff_man{,_style}(7), and ping me when I
> should sharpen the scythe.  ;)

Ok, will do.

If the page is withdrawn, I expect distributors will need to manage the
man.7 page using Debian's "alternatives" mechanism or similar; if
groff_man.7 is installed, man.7 should be a symlink to it.  If
mandoc_man.7 is installed, likewise.  If both are installed, the
distributor needs to select a default preference.

I expect you will want to emphasize this in the release announcement,
when the time comes.

This already needs to happen with soelim(1) and roff(7), but it doesn't,
exactly; Debian renames mandoc's versions of the former to msoelim(1)
and the latter to mandoc_roff(1).  Termux simply throws groff's versions
away and installs mandoc's versions as soelim(1) and roff(7).

I also use Termux.  Imagine my surprise when I upgraded to groff 1.23.0
on my tablet and brought up roff(7).  I was expecting to see myself in
the mirror, and what should greet me but the visage of Ingo Schwarze!

Unnerving, no?

Regards,
Branden

signature.asc
Description: PGP signature