At 2025-10-26T15:55:06-0500, G. Branden Robinson wrote: > A. Instead of turning of filling, turn off adjustment, and use the > `HP` macro to get a hanging indent if a synopsis item requires > more than one output line. ...
I neglected to mention that in July of last year, I undeprecated groff
man(7)'s `HP` macro for the forthcoming 1.24.0 release,[1] consequent to
discussion on the bug-ncurses list. Here's how it is now documented.
groff_man(7):
Paragraphing macros
These macros break the output line. An ordinary paragraph (P)
indents all output lines by the same amount. A hanging paragraph
(HP) is a cosmetic variant of P with a hanging indent.
...
.HP [indentation]
Set a paragraph with a hanging indentation. Text on output
lines after the first is indented by indentation, if
specified, and by the amount of the IN register otherwise.
Caution: A hanging indentation cannot be expressed naturally
in (pure) HTML, a hanging paragraph is not distinguishable
from an ordinary one if it formats on only one output line,
and non‐roff‐based man page interpreters may treat HP as an
ordinary paragraph anyway. Thus, information or
distinctions you mean to express with indentation may be
lost.
Regards,
Branden
[1]
commit d483834af930eeec2cc9f77441af5d581fe18c50
Author: G. Branden Robinson <[email protected]>
Date: Tue Jul 30 22:02:58 2024 -0500
tmac/an.tmac: Silence `HP` deprecation warning.
* tmac/an.tmac (HP): The `mS` extension register has changed its meaning
(commit f680c55d38, 13 June) such that it is no longer a reliable
indicator of whether the deprecation warning for this macro should be
suppressed, so stop suppressing a deprecation warning based on its
value. In fact, stop issuing the deprecation warning altogether.
(See <https://lists.gnu.org/archive/html/bug-ncurses/2024-04/
msg00027.html>.)
signature.asc
Description: PGP signature
