[looping in groff@gnu list]

[was: [PATCH 3/6] doc/bash.1: Revise "BUG REPORTS" section.]

At 2025-10-06T11:32:09-0400, Chet Ramey wrote:
> On 10/4/25 9:58 AM, G. Branden Robinson wrote:
> 
> > +.IP \(bu
> > +either
> > +.RS 4n
> > +.IP (a) 4n
> > +if your site built
> > +.B bash
> > +from source,
> > +the name and version of the compiler used to build it,
> > +reported by
> > +.BR bash 's
> > +.QN configure
> > +script;
> > +or
> > +.IP (b)
> > +if your site uses a distributor's
> > +.B bash
> > +package,
> > +the version of that package
> > +(for example,
> > +.Q "dpkg \-i bash"
> > +or
> > +.Q "rpm \-qi bash"\c
> > +),
> > +.RE
> 
> This doesn't render the HTML correctly; tested on macOS Firefox and
> Chrome.
> 
> The (a) is correctly indented, but the (b) returns to the previous
> indent.  Changing the line to `.IP (b) 4n' doesn't fix it.

You're right.  Also there's a break after "(a)" that needn't be there.

For me, this reproduces with groff Git, 1.23.0, 1.22.4, and 1.22.3.

I'm guessing it's one of the many problems that led to grohtml(1)
documenting HTML support as being in "beta" status for 25 years or so.

I'll have a look, but my bet is that the problem lies in the internal
gadget called "MTSM", the "mini-troff state machine", a facility that is
only used when formatting HTML.  It's undocumented, my understanding of
it is really poor, and I am dubious of its wisdom from a design
perspective.  (Maybe my opinion will change if my first two gripes are
addressed.)

Regards,
Branden

Attachment: signature.asc
Description: PGP signature

Reply via email to