summaryrefslogtreecommitdiffstats
path: root/doc/html/ADGuide/RELEASE.txt
blob: 5b8657fef807feba6f896f80ed168b1707dd4954 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163

 
                       HDF5 Release 1.4.1


INTRODUCTION

This document describes the differences between HDF5-1.4.0 and
HDF5-1.4.1, and contains information on the platforms tested and
known problems in HDF5-1.4.1. For more details check the HISTORY.txt
file in the HDF5 source.

The HDF5 documentation can be found on the NCSA ftp server
(ftp.ncsa.uiuc.edu) in the directory:

     /HDF/HDF5/docs/

For more information look at the HDF5 home page at:
   
    http://hdf.ncsa.uiuc.edu/HDF5/

If you have any questions or comments, please send them to:

    hdfhelp@ncsa.uiuc.edu


CONTENTS

- New Features
- Bug Fixes since HDF5-1.4.0
- Documentation
- Platforms Tested
- Supported Configuration Features
- Known Problems


New Features
============

   * XML output option for h5dump utility.
  
     A new option --xml to output data in XML format has been added. The
     XML output contains a complete description of the file, marked up in
     XML. 

     The XML conforms to the HDF5 Document Type Definition (DTD), which
     is available at:

       http://hdf.ncsa.uiuc.edu/DTDs/HDF5-File.dtd

     The XML output is suitable for use with other tools, including the
     Java Tools:

       http://hdf.ncsa.uiuc.edu/java-hdf5-html


Bug Fixes since HDF5-1.4.0 Release
==================================

   * h4toh5 utility: conversion of images is fixed

     Earlier releases of the h4toh5 utility produced images that did not
     correctly conform to the HDF5 Image and Palette Specification.

       http://hdf.ncsa.uiuc.edu/HDF5/doc/ImageSpec.html

     Several required HDF5 attributes are omitted, and the dataspace
     is reversed (i.e., the ht. and width of the image dataset is
     incorrectly described.)  For more information, please see:

       http://hdf.ncsa.uiuc.edu/HDF5/H5Image/ImageDetails.htm

   * Fixed bug with contiguous hyperslabs not being detected, causing
     slower I/O than necessary.
   * Fixed bug where non-aligned hyperslab I/O on chunked datasets was
     causing errors during I/O
   * The RCSID string in H5public.h was causing the C++ compiling problem
     because when it was included multiple times, C++ did not like
     multiple definitions of the same static variable. All occurance of
     RCSID definition are removed since we have not used it consistently
     before.


Documentation
=============

    PDF and Postscript versions of the following documents are available 
    for this release:
        Document                                 Filename
        --------                                 --------
        Introduction to HDF5                     H5-R141-Introduction.pdf
        HDF5 Reference Manual                    H5-R141-RefManual.pdf 
        C++ APIs to HDF5 documents               H5-R141-Cplusplus.pdf
        Fortran90 APIs to HDF5 documents         H5-R141-Fortran90.pdf

        PDF and Postscript files containing      H5-R141-DocSet.pdf
            all of the above                     H5-R141-DocSet.ps

    These files are not included in this distribution, but are available 
    via the Web or FTP at the following locations:
        http://hdf.ncsa.uiuc.edu/HDF5/doc/PSandPDF/
        ftp://ftp.ncsa.uiuc.edu/HDF/HDF5/docs/

    While these documents are labeled Release 1.4.1, they describe 
    Release 1.4.0 as well.  


Platforms Tested
================

Due to the nature of this release only C, C++ libraries and tools were tested.

    AIX 4.3.3.0 (IBM SP powerpc)  xlc 3.6.6
                                  mpcc_r 3.6.6
    Cray T3E sn6711 2.0.5.47      Cray Standard C Version 6.5.0.0
    Cray SV1 10.0.0.8             Cray Standard C Version 6.5.0.0
    FreeBSD 4.3                   gcc 2.95.2
    HP-UX B.10.20                 HP C  HP92453-01 A.10.32.30
    HP-UX B.11.00                 HP C  HP92453-01 A.11.01.20
    IRIX 6.5                      MIPSpro cc 7.30
    IRIX64 6.5 (64 & n32)         MIPSpro cc 7.3.1m
    Linux 2.2.18smp               gcc-2.95.2
                                  g++ 2.95.2
    OSF1 V4.0                     DEC-V5.2-040
                                  Digital Fortran 90 V4.1-270
    SunOS 5.6                     WorkShop Compilers 5.0 98/12/15 C 5.0 
     (Solaris 2.6)                

    SunOS 5.7                     WorkShop Compilers 5.0 98/12/15 C 5.0
     (Solaris 2.7)                Workshop Compilers 5.0 98/12/15 C++ 5.0
    TFLOPS r1.0.4 v4.0            mpich-1.2.1 with local changes
    Windows NT4.0, 2000 (NT5.0)   MSVC++ 6.0
    Windows 98                    MSVC++ 6.0


Supported Configuration Features Summary
========================================

    * See "Supported Configuration Features Summary" section for the HDF5
      1.4.0 release in the HISTORY.txt file.

Known Problems
==============

    * The h5dump tests may fail to match the expected output in some
      platforms (e.g. SP2 parallel, Windows) where the error messages
      directed to "stderr" do not appear in the "right order" with output
      from stdout.  This is not an error.

    * The --enable-static-exec configure flag fails to compile for HP-UX
      11.00 platforms.

    * The executable are always dynamic on IRIX64 6.5(64 and n32) and 
      IRIX 6.5 even if they are configured with --enable-static-exec.

    * The shared library failed compilation on IRIX 6.5.
    
    * After "make install" or "make install-doc" one may need to reload the source
      from the tar file before doing another build.

    * See "Known problems" section for the HDF5 1.4.0 release in the
      HISTORY.txt file.