.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "s1kd-newupf" "1" "2021-04-16" "" "s1kd-tools"
.hy
.SH NAME
.PP
s1kd-newupf - Create a new data update file
.SH SYNOPSIS
.IP
.nf
\f[C]
s1kd-newupf [options] <SOURCE> <TARGET>
\f[R]
.fi
.SH DESCRIPTION
.PP
The \f[I]s1kd-newupf\f[R] tool creates a new S1000D data update file for
two specified issues of a CIR data module.
Changes to items between the source and target issues of the CIR are
recorded in the resulting UPF, along with update instructions.
.SH OPTIONS
.TP
-$, --issue <issue>
Specify which issue of S1000D to use.
Currently supported issues are:
.RS
.IP \[bu] 2
5.0 (default)
.IP \[bu] 2
4.2
.IP \[bu] 2
4.1
.RE
.TP
-\[at], --out <path>
Save the new update file to <path>.
If <path> is an existing directory, the update file will be created in
it instead of the current directory.
Otherwise, the update file will be saved as the filename <path> instead
of being automatically named.
.TP
-%, --templates <dir>
Use XML template in the specified directory instead of the built-in
template.
The template must be named \f[C]update.xml\f[R] in the directory <dir>,
and must conform to the default S1000D issue of this tool (5.0).
.TP
-\[ti], --dump-templates <dir>
Dump the built-in XML template to the specified directory.
.TP
-d, --defaults <file>
Specify the \f[C].defaults\f[R] file name.
.TP
-f, --overwrite
Overwrite existing file.
.TP
-h, -?, --help
Show help/usage message.
.TP
-q, --quiet
Do not report an error when the file already exists.
.TP
-v, --verbose
Print the file name of the newly created data update file.
.TP
--version
Show version information.
.TP
<SOURCE>
The source (original) issue of the CIR data module.
.TP
<TARGET>
The target (updated) issue of the CIR data module.
.PP
In addition, the following options allow configuration of the XML
parser:
.TP
--dtdload
Load the external DTD.
.TP
--huge
Remove any internal arbitrary parser limits.
.TP
--net
Allow network access to load external DTD and entities.
.TP
--noent
Resolve entities.
.TP
--parser-errors
Emit errors from parser.
.TP
--parser-warnings
Emit warnings from parser.
.TP
--xinclude
Do XInclude processing.
.TP
--xml-catalog <file>
Use an XML catalog when resolving entities.
Multiple catalogs may be loaded by specifying this option multiple
times.
.SS \f[C].defaults\f[R] file
.PP
Refer to s1kd-newdm(1) for information on the \f[C].defaults\f[R] file
which is used by all the s1kd-new* tools.
.SH EXAMPLE
.IP
.nf
\f[C]
$ s1kd-newupf \[rs]
    DMC-EX-A-00-00-00-00A-00GA-D_001-00_EN-CA.XML \[rs]
    DMC-EX-A-00-00-00-00A-00GA-D_002-00_EN-CA.XML
\f[R]
.fi
.SH AUTHORS
khzae.net.