..
/
download
.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "s1kd-dmrl" "1" "2021-04-16" "" "s1kd-tools"
.hy
.SH NAME
.PP
s1kd-dmrl - Create CSDB objects from a DMRL
.SH SYNOPSIS
.IP
.nf
\f[C]
s1kd-dmrl [options] <DML>...
\f[R]
.fi
.SH DESCRIPTION
.PP
The \f[I]s1kd-dmrl\f[R] tool reads S1000D data management lists and
creates CSBD objects for the entries specified using the s1kd-new*
tools.
.SH OPTIONS
.TP
-$, --issue <issue>
Specify which issue of S1000D to use when creating objects.
.TP
-\[at], --out <dir>
Create new objects in <dir>.
.TP
-%, --templates <dir>
Use XML templates in the specified directory instead of the built-in
templates of each of the s1kd-new* tools.
.TP
-D, --dmtypes <path>
Specify the .dmtypes file name.
.TP
-d, --defaults <path>
Specify the .defaults file name.
.TP
-F, --fail
Fail on the first error generated by any of the s1kd-new* commands.
Normally, errors with individual DMRL entries will be reported but the
other entries will still be processed.
.TP
-f, --overwrite
Overwrite existing CSDB objects.
.TP
-h, -?, --help
Show help/usage message.
.TP
-m, --use-remarks
Use the remarks for an entry as the remarks for the new CSDB object.
.TP
-N, --omit-issue
Omit issue/in-work numbers from the filenames of created CSDB objects.
.TP
-q, --quiet
Do not report errors when any of the CSDB objects already exist.
.TP
-s, --commands
Do not create CSDB objects, only output the s1kd-new* commands to create
them.
.TP
-v, --verbose
Print the filenames of newly created CSDB objects.
.TP
--version
Show version information.
.TP
<DML>...
One or more S1000D data management lists.
.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 EXAMPLE
.IP
.nf
\f[C]
$ s1kd-dmrl DML-EX-12345-C-2018-00001_001-00.XML
\f[R]
.fi
.SH AUTHORS
khzae.net.
gopher://khzae.net/0/s1kd/s1kd-tools/src/tools/s1kd-dmrl/doc/s1kd-dmrl.1