bug#13280: od 8.19: inappropriate formatting of the man pages

[Pádraig Brady]

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.

od-help.diff
Description: Text Data

od.pdf
Description: Adobe PDF document