<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE dmodule>
<dmodule xmlns:dc="http://www.purl.org/dc/elements/1.1/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.s1000d.org/S1000D_5-0/xml_schema_flat/descript.xsd">
 <identAndStatusSection>
   <dmAddress>
     <dmIdent>
       <dmCode modelIdentCode="S1KDTOOLS" systemDiffCode="A" systemCode="31" subSystemCode="0" subSubSystemCode="0" assyCode="00" disassyCode="00" disassyCodeVariant="A" infoCode="040" infoCodeVariant="A" itemLocationCode="D"/>
       <language languageIsoCode="en" countryIsoCode="CA"/>
       <issueInfo issueNumber="020" inWork="00"/>
     </dmIdent>
     <dmAddressItems>
       <issueDate year="2021" month="04" day="16"/>
       <dmTitle>
         <techName>s1kd-newupf(1) | s1kd-tools</techName>
       </dmTitle>
     </dmAddressItems>
   </dmAddress>
   <dmStatus issueType="status">
     <security securityClassification="01"/>
     <responsiblePartnerCompany>
       <enterpriseName>khzae.net</enterpriseName>
     </responsiblePartnerCompany>
     <originator>
       <enterpriseName>khzae.net</enterpriseName>
     </originator>
     <applic>
       <displayText>
         <simplePara>All</simplePara>
       </displayText>
     </applic>
     <brexDmRef>
       <dmRef>
         <dmRefIdent>
           <dmCode modelIdentCode="S1000D" systemDiffCode="G" systemCode="04" subSystemCode="1" subSubSystemCode="0" assyCode="0301" disassyCode="00" disassyCodeVariant="A" infoCode="022" infoCodeVariant="A" itemLocationCode="D"/>
         </dmRefIdent>
       </dmRef>
     </brexDmRef>
     <qualityAssurance>
       <unverified/>
     </qualityAssurance>
     <reasonForUpdate>
       <simplePara>Upissued</simplePara>
     </reasonForUpdate>
   </dmStatus>
 </identAndStatusSection>
 <content>
   <description>
     <levelledPara>
       <title>NAME</title>
       <para>s1kd-newupf - Create a new data update file</para>
     </levelledPara>
     <levelledPara>
       <title>SYNOPSIS</title>
       <para>
         <verbatimText verbatimStyle="vs24">s1kd-newupf [options] &lt;SOURCE&gt; &lt;TARGET&gt;</verbatimText>
       </para>
     </levelledPara>
     <levelledPara>
       <title>DESCRIPTION</title>
       <para>The <emphasis>s1kd-newupf</emphasis> 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.</para>
     </levelledPara>
     <levelledPara>
       <title>OPTIONS</title>
       <para>
         <definitionList>
           <definitionListItem>
             <listItemTerm>-$, --issue &lt;issue&gt;</listItemTerm>
             <listItemDefinition>
               <para>Specify which issue of S1000D to use. Currently supported issues are:</para>
               <para>
                 <randomList>
                   <listItem>
                     <para>5.0 (default)</para>
                   </listItem>
                   <listItem>
                     <para>4.2</para>
                   </listItem>
                   <listItem>
                     <para>4.1</para>
                   </listItem>
                 </randomList>
               </para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>-@, --out &lt;path&gt;</listItemTerm>
             <listItemDefinition>
               <para>Save the new update file to &lt;path&gt;. If &lt;path&gt; 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 &lt;path&gt; instead of being automatically named.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>-%, --templates &lt;dir&gt;</listItemTerm>
             <listItemDefinition>
               <para>Use XML template in the specified directory instead of the built-in template. The template must be named <verbatimText verbatimStyle="vs02">update.xml</verbatimText> in the directory &lt;dir&gt;, and must conform to the default S1000D issue of this tool (5.0).</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>-~, --dump-templates &lt;dir&gt;</listItemTerm>
             <listItemDefinition>
               <para>Dump the built-in XML template to the specified directory.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>-d, --defaults &lt;file&gt;</listItemTerm>
             <listItemDefinition>
               <para>Specify the <verbatimText verbatimStyle="vs02">.defaults</verbatimText> file name.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>-f, --overwrite</listItemTerm>
             <listItemDefinition>
               <para>Overwrite existing file.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>-h, -?, --help</listItemTerm>
             <listItemDefinition>
               <para>Show help/usage message.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>-q, --quiet</listItemTerm>
             <listItemDefinition>
               <para>Do not report an error when the file already exists.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>-v, --verbose</listItemTerm>
             <listItemDefinition>
               <para>Print the file name of the newly created data update file.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>--version</listItemTerm>
             <listItemDefinition>
               <para>Show version information.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>&lt;SOURCE&gt;</listItemTerm>
             <listItemDefinition>
               <para>The source (original) issue of the CIR data module.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>&lt;TARGET&gt;</listItemTerm>
             <listItemDefinition>
               <para>The target (updated) issue of the CIR data module.</para>
             </listItemDefinition>
           </definitionListItem>
         </definitionList>
       </para>
       <para>
         In addition, the following options allow configuration of the XML parser:
         <definitionList>
           <definitionListItem>
             <listItemTerm>--dtdload</listItemTerm>
             <listItemDefinition>
               <para>Load the external DTD.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>--huge</listItemTerm>
             <listItemDefinition>
               <para>Remove any internal arbitrary parser limits.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>--net</listItemTerm>
             <listItemDefinition>
               <para>Allow network access to load external DTD and entities.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>--noent</listItemTerm>
             <listItemDefinition>
               <para>Resolve entities.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>--parser-errors</listItemTerm>
             <listItemDefinition>
               <para>Emit errors from parser.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>--parser-warnings</listItemTerm>
             <listItemDefinition>
               <para>Emit warnings from parser.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>--xinclude</listItemTerm>
             <listItemDefinition>
               <para>Do XInclude processing.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>--xml-catalog &lt;file&gt;</listItemTerm>
             <listItemDefinition>
               <para>Use an XML catalog when resolving entities. Multiple catalogs may be loaded by specifying this option multiple times.</para>
             </listItemDefinition>
           </definitionListItem>
         </definitionList>
       </para>
       <levelledPara>
         <title><verbatimText verbatimStyle="vs02">.defaults</verbatimText> file</title>
         <para>Refer to s1kd-newdm(1) for information on the <verbatimText verbatimStyle="vs02">.defaults</verbatimText> file which is used by all the s1kd-new* tools.</para>
       </levelledPara>
     </levelledPara>
     <levelledPara>
       <title>EXAMPLE</title>
       <para>
         <verbatimText verbatimStyle="vs24">$ 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</verbatimText>
       </para>
     </levelledPara>
   </description>
 </content>
</dmodule>