[SCM] hdf5 branch, master, updated. upstream/1.8.4-patch1-49-gccd04af

Mon Aug 8 15:32:44 UTC 2011

The following commit has been merged in the master branch:
commit 790cff3c1eac40b28dc7d7595514f04e18b5be18
Author: Sylvestre Ledru <sylvestre.ledru at scilab.org>
Date:   Mon Aug 8 17:31:52 2011 +0200

    Add missing manpages + fix some issues

diff --git a/debian/man/h5copy.1 b/debian/man/h5copy.1
new file mode 100644
index 0000000..42884a2
--- /dev/null
+++ b/debian/man/h5copy.1
@@ -0,0 +1,92 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.4.
+.TH H5COPY: "1" "August 2011" "h5copy: Version 1.8.7" "User Commands"
+.SH NAME
+h5copy: \- Copies HDF5 objects from a file to a new file
+.SH DESCRIPTION
+usage: h5copy [OPTIONS] [OBJECTS...]
+.IP
+OBJECTS
+.TP
+\fB\-i\fR, \fB\-\-input\fR
+input file name
+.TP
+\fB\-o\fR, \fB\-\-output\fR
+output file name
+.TP
+\fB\-s\fR, \fB\-\-source\fR
+source object name
+.TP
+\fB\-d\fR, \fB\-\-destination\fR
+destination object name
+.IP
+OPTIONS
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print a usage message and exit
+.TP
+\fB\-p\fR, \fB\-\-parents\fR
+No error if existing, make parent groups as needed
+.TP
+\fB\-v\fR, \fB\-\-verbose\fR
+Print information about OBJECTS and OPTIONS
+.TP
+\fB\-V\fR, \fB\-\-version\fR
+Print version number and exit
+.TP
+\fB\-f\fR, \fB\-\-flag\fR
+Flag type
+.IP
+Flag type is one of the following strings:
+.TP
+shallow
+Copy only immediate members for groups
+.TP
+soft
+Expand soft links into new objects
+.TP
+ext
+Expand external links into new objects
+.TP
+ref
+Copy references and any referenced objects, i.e., objects
+that the references point to.
+.IP
+Referenced objects are copied in addition to the objects
+.IP
+specified on the command line and reference datasets are
+populated with correct reference values. Copies of referenced
+datasets outside the copy range specified on the command line
+will normally have a different name from the original.
+.IP
+(Default:Without this option, reference value(s) in any
+.IP
+reference datasets are set to NULL and referenced objects are
+not copied unless they are otherwise within the copy range
+specified on the command line.)
+.TP
+noattr
+Copy object without copying attributes
+.TP
+allflags
+Switches all flags from the default to the non\-default setting
+.IP
+These flag types correspond to the following API symbols
+.IP
+H5O_COPY_SHALLOW_HIERARCHY_FLAG
+H5O_COPY_EXPAND_SOFT_LINK_FLAG
+H5O_COPY_EXPAND_EXT_LINK_FLAG
+H5O_COPY_EXPAND_REFERENCE_FLAG
+H5O_COPY_WITHOUT_ATTR_FLAG
+H5O_COPY_ALL
+.SH "SEE ALSO"
+The full documentation for
+.B h5copy:
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B h5copy:
+programs are properly installed at your site, the command
+.IP
+.B info h5copy:
+.PP
+should give you access to the complete manual.
diff --git a/debian/man/h5diff.1 b/debian/man/h5diff.1
index be80591..66fbca8 100644
--- a/debian/man/h5diff.1
+++ b/debian/man/h5diff.1
@@ -1,6 +1,6 @@
 .TH "h5diff" 1
 .SH NAME
-h5diff (Beta version) \- Compares two HDF5 files and reports the differences.
+h5diff \- Compares two HDF5 files and reports the differences.
 .SH SYNOPSIS
 h5diff file1 file2 [OPTIONS] [object1 [object2 ] ] 
 .SH DESCRIPTION
diff --git a/debian/man/h5fc.1 b/debian/man/h5fc.1
new file mode 100644
index 0000000..da0b95c
--- /dev/null
+++ b/debian/man/h5fc.1
@@ -0,0 +1,90 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.4.
+.TH FORTRAN "1" "August 2011" "Fortran (Debian 4.6.1-4) 4.6.1" "User Commands"
+.SH NAME
+Fortran \- Reports statistics regarding an HDF5 file and the objects in the file.
+.SH DESCRIPTION
+usage: h5fc [OPTIONS] <compile line>
+.IP
+OPTIONS:
+.TP
+\fB\-help\fR
+This help message.
+.TP
+\fB\-echo\fR
+Show all the shell commands executed
+.TP
+\fB\-prefix\fR=\fIDIR\fR
+Prefix directory to find HDF5 lib/ and include/
+.IP
+subdirectories [default: /usr]
+.TP
+\fB\-show\fR
+Show the commands without executing them
+.TP
+\fB\-showconfig\fR
+Show the HDF5 library configuration summary
+.TP
+\fB\-shlib\fR
+Compile with shared HDF5 libraries
+.TP
+\fB\-noshlib\fR
+Compile with static HDF5 libraries [default]
+.TP
+<compile line>
+\- the normal compile line options for your compiler.
+.IP
+h5fc uses the same compiler you used to compile
+HDF5. Check with your compiler's man pages for more
+information on which options are needed.
+.IP
+You can override the compiler and linker to compile your program by
+setting the following environment variables accordingly:
+.TP
+HDF5_FC
+\-  use a different Fortran 90 or 95 compiler
+.TP
+HDF5_FLINKER
+\-  use a different linker
+.TP
+HDF5_USE_SHLIB=[yes|no]
+\-  use shared or static version of the HDF5 library
+.IP
+[default: no]
+.IP
+You can also add or change paths and flags to the compile line using
+the following environment varibles or by assigning them to their counterparts
+in the 'Things You Can Modify to Override...' section of h5fc
+.TP
+Variable
+Current value to be replaced
+.TP
+HDF5_FFLAGS
+""
+.TP
+HDF5_LDFLAGS
+""
+.TP
+HDF5_LIBS
+""
+.IP
+Note that adding library paths to HDF5_LDFLAGS where another hdf5 version
+is located may link your program with that other hdf5 library version.
+.SH COPYRIGHT
+Copyright \(co 2011 Free Software Foundation, Inc.
+.PP
+GNU Fortran comes with NO WARRANTY, to the extent permitted by law.
+You may redistribute copies of GNU Fortran
+under the terms of the GNU General Public License.
+For more information about these matters, see the file named COPYING
+.SH "SEE ALSO"
+The full documentation for
+.B Fortran
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B Fortran
+programs are properly installed at your site, the command
+.IP
+.B info Fortran
+.PP
+should give you access to the complete manual.
diff --git a/debian/man/h5import.1 b/debian/man/h5import.1
index e043378..171bc0c 100644
--- a/debian/man/h5import.1
+++ b/debian/man/h5import.1
@@ -6,11 +6,11 @@ h5import \- Imports data into an existing or new HDF5 file.
 infile 
 .B \-d 
 dim_list [ 
-.B\-p 
+.B \-p 
 pathname ] [
 .B \-t 
 input_class ] [
-.B\-s 
+.B \-s 
 input_size ] [infile ...] 
 .B \-o 
 outfile
diff --git a/debian/man/h5mkgrp.1 b/debian/man/h5mkgrp.1
new file mode 100644
index 0000000..d95e885
--- /dev/null
+++ b/debian/man/h5mkgrp.1
@@ -0,0 +1,35 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.4.
+.TH H5MKGRP: "1" "August 2011" "h5mkgrp: Version 1.8.7" "User Commands"
+.SH NAME
+h5mkgrp: \- Creates a new HDF5 group in a file 
+.SH DESCRIPTION
+usage: h5mkgrp [OPTIONS] FILE GROUP...
+.IP
+OPTIONS
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print a usage message and exit
+.TP
+\fB\-l\fR, \fB\-\-latest\fR
+Use latest version of file format to create groups
+.TP
+\fB\-p\fR, \fB\-\-parents\fR
+No error if existing, make parent groups as needed
+.TP
+\fB\-v\fR, \fB\-\-verbose\fR
+Print information about OBJECTS and OPTIONS
+.TP
+\fB\-V\fR, \fB\-\-version\fR
+Print version number and exit
+.SH "SEE ALSO"
+The full documentation for
+.B h5mkgrp:
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B h5mkgrp:
+programs are properly installed at your site, the command
+.IP
+.B info h5mkgrp:
+.PP
+should give you access to the complete manual.
diff --git a/debian/man/h5perf_serial.1 b/debian/man/h5perf_serial.1
new file mode 100644
index 0000000..3eea5de
--- /dev/null
+++ b/debian/man/h5perf_serial.1
@@ -0,0 +1,211 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.4.
+.TH H5PERF_SERIAL: "1" "August 2011" "h5perf_serial: Version 1.8.7" "User Commands"
+.SH NAME
+h5perf_serial: \- Measures HDF5 serial performance.
+.SH DESCRIPTION
+h5perf_serial: Version 1.8.7
+usage: h5perf_serial [OPTIONS]
+.IP
+OPTIONS
+.TP
+\fB\-h\fR
+Print an usage message and exit
+.TP
+\fB\-A\fR AL
+Which APIs to test
+[default: all of them]
+.TP
+\fB\-c\fR SL
+Selects chunked storage and defines chunks dimensions
+and sizes
+[default: Off]
+.TP
+\fB\-e\fR SL
+Dimensions and sizes of dataset
+[default: 100,200]
+.TP
+\fB\-i\fR N
+Number of iterations to perform
+[default: 1]
+.TP
+\fB\-r\fR NL
+Dimension access order (see below for description)
+[default: 1,2]
+.TP
+\fB\-t\fR
+Selects extendable dimensions for HDF5 dataset
+[default: Off]
+.TP
+\fB\-v\fR VFD
+Selects file driver for HDF5 access
+[default: sec2]
+.TP
+\fB\-w\fR
+Perform write tests, not the read tests
+[default: Off]
+.TP
+\fB\-x\fR SL
+Dimensions and sizes of the transfer buffer
+[default: 10,20]
+.TP
+N
+\- is an integer > 0.
+.TP
+S
+\- is a size specifier, an integer > 0 followed by a size indicator:
+.IP
+K \- Kilobyte (1024)
+M \- Megabyte (1048576)
+G \- Gigabyte (1073741824)
+.IP
+Example: '37M' is 37 megabytes or 38797312 bytes
+.IP
+AL \- is an API list. Valid values are:
+.IP
+hdf5 \- HDF5
+posix \- POSIX
+.IP
+Example: \fB\-A\fR posix,hdf5
+.IP
+NL \- is list of integers (N) separated by commas.
+.IP
+Example: 1,2,3
+.IP
+SL \- is list of size specifiers (S) separated by commas.
+.IP
+Example: 2K,2K,3K
+.IP
+The example defines an object (dataset, tranfer buffer) with three
+dimensions. Be aware that as the number of dimensions increases, the
+the total size of the object increases exponentially.
+.TP
+VFD
+\- is an HDF5 file driver specifier. Valid values are:
+.IP
+sec2, stdio, core, split, multi, family, direct
+.IP
+Dimension access order:
+.IP
+Data access starts at the cardinal origin of the dataset using the
+transfer buffer. The next access occurs on a dataset region next to
+the previous one. For a multidimensional dataset, there are several
+directions as to where to proceed. This can be specified in the dimension
+access order. For example, \fB\-r\fR 1,2 states that the tool should traverse
+dimension 1 first, and then dimension 2.
+.IP
+Environment variables:
+.TP
+HDF5_NOCLEANUP
+Do not remove data files if set [default remove]
+.TP
+HDF5_PREFIX
+Data file prefix
+.PP
+usage: h5perf_serial [OPTIONS]
+.IP
+OPTIONS
+.TP
+\fB\-h\fR
+Print an usage message and exit
+.TP
+\fB\-A\fR AL
+Which APIs to test
+[default: all of them]
+.TP
+\fB\-c\fR SL
+Selects chunked storage and defines chunks dimensions
+and sizes
+[default: Off]
+.TP
+\fB\-e\fR SL
+Dimensions and sizes of dataset
+[default: 100,200]
+.TP
+\fB\-i\fR N
+Number of iterations to perform
+[default: 1]
+.TP
+\fB\-r\fR NL
+Dimension access order (see below for description)
+[default: 1,2]
+.TP
+\fB\-t\fR
+Selects extendable dimensions for HDF5 dataset
+[default: Off]
+.TP
+\fB\-v\fR VFD
+Selects file driver for HDF5 access
+[default: sec2]
+.TP
+\fB\-w\fR
+Perform write tests, not the read tests
+[default: Off]
+.TP
+\fB\-x\fR SL
+Dimensions and sizes of the transfer buffer
+[default: 10,20]
+.TP
+N
+\- is an integer > 0.
+.TP
+S
+\- is a size specifier, an integer > 0 followed by a size indicator:
+.IP
+K \- Kilobyte (1024)
+M \- Megabyte (1048576)
+G \- Gigabyte (1073741824)
+.IP
+Example: '37M' is 37 megabytes or 38797312 bytes
+.IP
+AL \- is an API list. Valid values are:
+.IP
+hdf5 \- HDF5
+posix \- POSIX
+.IP
+Example: \fB\-A\fR posix,hdf5
+.IP
+NL \- is list of integers (N) separated by commas.
+.IP
+Example: 1,2,3
+.IP
+SL \- is list of size specifiers (S) separated by commas.
+.IP
+Example: 2K,2K,3K
+.IP
+The example defines an object (dataset, tranfer buffer) with three
+dimensions. Be aware that as the number of dimensions increases, the
+the total size of the object increases exponentially.
+.TP
+VFD
+\- is an HDF5 file driver specifier. Valid values are:
+.IP
+sec2, stdio, core, split, multi, family, direct
+.IP
+Dimension access order:
+.IP
+Data access starts at the cardinal origin of the dataset using the
+transfer buffer. The next access occurs on a dataset region next to
+the previous one. For a multidimensional dataset, there are several
+directions as to where to proceed. This can be specified in the dimension
+access order. For example, \fB\-r\fR 1,2 states that the tool should traverse
+dimension 1 first, and then dimension 2.
+.IP
+Environment variables:
+.TP
+HDF5_NOCLEANUP
+Do not remove data files if set [default remove]
+.TP
+HDF5_PREFIX
+Data file prefix
+.SH "SEE ALSO"
+The full documentation for
+.B h5perf_serial:
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B h5perf_serial:
+programs are properly installed at your site, the command
+.IP
+.B info h5perf_serial:
+.PP
+should give you access to the complete manual.
diff --git a/debian/man/h5stat.1 b/debian/man/h5stat.1
new file mode 100644
index 0000000..f8b21a3
--- /dev/null
+++ b/debian/man/h5stat.1
@@ -0,0 +1,52 @@
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.4.
+.TH H5STAT: "1" "August 2011" "h5stat: Version 1.8.7" "User Commands"
+.SH NAME
+h5stat: \- Reports statistics regarding an HDF5 file and the objects in the file.
+.SH SYNOPSIS
+.B h5stat
+[\fIOPTIONS\fR] \fIfile\fR
+.SH DESCRIPTION
+.IP
+OPTIONS
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print a usage message and exit
+.TP
+\fB\-V\fR, \fB\-\-version\fR
+Print version number and exit
+.TP
+\fB\-f\fR, \fB\-\-file\fR
+Print file information
+.TP
+\fB\-F\fR, \fB\-\-filemetadata\fR
+Print file space information for file's metadata
+.TP
+\fB\-g\fR, \fB\-\-group\fR
+Print group information
+.TP
+\fB\-G\fR, \fB\-\-groupmetadata\fR
+Print file space information for groups' metadata
+.TP
+\fB\-d\fR, \fB\-\-dset\fR
+Print dataset information
+.TP
+\fB\-D\fR, \fB\-\-dsetmetadata\fR
+Print file space information for datasets' metadata
+.TP
+\fB\-T\fR, \fB\-\-dtypemetadata\fR
+Print datasets' datatype metadata
+.TP
+\fB\-A\fR, \fB\-\-attribute\fR
+Print attribute information
+.SH "SEE ALSO"
+The full documentation for
+.B h5stat:
+is maintained as a Texinfo manual.  If the
+.B info
+and
+.B h5stat:
+programs are properly installed at your site, the command
+.IP
+.B info h5stat:
+.PP
+should give you access to the complete manual.

-- 
Hierarchical Data Format 5 (HDF5)

