[svn-r16860] Description:

    First draft of "1.6.9 Changes" section.
Tested:  Firefox

1 files changed, 147 insertions, 2 deletions

diff --git a/doc/html/ADGuide/Changes.html b/doc/html/ADGuide/Changes.html
index a1ce167..2af63d3 100755
--- a/doc/html/ADGuide/Changes.html
+++ b/doc/html/ADGuide/Changes.html
@@ -57,8 +57,153 @@
 This document is intended to assist application developers who must keep 
 an application synchronized with the HDF5 library or related software.
 
+
+
+<a name="169">
+<h2>Release 1.6.9 (current release) versus Release 1.6.8,
+    May 2009</h2> 
+</a>
+
+<dir>
+
+This section lists API-level changes and changes in behavior 
+in the transition from HDF5 Release 1.6.8 to Release 1.6.9.
+
+
+    <h3>Function with Changed Syntax</h3>
+
+        To facilitate writing applications that work with 
+        both the HDF5 Release 1.6 series and the 1.8 series,
+        the macro <code>H5Z_class1_t</code> has been defined and
+        maps to <code>H5Z_class_t</code>.
+        <code>H5Zreqister</code> can now be called with either 
+        syntax:
+        <p>
+        <dl>
+          <dd><code>
+              <em>herr_t</em> H5Zregister ( 
+              <em>const H5Z_class_t *</em>cls
+              ) </code>
+          <dd><code>
+              <em>herr_t</em> H5Zregister ( 
+              <em>const H5Z_class1_t *</em>cls
+              ) </code>
+        </dl>
+
+<!--
+        The following function syntaxes have changed;
+        the affected return values and parameter are noted as 
+        <font color=red><u>underscored red text</u></font>.
+        <p>
+        <dl>
+        <dt><u>C function:</u>
+        <dt><a href="../RM_H5F.html#File-GetObjCount">
+          <code>H5Fget_obj_count</code></a>
+          <dd><code>
+              <font color=red><u>
+              ssize_t</u></font> H5Fget_obj_count(
+              <em>hid_t </em><code>file_id</code>,
+              <em>unsigned int</em> <code>types</code>
+              )
+              </code>
+        <p>
+        <dt><a href="../RM_H5F.html#File-GetObjIDs">
+            <code>H5Fget_obj_ids</code></a>
+          <dd><code>
+              <font color=red><u>
+              ssize_t</u></font> H5Fget_obj_ids(
+              <em>hid_t </em><code>file_id</code>,
+              <em>unsigned int</em> <code>types</code>,
+              <br>
+              &nbsp; &nbsp; &nbsp; &nbsp;
+              <font color=red><u>
+              <em>size_t</em> <code>max_objs</code></u></font>,
+              <em>hid_t *</em><code>obj_id_list</code>
+              )
+              </code>
+        </dl>
+        <p>
+-->
+
+</dir>
+<dir>
+
+    <h3>Tools with Changed Interface or Behavior</h3>
+    
+        <dl>    
+            <dt><a href="../Tools.html#Tools-Diff"><code>h5diff</code></a>
+                <dd>The default behavior of <code>h5diff</code> is now
+                    to detect and compare NaNs.  
+                    Use the <code>-N</code> or <code>--nan</code>
+                    option (below) to turn this behavior off and
+                    avoid the performance penalty that NaN detection 
+                    and comparison entalis.
+                    (NaN detection and comparison became the default in 
+                    in HDF5 Release 1.6.8.  
+                    <font color=red><b><i>Correct?</b></i></font>
+                    )
+                    <p>
+                <dd>This tool has two new options:
+                    <p>&nbsp;&nbsp;&nbsp;&nbsp;
+                    <code>-c</code>, <code>--compare</code>
+                    <code>&nbsp;&nbsp;&nbsp;&nbsp;</code>
+                    Lists objects that are not comparable.
+
+                    <p>&nbsp;&nbsp;&nbsp;&nbsp;
+                    <code>-N</code>, <code>--nan</code>
+                    <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code>
+                    Avoids NaNs detection.
+                    <p>
+
+            <dt><a href="../Tools.html#Tools-Dump"><code>h5dump</code></a>
+                <dd><code>h5dump</code> now correctly specifies an XML DTD 
+                    or a schema URL.
+                    <p>
+                <dd><code>h5dump</code> binary output now defaults to 
+                    <code>NATIVE</code>.
+                    <p>
+                <dd>The new <code>-b</code>, <code>--binary</code> option
+                    can be used to specify alternate binary formats.
+                    <p>
+
+            <dt><a href="../Tools.html#Tools-Repack"><code>h5repack</code></a>
+                <dd>When a user does not specify a chunk size,
+                    <code>h5repack</code> now defines the default chunk size
+                    to be the same same as the size of the hyperslab used
+                    to read the chunks.
+                    <p>
+        </dl>    
+
+</dir>
+
+<!--
+<dir>
+
+
+    <h3>Deprecated Functions</h3>
+
+        The following functions are deprecated as of this release: 
+        <pre>        <a href="../RM_H5P.html#Property-SetPreserve">H5Pset_preserve</a>
+        <a href="../RM_H5P.html#Property-GetPreserve">H5Pget_preserve</a> </pre>
+        <p>
+        The original role of these functions is now 
+        part of the core HDF5 Library functionality.
+        <p>
+
+
+    <h3>Changed File Installation</h3>
+        The file <code>libhdf5_fortran.settings</code> is no longer
+        installed with the HDF5 Library;
+        the original content of that file is now included in 
+        <code>libhdf5.settings</code>.
+    
+</dir>
+-->
+
+
+
 <a name="168">
-<h2>Release 1.6.8 (current release) versus Release 1.6.7,
+<h2>Release 1.6.8 versus Release 1.6.7,
     November 2008</h2> 
 </a>
 
@@ -3012,7 +3157,7 @@ Describes HDF5 Release 1.6.8, November 2008
 
 <!-- #EndLibraryItem --><!-- Created: Spring 1999 -->
 <!-- hhmts start -->
-Last modified: 13 November 2008 
+Last modified: 21 April 2009 
 <!-- hhmts end -->
 
 </body>