[svn-r9577] Purpose:

Added an explanation of ASCII printing for h5dump.

1 files changed, 15 insertions, 1 deletions

diff --git a/doc/html/Tools.html b/doc/html/Tools.html
index 3be9513..9dbe31f 100644
--- a/doc/html/Tools.html
+++ b/doc/html/Tools.html
@@ -271,6 +271,20 @@ installed with HDF5.
         turn and in the order specified above until one driver succeeds
         in opening the file.
         </p>
+	<p>
+	One byte integer type data is displayed in decimal by default. When
+	displayed in ASCII, a non-printable code is displayed in 3 octal
+	digits preceeded by a back-slash unless there is a C language escape
+	sequence for it.  For example, CR and LF are printed as \r and \n.
+	Though the NUL code is represented as \0 in C, it is printed as
+	\000 to avoid ambiguity as illustrated in the following 1 byte
+	char data (since this is not a string, embedded NUL is possible).
+	<pre>
+	141 142 143 000 060 061 062 012
+	  a   b   c  \0   0   1   2  \n </pre>
+	h5dump prints them as "abc\000012\n".  But if h5dump prints NUL as \0,
+	the output is "abc\0012\n" which is ambiguous.
+        </p>
 
 <!-- NEW PAGE -->
 <dt><strong>XML Output:</strong>
@@ -2520,7 +2534,7 @@ of complete manual formatted as print volume)&nbsp;&nbsp;&nbsp;</small></i>
 Describes HDF5 Release 1.6.3, September 2004
 </address><!-- #EndLibraryItem --><SCRIPT LANGUAGE="JAVASCRIPT">
 <!--
-document.writeln("Last modified: 19 January 2004");
+document.writeln("Last modified: 24 November 2004");
 -->
 </SCRIPT>