From a24e4a01cac38be198177acf5e704c70988ab1fb Mon Sep 17 00:00:00 2001 From: Pádraig Brady Date: Fri, 22 Mar 2013 15:33:57 +0000 Subject: 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 --- doc/coreutils.texi | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) (limited to 'doc') 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 -- cgit v1.2.3-54-g00ecf