.TH NXTRANSLATE 1 "October 2011"
.\" 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
nxtranslate \- convert anything into a NeXus file
.SH SYNOPSIS
.B nxtranslate
[options] [--hd4|--hdf5|--xml] [\fIinfile\fP] [-o|--append \fIoutfile\fP]
.SH DESCRIPTION
.B nxtranslate
is an anything to NeXus converter. This is
accomplished by using translation files and a plugin style of
architecture where 
.B nxtranslate
can read from new formats as plugins
become available. This document describes the usage of
.B nxtranslate
by three types of individuals: the person using existing translation
files to create NeXus files, the person creating translation files,
and the person writing new Retrievers. All of these concepts are
discussed in detail.
.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 --help
Print out the help message and exit
.TP
.B --version
Print out the version and exit
.TP
.B -o outfile
Specify output file. The default is the translation file with ".nxs" appended.
.TP
.B --append outfile
Specify appending to the output file.
.TP
.B --hdf4
Write file using the hdf4 base.
.TP
.B --hdf5
Write file using the hdf5 base.
.TP
.B --xml
Write file using the xml base.
.TP
.B -D macro
Specify a macro. The macro should be in the form of "FILE=old_nexus.nxs". The "=" is required.
.SH SEE ALSO
.BR nxconvert(1),
.BR nxdir (1),
.BR http://www.nexusformat.org
.SH AUTHOR
.B nxtranslate
was originally written by Peter Peterson 
.nh
<petersonpf@ornl.gov>
.hy
and may be used by others.