.TH trang 1 @VERSION@
.SH NAME
trang \- convert between different schema languages for XML
.SH SYNOPSIS
.B trang
.RB [ \-I
.BR rng | rnc | dtd | xml ]
.RB [ \-O
.BR rng | rnc | dtd | xsd ]
.RB [ \-i
.IR input-param ]
.RB [ \-o
.IR output-param ]
.IR input-file " ..."
.I output-file
.SH DESCRIPTION
.B trang
takes as input a schema written in any of the following formats:
.IP
RELAX NG (XML syntax)
.IP
RELAX NG (compact syntax)
.IP
XML 1.0 DTD
.PP
and produces as output a schema written in any of the following formats:
.IP
RELAX NG (XML syntax)
.IP
RELAX NG (compact syntax)
.IP
XML 1.0 DTD
.IP
W3C XML Schema
.PP
Trang can also infer a schema from one or more example XML
documents.
.PP
Trang uses an internal representation based on RELAX NG.  For each
supported input format, there is an input module that converts a
schema in that input format into this internal representation.  For
each supported output format, there is an output module that converts
the internal representation into a schema in that output format.
Thus, any supported input format can be translated to any supported
output format.
.PP
Trang requires two command-line arguments: the first is the URI or
filename of the schema to be translated; the second is the output
filename.
.PP
Trang infers the input and output modules to be used from the
extension of input and output filenames as follows:
.TP
.B .rng
RELAX NG (XML syntax)
.TP
.B .rnc
RELAX NG (compact syntax)
.TP
.B .dtd
XML 1.0 DTD
.TP
.B .xsd
W3C XML Schema
.TP
.B .xml
XML documents (used as examples from which to infer a schema)
.PP
This inference can be overridden using the 
.B \-I
and
.B \-O
options.
.LP
When the input is XML documents used as examples to infer a schema,
more than one input file may be specified as arguments.  All the input
files are specified before the output file.
.SH OPTIONS
.TP
.BR "\-I rng" | rnc | dtd | xml
Specifies which input module to use.
.TP
.BR "\-O rng" | rnc | dtd | xsd
Specifies which output module to use.
.TP
.BI \-i " input-param"
.TP
.BI \-o " output-param"
Specifies a parameter for an input
.RB ( \-i )
or output
.RB ( \-o )
module.
The
.B \-i
and
.B \-o
options may be used multiple times in order to specify
multiple parameters.  There are two kinds of parameter: boolean
parameters and string-valued parameters.  A string-valued parameter is
specified using the form
.IB name = value\fR.
A boolean parameter is
specified using the form
.I name
or
.BI no- name\fR.
The applicable parameters depend on
the particular input and output module.
For details, see the HTML documentation.
.SH "SEE ALSO"
.BR jing (1)
.LP
Trang Manual
.PP
http://relaxng.org
.SH AUTHOR
James Clark (jjc@jclark.com)
.PP
This product includes software developed by the
Apache Software Foundation (http://www.apache.org/).