URL:
<https://savannah.gnu.org/bugs/?65462>
Summary: [man] doesn't restore previous adjustment mode after
paragraph tag
Group: GNU roff
Submitter: gbranden
Submitted: Fri 15 Mar 2024 09:03:59 PM UTC
Category: Macro man
Severity: 4 - Important
Item Group: Rendering/Cosmetics
Status: In Progress
Privacy: Public
Assigned to: gbranden
Open/Closed: Open
Discussion Lock: Any
Planned Release: None
_______________________________________________________
Follow-up Comments:
-------------------------------------------------------
Date: Fri 15 Mar 2024 09:03:59 PM UTC By: G. Branden Robinson <gbranden>
Severity set to"Important" because it's a regression from _groff_ 1.22.4
behavior, and consequently the fix is one distributors might want to pick up.
(Fair warning: some internal macros have been renamed since 1.23.0.)
It is, however, a rendering/cosmetics issue.
Russ Allbery [https://lists.gnu.org/archive/html/groff/2024-03/msg00078.html
reported this issue to the _groff_ list], having heard about it from Perl
users who were less gruntled than usual.
Input:
$ cat EXPERIMENTS/gruntled.man
.TH foo 1 2024-03-15 "groff test suite"
.SH Name
foo \- frobnicate a bar
.SH Description
.\" The seemingly casual text below is crafted so that one can visually
.\" verify the presence or absence of adjustment.
.\" groff <= 1.23 defaults: BP=7n, LL=78n (BP didn't exist yet)
.\" groff > 1.23 defaults: BP=5n, LL=80n
Let us measure our degree of gruntlement.
.P
.ad l
First, align output to the left.
A dubious practice,
to be sure,
but the house style of Perl man pages to date.
.IR pod2man (1)
might soon come to support
.I groff
1.23's
.B AD
string.
.TP
Seventh Edition Unix
had the same preference in
.I nroff
mode in 1979,
and did not adjust the text to both margins on terminals
(using a
.B na
request),
though it did when using a typesetter.
.TP
SunOS
commented out the disablement of adjustment as early as its 2.0 release
(1982),
and appears to have retained that all the way through Solaris 10.
.P
The tagged paragraphs above should retain the alignment configured in
the previous untagged paragraph
(as should this one).
groff 1.22.4 output:
$ /usr/bin/nroff -man EXPERIMENTS/gruntled.man
foo(1) General Commands Manual
foo(1)
Name
foo - frobnicate a bar
Description
Let us measure our degree of gruntlement.
First, align output to the left. A dubious practice, to be sure, but
the house style of Perl man pages to date. pod2man(1) might soon come
to support groff 1.23's AD string.
Seventh Edition Unix
had the same preference in nroff mode in 1979, and did not
ad‐
just the text to both margins on terminals (using a na
request),
though it did when using a typesetter.
SunOS commented out the disablement of adjustment as early as its 2.0
release (1982), and appears to have retained that all the way
through Solaris 10.
The tagged paragraphs above should retain the alignment configured in
the previous untagged paragraph (as should this one).
groff test suite 2024‐03‐15
foo(1)
groff 1.23.0 output:
$ ~/groff-stable/bin/nroff -man EXPERIMENTS/gruntled.man
foo(1) General Commands Manual
foo(1)
Name
foo - frobnicate a bar
Description
Let us measure our degree of gruntlement.
First, align output to the left. A dubious practice, to be sure, but
the house style of Perl man pages to date. pod2man(1) might soon come
to support groff 1.23’s AD string.
Seventh Edition Unix
had the same preference in nroff mode in 1979, and did not
ad‐
just the text to both margins on terminals (using a na
request),
though it did when using a typesetter.
SunOS commented out the disablement of adjustment as early as its
2.0
release (1982), and appears to have retained that all the
way
through Solaris 10.
The tagged paragraphs above should retain the alignment configured
in
the previous untagged paragraph (as should this one).
groff test suite 2024‐03‐15
foo(1)
_______________________________________________________
Reply to this item at:
<https://savannah.gnu.org/bugs/?65462>
_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/
