<?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_4-2/xml_schema_flat/descript.xsd">
 <identAndStatusSection>
   <dmAddress>
     <dmIdent>
       <dmCode modelIdentCode="XMLUTILS" systemDiffCode="A" systemCode="01" subSystemCode="0" subSubSystemCode="0" assyCode="00" disassyCode="00" disassyCodeVariant="A" infoCode="040" infoCodeVariant="A" itemLocationCode="D"/>
       <language languageIsoCode="en" countryIsoCode="CA"/>
       <issueInfo issueNumber="008" inWork="01"/>
     </dmIdent>
     <dmAddressItems>
       <issueDate year="2020" month="07" day="07"/>
       <dmTitle>
         <techName>xml-merge(1) | xml-utils</techName>
       </dmTitle>
     </dmAddressItems>
   </dmAddress>
   <dmStatus issueType="changed">
     <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="F" 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 id="rfu-xml-catalog" updateHighlight="1" updateReasonType="urt02">
       <simplePara>Add --xml-catalog parser option.</simplePara>
     </reasonForUpdate>
   </dmStatus>
 </identAndStatusSection>
 <content>
   <description>
     <levelledPara>
       <title>NAME</title>
       <para>xml-merge - Merge XML files on a common element</para>
     </levelledPara>
     <levelledPara>
       <title>SYNOPSIS</title>
       <para>
         <verbatimText verbatimStyle="vs24">xml-merge [-fh?] &lt;dst&gt; &lt;src&gt;</verbatimText>
       </para>
     </levelledPara>
     <levelledPara>
       <title>DESCRIPTION</title>
       <para>The <emphasis>xml-merge</emphasis> utility merges two XML files together, based on a common element.</para>
     </levelledPara>
     <levelledPara>
       <title>OPTIONS</title>
       <para>
         <definitionList>
           <definitionListItem>
             <listItemTerm>-f, --overwrite</listItemTerm>
             <listItemDefinition>
               <para>Overwrite the &lt;dst&gt; file with the merged result, instead of writing to stdout.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>-h, -?, --help</listItemTerm>
             <listItemDefinition>
               <para>Show usage message.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>--version</listItemTerm>
             <listItemDefinition>
               <para>Show version information.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>&lt;dst&gt;</listItemTerm>
             <listItemDefinition>
               <para>The XML file which &lt;src&gt; will be merged in to.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem>
             <listItemTerm>&lt;src&gt;</listItemTerm>
             <listItemDefinition>
               <para>The XML file which will me merged in to &lt;dst&gt;. The first occurence of an element in &lt;dst&gt; which matches the root element of this file is where the merge will occur.</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>--xinclude</listItemTerm>
             <listItemDefinition>
               <para>Do XInclude processing.</para>
             </listItemDefinition>
           </definitionListItem>
           <definitionListItem changeMark="1" changeType="add" reasonForUpdateRefIds="rfu-xml-catalog">
             <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>
     <levelledPara>
       <title>EXAMPLE</title>
       <para>Given the following two XML files:</para>
       <para>
         <emphasis><verbatimText verbatimStyle="vs02">file1.xml</verbatimText>:</emphasis>
         <verbatimText verbatimStyle="vs11">&lt;root&gt;
&lt;metadata&gt;...&lt;/metadata&gt;
&lt;content/&gt;
&lt;/root&gt;</verbatimText>
       </para>
       <para>
         <emphasis><verbatimText verbatimStyle="vs02">file2.xml</verbatimText>:</emphasis>
         <verbatimText verbatimStyle="vs11">&lt;content&gt;
&lt;text&gt;Hello world.&lt;/text&gt;
&lt;/content&gt;</verbatimText>
       </para>
       <para>the xml-merge utility will merge them on the element <verbatimText verbatimStyle="vs12">content</verbatimText>:</para>
       <para>
         <verbatimText verbatimStyle="vs24">$ xml-merge file1.xml file2.xml &gt; merged.xml</verbatimText>
       </para>
       <para>to produce the merged file:</para>
       <para>
         <emphasis><verbatimText verbatimStyle="vs02">merged.xml</verbatimText>:</emphasis>
         <verbatimText verbatimStyle="vs11">&lt;root&gt;
&lt;metadata&gt;...&lt;/metadata&gt;
&lt;content&gt;
&lt;text&gt;Hello world.&lt;/text&gt;
&lt;/content&gt;
&lt;/root&gt;</verbatimText>
       </para>
     </levelledPara>
   </description>
 </content>
</dmodule>

You are viewing proxied material from khzae.net. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.