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 bug report
#13280: od 8.19: inappropriate formatting of the man pages
which was filed against the coreutils package, has been closed.
The explanation is attached below, along with your original report.
If you require more details, please reply to 13280 <at> debbugs.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)]
[Message part 3 (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)]
[Message part 6 (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!
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.