.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH NXCONVERT 1 "June 2010"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
nxconvert \- convert a NeXus file between different on disk file formats
.SH SYNOPSIS
.B nxconvert
[-x|-h 4|-h 5|-d|-o keepws|-o table] [\fIinfile\fP [\fIoutfile\fP]]
.SH DESCRIPTION
NeXus supports different file formats for physical storage on disk or other media.
.B nxconvert
allows the user to convert a file to a different backend.
.PP
If no output file is supplied on the command line, the program asks for one 
interactively. Same if the input file is not given.
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
.\" respectively.
.SH OPTIONS
The following options are supported:
.TP
.B -x 
create XML output
.TP
.B -h 4 
create HDF4 output
.TP
.B -h 5 
create HDF5 output
.TP
.B -d
make a XML based definition file used for validating NeXus files (i.e. remove the data).
.TP
.B -o keepws
the XML file created should preserve whitespace.
.TP
.B -o table
the XML file created should write the data in a table format where the columns and rows are easily imported into spreadsheet programs.
.SH SEE ALSO
.BR http://www.nexusformat.org
.br
.SH AUTHOR
nxconvert was originally written by Freddie Akeroyd and Ray Osborn.
.PP
This manual page was written by Tobias Richter 
.nh
<Tobias.Richter@diamond.ac.uk>
.hy
and may be used by others.