# NAME

s1kd-newupf - Create a new data update file

# SYNOPSIS

    s1kd-newupf [options] <SOURCE> <TARGET>

# DESCRIPTION

The *s1kd-newupf* 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.

# OPTIONS

  - \-$, --issue \<issue\>  
    Specify which issue of S1000D to use. Currently supported issues
    are:
    
      - 5.0 (default)
    
      - 4.2
    
      - 4.1

  - \-@, --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.

  - \-%, --templates \<dir\>  
    Use XML template in the specified directory instead of the built-in
    template. The template must be named `update.xml` in the directory
    \<dir\>, and must conform to the default S1000D issue of this tool
    (5.0).

  - \-\~, --dump-templates \<dir\>  
    Dump the built-in XML template to the specified directory.

  - \-d, --defaults \<file\>  
    Specify the `.defaults` file name.

  - \-f, --overwrite  
    Overwrite existing file.

  - \-h, -?, --help  
    Show help/usage message.

  - \-q, --quiet  
    Do not report an error when the file already exists.

  - \-v, --verbose  
    Print the file name of the newly created data update file.

  - \--version  
    Show version information.

  - \<SOURCE\>  
    The source (original) issue of the CIR data module.

  - \<TARGET\>  
    The target (updated) issue of the CIR data module.

In addition, the following options allow configuration of the XML
parser:

  - \--dtdload  
    Load the external DTD.

  - \--huge  
    Remove any internal arbitrary parser limits.

  - \--net  
    Allow network access to load external DTD and entities.

  - \--noent  
    Resolve entities.

  - \--parser-errors  
    Emit errors from parser.

  - \--parser-warnings  
    Emit warnings from parser.

  - \--xinclude  
    Do XInclude processing.

  - \--xml-catalog \<file\>  
    Use an XML catalog when resolving entities. Multiple catalogs may be
    loaded by specifying this option multiple times.

## `.defaults` file

Refer to s1kd-newdm(1) for information on the `.defaults` file which is
used by all the s1kd-new\* tools.

# EXAMPLE

    $ s1kd-newupf \
        DMC-EX-A-00-00-00-00A-00GA-D_001-00_EN-CA.XML \
        DMC-EX-A-00-00-00-00A-00GA-D_002-00_EN-CA.XML