GNU bug report logs -
#13280
od 8.19: inappropriate formatting of the man pages
Previous Next
Reported by: Akim Demaille <akim <at> lrde.epita.fr>
Date: Wed, 26 Dec 2012 07:45:02 UTC
Severity: normal
Done: Pádraig Brady <P <at> draigBrady.com>
Bug is archived. No further changes may be made.
Full log
View this message in rfc822 format
[Message part 1 (text/plain, inline)]
Your message dated Thu, 27 Dec 2012 11:42:15 +0000
with message-id <50DC3417.1010209 <at> draigBrady.com>
and subject line Re: bug#13280: od 8.19: inappropriate formatting of the man pages
has caused the debbugs.gnu.org bug report #13280,
regarding od 8.19: inappropriate formatting of the man pages
to be marked as done.
(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)
--
13280: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=13280
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
(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).
in roff-tongue:
…
\fB\-\-version\fR
output version information and exit
.SS "Traditional format specifications may be intermixed; they accumulate:"
.TP
…
.TP
\fB\-x\fR
same as \fB\-t\fR x2, select hexadecimal 2\-byte units
.PP
If first and second call formats both apply, the second format is assumed
if the last operand begins with + or (if there are 2 operands) a digit.
An OFFSET operand means \fB\-j\fR OFFSET. LABEL is the pseudo\-address
at first byte printed, incremented when dump is progressing.
For OFFSET and LABEL, a 0x or 0X prefix indicates hexadecimal;
suffixes may be . for octal and b for multiply by 512.
.PP
TYPE is made up of one or more of these specifications:
.TP
a
named character, ignoring high\-order bit
.TP
c
Cheers!
[Message part 3 (message/rfc822, inline)]
[Message part 4 (text/plain, inline)]
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 (text/x-patch, attachment)]
[od.pdf (application/pdf, attachment)]
This bug report was last modified 12 years and 154 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.