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)