Hi Jeremie,

Jeremie Courreges-Anglas wrote on Sun, Aug 26, 2018 at 03:15:48AM +0200:
> On Sat, Aug 25 2018, Ingo Schwarze <[email protected]> wrote:

[...]
>> So i think it is time for groff to switch over to install manual
>> page sources and have mandoc do the formatting on demand like for
>> (almost) every other package.
[...]

> "It's not torture if you do it to yourself."

Heh.  That happened to be the last ports hackathon before the
first one i attended.  Those Budapest events have always been
great.

[...]
>> There is one weird special case: the manual page documenting the
>> groff_www(7) macro set stupidly uses a few of its own macros for
>> formatting instead of just using macros of identical functionality
>> that are available in the man(7) language, or more precisely, in
>> the man-ext GNU extensions which everyone has to support anyway.
>> For now, i'm patching that up in a minimal way using .de and .als,
>> but i'm in the process of pushing a real fix upstream for the
>> groff-1.22.4 release.

> Hah, groff_www(7) was the first manpage I checked after testing your
> diff and before I read your mail.  FWIW the x11/ratpoison manpage was
> using .de before I rewrote it using mdoc(7).

Legions of manual pages are (ab)using .de, actually.  But ratpoison(1)
was indeed legendary, here is a recent minus diff from the mandoc TODO:

  -- .while
  -  found by jca@ in ratpoison(1)  Sun, 30 Jun 2013 12:01:09 +0200
  -  loc *  exist **  algo **  size **  imp **

I almost mentioned that, and your rewrite of it, in the commit
implementing .while, but finally decided not to because it would
have been a long explanation and my commit messages tend to be
excessive anyway.  (Btw. the difficulty estimate for that one was
way off, it was more like loc ** exist *** algo *** imp *.
The read.c - roff.c interaction is far from pretty.  The concept
used there is not as smart as it may have originally seemed; it
would all be so much much easier if roff.c would do the driving
rather than read.c.  Maybe one day...)

>> OK?

> Sure.

Thanks for checking.  I'll commit tomorrow unless somebody objects.

Yours,
  Ingo

Reply via email to