s1kd-syncrefs(1)                  s1kd-tools                  s1kd-syncrefs(1)

NAME
       s1kd-syncrefs - Synchronize references in a data module

SYNOPSIS
              s1kd-syncrefs [-dflqvh?] [-o <out>] [<data module>...]

DESCRIPTION
       The  s1kd-syncrefs  tool  copies all external references (dmRef, pmRef,
       externalPubRef) within the content of a data module and  uses  them  to
       generate  the <refs> element.  Each unique reference is copied, sorted,
       and placed in to the <refs> element.  If a <refs> element  already  ex‐
       ists, it is overwritten.

OPTIONS
       -d, --delete
              Delete the <refs> element.

       -f, --overwrite
              Overwrite the data modules automatically.

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

       -l, --list
              Treat  input  (stdin  or  arguments) as lists of data modules to
              synchronize references in, rather than data modules themselves.

       -o, --out <out>
              The resulting XML is written to <out> instead of stdout.

       -q, --quiet
              Quiet mode.  Errors are not printed.

       -v, --verbose
              Verbose output.

       --version
              Show version information.

       <data module>...
              The data module(s) to synchronize references in.  Default is  to
              read from stdin.

       In addition, the following options allow configuration of the XML pars‐
       er:

       --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.

EXIT STATUS
       0      No errors.

       1      Invalid data module.

       2      Number  of  references  in  a data module exceeded the available
              memory.

EXAMPLE
              $ s1kd-syncrefs -f DMC-EX-A-00-00-00-00A-040A-D_000-01_EN-CA.XML

AUTHORS
       khzae.net.

                                  2021-04-16                  s1kd-syncrefs(1)