bug#13280: od 8.19: inappropriate formatting of the man pages
From:
Pádraig Brady
Subject:
bug#13280: od 8.19: inappropriate formatting of the man pages
Date:
Thu, 27 Dec 2012 11:42:15 +0000
User-agent:
Mozilla/5.0 (X11; Linux x86_64; rv:13.0) Gecko/20120615 Thunderbird/13.0.1
On 12/26/2012 07:43 AM, Akim Demaille wrote:
(Wow, I had never realized that applying --program-prefix=g on
od results in invoking god).
You might consider this a bug, or not. Sorry for the noise if
you don't.
"man od" (well, in my case, yet another interesting command to
type, with deep philosophical meaning) includes a section-like
(in bold) title for:
Traditional format specifications may be intermixed; they accumulate:
but it does not for:
TYPE is made up of one or more of these specifications:
(also the next paragraph, "RADIX is d for…" seems to belong
to the "TYPE" section, but it does not. So maybe another section-like
separation would be nice).
Yes the grouping of that info wasn't optimum.
I've adjusted things a bit in the attached patch,
and the result can be seen in the attached pdf generated with:
man -t man/od.1 | ps2pdf - > od.pdf
Note since people like examples, as part of this I've added
an EXAMPLES section, that shows how to output a hexdump with od.
thanks,
Pádraig.