diff options
| author | Pádraig Brady <P@draigBrady.com> | 2013-03-22 15:33:57 +0000 |
|---|---|---|
| committer | Pádraig Brady <P@draigBrady.com> | 2013-03-22 16:18:45 +0000 |
| commit | a24e4a01cac38be198177acf5e704c70988ab1fb (patch) | |
| tree | 62cc67b1b7261e2d98fe57d078f4eaab0989e30e | |
| parent | 33242826650b8ed4ea5cfca646cb63bd0ff96d3e (diff) | |
| download | coreutils-a24e4a01cac38be198177acf5e704c70988ab1fb.tar.xz | |
doc: clarify the printable characters output by od
* src/od.c (usage): Mention any printable character is output,
Not just ASCII.
* doc/coreutils.texi (od invocation): Further clarify that only
single byte characters are output (due to the alignment requirement).
Also mention the fact that 3 digit octal sequences are output
for non printable characters without a corresponding C escape.
Reported in http://bugs.gnu.org/13947
| -rw-r--r-- | doc/coreutils.texi | 9 | ||||
| -rw-r--r-- | src/od.c | 4 |
2 files changed, 7 insertions, 6 deletions
diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 8f1df4525..dfa9b1c21 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -1908,14 +1908,15 @@ of each output line using each of the data types that you specified, in the order that you specified. Adding a trailing ``z'' to any type specification appends a display -of the ASCII character representation of the printable characters +of the single byte character representation of the printable characters to the output line generated by the type specification. @table @samp @item a named character, ignoring high-order bit @item c -ASCII character or backslash escape, +printable single byte character, C backslash escape +or a 3 digit octal sequence @item d signed decimal @item f @@ -2003,8 +2004,8 @@ Output as octal bytes. Equivalent to @samp{-t o1}. @item -c @opindex -c -Output as ASCII characters or backslash escapes. Equivalent to -@samp{-t c}. +Output as printable single byte characters, C backslash escapes +or 3 digit octal sequences. Equivalent to @samp{-t c}. @item -d @opindex -d @@ -339,7 +339,7 @@ suffixes may be . for octal and b for multiply by 512.\n\ Traditional format specifications may be intermixed; they accumulate:\n\ -a same as -t a, select named characters, ignoring high-order bit\n\ -b same as -t o1, select octal bytes\n\ - -c same as -t c, select ASCII characters or backslash escapes\n\ + -c same as -t c, select printable characters or backslash escapes\n\ -d same as -t u2, select unsigned decimal 2-byte units\n\ "), stdout); fputs (_("\ @@ -355,7 +355,7 @@ Traditional format specifications may be intermixed; they accumulate:\n\ \n\ TYPE is made up of one or more of these specifications:\n\ a named character, ignoring high-order bit\n\ - c ASCII character or backslash escape\n\ + c printable character or backslash escape\n\ "), stdout); fputs (_("\ d[SIZE] signed decimal, SIZE bytes per integer\n\ |