On Wed, Feb 19, 2025 at 12:54:30AM +0000, Bjarni Ingi Gislason wrote:
> For man pages I use "no adjustment" (".na"; same output as for ".ad l"),
> see for example a snippet from:
>
> .\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35)
> .
> [...]
> .IX Title "A2PING 1"
> .TH A2PING 1 "2019-11-28" "a2ping" "Peter Szabo"
> .\" For nroff, turn off justification. Always turn off hyphenation; it
> makes
> .\" way too many mistakes in technical documents.
> .if n .ad l
> .nh
> .
> -.-
>
> Adjustment (and hyphenation) is a waste of processor's time and should
> not be default practice.
>
> By adding ".na" before the ".TS" line and ".ad" after the ".TE" line,
> all the repeated ".ad l" in table-lines are not needed.
That's not in the rather long diff submitted here (which has the effect
of splitting all of the corresponding hanging indents into two lines).
I can see how to alter MKterminfo.sh to do this (probably by rewriting its
sed script into awk).
For the rest:
a) the \(en appears to be a groff extension, which I won't apply.
b) the endless pedantry about kibi/kilo, etc. goes nowhere, serves only to
annoy the reader.
c) there's one (actual) long line which I leave because working around in
scripting is a waste of time. My check-manpage script reports lines
which would render "too wide". The other "long" lines which are mentioned
actually _format_ to less than 80 columns. mandoc whines about those,
but a lot of its "STYLE" warnings need some filtering anyway.
d) there are some off-target comments about sentence endings related to
random insertion of \& which might be revisited (but those, like the
cosmetic issue with long lines need a script(*) to detect and warn about
them.
(*) I recall asking more than once to see the checking script which you are
using, but have not seen it.
--
Thomas E. Dickey <dic...@invisible-island.net>
https://invisible-island.net
signature.asc
Description: PGP signature
