Formatting updates enabling generation of the PDF version
of the HDF5 Reference Manual for Release 1.6.3.
Platforms tested:
HTMLdoc, Adobe Acrobat Reader, Mozilla
updated documentation and usage message
Description:
updated the html documentation for the new h5diff modes
added a section for h5repack
Solution:
Platforms tested:
linux
Misc. update:
Purpose:
Improved tools index
Better categorization and consistency in style
Clarified notes regarding tools that are not included with the
library distribution
Added notes in the h4toh5 and h5toh4 descriptions that these tools
are now distributed separately (with pointer to distribution site)
A few dozen copy edits
Platforms tested:
IE 5
Purpose:
Modifications to enable automatically generating a PDF version of the
HDF5 Reference Manual with HTMLdoc.
Description:
The HTML coding has been revised to provide necessary formatting and
control guidance for HTMLdoc. In the process, of course, the need for
an occasional formatting or copy-edit correction was discovered.
Platforms tested:
HTMLdoc, IE 5, Safari
Purpose:
Changed "HDF5 User's Guide" links (in navigation bars, primarily)
to point to new user's guide, which will reside for a while yet on
the HDF server.
The old user's guide will still go out with the distribution under
the label "HDF5 User's Guide, Release 1.4.5."
Platforms tested:
IE 5
Purpose:
To segregate HDF4/HDF5 conversion tools and add link to H4toH5 Library
Description:
Restructured indexing at the top of the page into these sections:
User utilities
Configuration and library management utilities
Java-based tools
HDF5/HDF4 conversion tools
Added link to http://hdf.ncsa.uiuc.edu/h4toh5/
Platforms tested:
IE 5
Purpose:
Add short copyright notice.
Update release tag line.
Description:
Added short copyright notice as comment in source files;
does not display in browser.
Updated release tag line in footers to read as follows:
Describes HDF5 Release 1.6.0, July 2003
Platforms tested:
IE 5
Purpose:
Add new tools:
h5diff
h5perf
h5redeploy
h5c++
Corrections to h5import
Description:
h5diff, h5perf, h5redeploy, h5c++ -- Added these tools.
h5import -- Corrected the description of the naming convention for
output datasets. Other edits based on review comments.
Copy edits and source code formatting.
Platforms tested:
IE 5, Safari
Purpose:
Correction of a misleading comment.
Description:
h5cc & h5fc
Corrected the same spot in each "Description" where the text,
literally interpreted, implied that HDF5 could be used as a compiler.
Platforms tested:
IE 5, Safari
Purpose:
New feature -- h5fc
Description:
Added h5fc entry.
Took the opportunity to make some relatively minor copy edits and
grammatical corrections in h5cc entry.
Platforms tested:
Safari, IE 5
Purpose:
DreamWeaver (DW) adaptation of the HDF5 doc set, introducing the use of
stylesheets and DW libraries.
Stylesheets -- for consistent format management.
DW libraries -- for managing common elements across documents.
Platforms tested:
IE 5 and 6
Netscape
Bringing 'last minute' release branch edits into development branch.
Description:
index.html
Added index-level link to "HDF5 Tools."
Tools.html
Added link to "HDF5 Java tools."
Added h52gif and gif2h5.
Platforms tested:
IE 5
Purpose:
Bugfix (Tools.html) and spelling correction (Files.html)
Description:
Tools.html
h5dump -- Removed "interactively" from first description sentence.
(As a user has pointed out, an application that runs and exits
without opportunity for user input is not "interactive".)
Fixes bug #474.
Rewrote introductory sentence to "Tools" page.
Files.html -- Spelling correction
Platforms tested:
IE 5
Purpose:
Repair damaged HTML coding (caused by the Netscape editor)
and restore additions since that damage occured.
Add h5dump subsetting material.
Description:
Reverted to earlier version to restore HTML coding.
Re-entered h5dump XML material and explanatory comment re h5dump
flag parameters.
Added h5dump subsetting material.
Other editing and formatting within h5dump description.
Platforms tested:
IE 5
Purpose:
Linking the new "Predefined Dataypes" document into the RM.
Description:
Added PredefDTypes.html link into all RM files.
Platforms tested:
IE 5
Bug fix
Description:
The documentation on how to dump attribute data was not complete
enough. Some people got confused on the commandline syntax (you
have to specify the "path" from the root group to the attribute
to dump it). I put some examples in to show how to correctly dump
attributes.
Platforms tested:
Viewed with Netscrape.
H5Dopen: Corrected description of 'loc_id' parameter.
RM_H5T.html
H5Tset_strpad:
Corrected string padding values list (replaced 'H5T_STR_NULL &
H5T_STR_SPACE' with ''H5T_STR_NULLTERM, 'H5T_STR_NULLPAD, &
H5T_STR_SPACEPAD'.
Added notes re conversion from shorter to longer strings and
from longer to shorter strings.
Other minor edits and formatting.
H5Tget_class
Corrected H5T_ENUM and H5T_REFERENCE entries in class
identifiers table (they were reversed).
Tools.html
h5dump: Added note that '-bb' option is not yet implemented.
Changed 'boot block' to 'super block'.
DatatypesEnum.html
EnumMap.gif
Added enumeration datatypes -- First pass, only minimal editing.
Intro paragraph in Datatypes.html; details in DatatypesEnum.html.
EnumMap.gif is a figure for DatatypesEnum.html.
Tools.html
Added new h5toh4 supported object and data type.
H5.intro.html
Corrected transposed "start coordinates" in Example 1.