bug-bash
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

grohtml misrenders some man(7) indented paragraphs


From: G. Branden Robinson
Subject: grohtml misrenders some man(7) indented paragraphs
Date: Mon, 6 Oct 2025 13:17:57 -0500

[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

[Prev in Thread] Current Thread [Next in Thread]