..
/
download
.\" Automatically generated by Pandoc 2.9.2.1
.\"
.TH "s1kd-newdml" "1" "2021-04-16" "" "s1kd-tools"
.hy
.SH NAME
.PP
s1kd-newdml - Create a new S1000D data management list
.SH SYNOPSIS
.IP
.nf
\f[C]
s1kd-newdml [options] [<object>...]
\f[R]
.fi
.SH DESCRIPTION
.PP
The \f[I]s1kd-newdml\f[R] tool creates a new S1000D data management list
with the code and other metadata specified.
.SH OPTIONS
.TP
-#, --code <code>
The data management list code of the new DML.
.TP
-$, --issue <issue>
Specify which issue of S1000D to use.
Currently supported issues are:
.RS
.IP \[bu] 2
5.0 (default)
.IP \[bu] 2
4.2
.IP \[bu] 2
4.1
.IP \[bu] 2
4.0
.IP \[bu] 2
3.0
.IP \[bu] 2
2.3
.IP \[bu] 2
2.2
.IP \[bu] 2
2.1
.IP \[bu] 2
2.0
.RE
.TP
-\[at], --out <path>
Save the new DML to <path>.
If <path> is an existing directory, the DML will be created in it
instead of the current directory.
Otherwise, the DML will be saved as the filename <path> instead of being
automatically named.
.TP
-%, --templates <dir>
Use the XML template in the specified directory instead of the built-in
template.
The template must be named \f[C]dml.xml\f[R] inside <dir> and must
conform to the default S1000D issue (5.0).
.TP
-\[ti], --dump-templates <dir>
Dump the built-in XML template to the specified directory.
.TP
-b, --brex <BREX>
BREX data module code.
.TP
-c, --security <sec>
The security classification of the new DML.
.TP
-d, --defaults <file>
Specify the \f[C].defaults\f[R] file name.
.TP
-f, --overwrite
Overwrite existing file.
.TP
-h, -?, --help
Show usage message.
.TP
-I, --date <date>
The issue date of the new DML in the form of YYYY-MM-DD.
.TP
-i, --info-code <info code>
When creating a DMRL from SNS rules (-S), use the specified info code
for each entry.
Specify this option multiple times to create multiple data modules for
each part of the SNS.
<info code> can specify:
.RS
.IP \[bu] 2
the base info code (e.g., 520)
.IP \[bu] 2
the info code variant (e.g., 520B)
.IP \[bu] 2
the item location code (e.g., 520B-C)
.RE
.TP
-l, --list
Treat input (stdin or arguments) as lists of CSDB objects to add to the
new list.
.TP
-m, --remarks <remarks>
Set the remarks for the new data management list.
.TP
-N, --omit-issue
Omit the issue/inwork numbers from filename.
.TP
-n, --issno <issue>
The issue number of the new DML.
.TP
-p, --prompt
Prompts the user for any values left unspecified.
.TP
-q, --quiet
Do not report an error when the file already exists.
.TP
-R, --rpccode <NCAGE>
Specifies a default responsible partner company enterprise code for
entries which do not carry this in their ID STATUS section (ICN, COM,
DML).
.TP
-r, --rpcname <name>
Specifies a default responsible partner company enterprise name for
entries which do not carry this in their IDSTATUS section (ICN, COM,
DML).
.TP
-S, --sns <SNS>
Create a DMRL using the specified SNS rules.
.TP
-v, --verbose
Print the file name of the newly created DML.
.TP
-w, --inwork <inwork>
The inwork number of the new DML.
.TP
-z, --issue-type <type>
The issue type of the new DML.
.TP
--version
Show version information.
.TP
<object>...
Any number of CSDB object file names to automatically add to the list.
.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.
.SS \f[C].defaults\f[R] file
.PP
Refer to s1kd-newdm(1) for information on the \f[C].defaults\f[R] file
which is used by all the s1kd-new* commands.
.SH EXAMPLE
.IP
.nf
\f[C]
$ s1kd-newdml -# EX-12345-C-2018-00001
\f[R]
.fi
.SH AUTHORS
khzae.net.
gopher://khzae.net/0/s1000d/s1kd-tools/src/tools/s1kd-newdml/doc/s1kd-newdml.1