..
/
download
.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "s1kd-syncrefs" "1" "2021-04-16" "" "s1kd-tools"
.hy
.SH NAME
.PP
s1kd-syncrefs - Synchronize references in a data module
.SH SYNOPSIS
.IP
.nf
\f[C]
s1kd-syncrefs [-dflqvh?] [-o <out>] [<data module>...]
\f[R]
.fi
.SH DESCRIPTION
.PP
The \f[I]s1kd-syncrefs\f[R] 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 exists, it is overwritten.
.SH OPTIONS
.TP
-d, --delete
Delete the <refs> element.
.TP
-f, --overwrite
Overwrite the data modules automatically.
.TP
-h, -?, --help
Show help/usage message.
.TP
-l, --list
Treat input (stdin or arguments) as lists of data modules to synchronize
references in, rather than data modules themselves.
.TP
-o, --out <out>
The resulting XML is written to <out> instead of stdout.
.TP
-q, --quiet
Quiet mode.
Errors are not printed.
.TP
-v, --verbose
Verbose output.
.TP
--version
Show version information.
.TP
<data module>...
The data module(s) to synchronize references in.
Default is to read from stdin.
.PP
In addition, the following options allow configuration of the XML
parser:
.TP
--dtdload
Load the external DTD.
.TP
--huge
Remove any internal arbitrary parser limits.
.TP
--net
Allow network access to load external DTD and entities.
.TP
--noent
Resolve entities.
.TP
--parser-errors
Emit errors from parser.
.TP
--parser-warnings
Emit warnings from parser.
.TP
--xinclude
Do XInclude processing.
.TP
--xml-catalog <file>
Use an XML catalog when resolving entities.
Multiple catalogs may be loaded by specifying this option multiple
times.
.SH EXIT STATUS
.TP
0
No errors.
.TP
1
Invalid data module.
.TP
2
Number of references in a data module exceeded the available memory.
.SH EXAMPLE
.IP
.nf
\f[C]
$ s1kd-syncrefs -f DMC-EX-A-00-00-00-00A-040A-D_000-01_EN-CA.XML
\f[R]
.fi
.SH AUTHORS
khzae.net.
gopher://khzae.net/0/s1000d/s1kd-tools/src/tools/s1kd-syncrefs/doc/s1kd-syncrefs.1