[h5utils] 01/02: Add manpage for h4fromh5.

[Sebastiaan Couwenberg]

This is an automated email from the git hooks/post-receive script.

sebastic pushed a commit to branch master
in repository h5utils.

commit 428c0983beee36d92145d4b4c9a02858847e07fe
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date:   Sun May 22 22:47:22 2016 +0200

    Add manpage for h4fromh5.
---
 debian/changelog      |  6 +++++
 debian/man/h4fromh5.1 | 72 +++++++++++++++++++++++++++++++++++++++++++++++++++
 debian/manpages       |  1 +
 3 files changed, 79 insertions(+)

diff --git a/debian/changelog b/debian/changelog
index 111d947..9b0ea6b 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,9 @@
+h5utils (1.12.1-6) UNRELEASED; urgency=medium
+
+  * Add manpage for h4fromh5.
+
+ -- Bas Couwenberg <sebastic at debian.org>  Sun, 22 May 2016 22:47:13 +0200
+
 h5utils (1.12.1-5) unstable; urgency=medium
 
   * Team upload.
diff --git a/debian/man/h4fromh5.1 b/debian/man/h4fromh5.1
new file mode 100644
index 0000000..5f708e5
--- /dev/null
+++ b/debian/man/h4fromh5.1
@@ -0,0 +1,72 @@
+'\" -*- coding: us-ascii -*-
+.if \n(.g .ds T< \\FC
+.if \n(.g .ds T> \\F[\n[.fam]]
+.de URL
+\\$2 \(la\\$1\(ra\\$3
+..
+.if \n(.g .mso www.tmac
+.TH h4fromh5 1 "22 May 2016" "" ""
+.SH NAME
+h4fromh5 \- convert HDF5 scientific dataset to an HDF4 file
+.SH SYNOPSIS
+'nh
+.fi
+.ad l
+\fBh4fromh5\fR \kx
+.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
+'in \n(.iu+\nxu
+[\fIOPTIONS\fR] [\fIHDF5-FILES\fR]
+'in \n(.iu-\nxu
+.ad b
+'hy
+.SH DESCRIPTION
+\fBh4fromh5\fR takes one or more files in HDF5 format and
+outputs files in HDF4 format containing the datasets from the HDF5 files.
+(Currently, only a single dataset per HDF5 file is converted.)
+.PP
+HDF4 and HDF5 are free, portable binary formats and supporting libraries
+developed by the National Center for Supercomputing Applications at the
+University of Illinois in Urbana-Champaign.
+.PP
+A single h5 file can contain multiple data sets; by default,
+\fBh4fromh5\fR converts the first dataset, but this can be
+changed via the \*(T<\fB\-d\fR\*(T> option, or by using the syntax
+\*(T<HDF5FILE:DATASET\*(T>.
+.PP
+The most basic usage is something like
+\(cq\fBh4fromh5\fR \*(T<\fIfoo.h5\fR\*(T>\(cq,
+which will output a file \*(T<\fIfoo.hdf\fR\*(T> containing
+the scientific dataset from \*(T<\fIfoo.h5\fR\*(T>.
+.SH OPTIONS
+.TP 
+\*(T<\fB\-h\fR\*(T>
+Display help on the command-line options and usage.
+.TP 
+\*(T<\fB\-V\fR\*(T>
+Print the version number and copyright info for
+\fBh4fromh5\fR.
+.TP 
+\*(T<\fB\-v\fR\*(T>
+Verbose output.
+.TP 
+\*(T<\fB\-T\fR\*(T>
+Transpose the output dataset (e.g. LxMxN becomes NxMxL).
+This is often useful because HDF5 programs typically follow C
+(row-major) conventions while HDF4 programs often follow Fortran
+(column-major, transposed) conventions for array ordering.
+.TP 
+\*(T<\fB\-o\fR\*(T> \fIfile\fR
+Send HDF output to \fIfile\fR rather than to
+the input filename with \*(T<.h5\*(T> replaced with
+\*(T<\&.hdf\*(T> (the default).
+.TP 
+\*(T<\fB\-d\fR\*(T> \fIname\fR
+Read from dataset \fIname\fR in the input;
+otherwise, the first dataset in the input file is used.
+Alternatively, use the syntax \*(T<HDF5FILE:DATASET\*(T>
+when the input file names are specified. 
+.SH BUGS
+Send bug reports to S. G. Johnson, stevenj at alum.mit.edu.
+.SH AUTHORS
+Written by Steven G. Johnson.
+Copyright (c) 2005 by the Massachusetts Institute of Technology.
diff --git a/debian/manpages b/debian/manpages
new file mode 100644
index 0000000..66bb043
--- /dev/null
+++ b/debian/manpages
@@ -0,0 +1 @@
+debian/man/h4fromh5.1

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/h5utils.git