summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPádraig Brady <P@draigBrady.com>2013-03-22 15:33:57 +0000
committerPádraig Brady <P@draigBrady.com>2013-03-22 16:18:45 +0000
commita24e4a01cac38be198177acf5e704c70988ab1fb (patch)
tree62cc67b1b7261e2d98fe57d078f4eaab0989e30e /doc
parent33242826650b8ed4ea5cfca646cb63bd0ff96d3e (diff)
downloadcoreutils-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
Diffstat (limited to 'doc')
-rw-r--r--doc/coreutils.texi9
1 files changed, 5 insertions, 4 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