..
/
download
# NAME
s1kd-newddn - Create an S1000D Data Dispatch Note (DDN).
# SYNOPSIS
s1kd-newddn [options] <files>...
# DESCRIPTION
The *s1kd-newddn* tool creates a new S1000D data dispatch note with the
code, metadata, and list of files specified.
# OPTIONS
- \-\#, --code \<code\>
The code of the new data dispatch note, in the form of
MODELIDENTCODE-SENDER-RECEIVER-YEAR-SEQUENCE.
- \-$, --issue \<issue\>
Specifiy which issue of S1000D to use. Currently supported issues
are:
- 5.0 (default)
- 4.2
- 4.1
- 4.0
- 3.0
- 2.3
- 2.2
- 2.1
- 2.0
- \-@, --out \<path\>
Save the new DDN to \<path\>. If \<path\> is an existing directory,
the DDN will be created in it instead of the current directory.
Otherwise, the DDN will be saved as the filename \<path\> instead of
being automatically named.
- \-%, --templates \<dir\>
Use the XML template in the specified directory instead of the
built-in template. The template must be named `ddn.xml` inside
\<dir\> and must conform to the default S1000D issue (5.0).
- \-\~, --dump-templates \<dir\>
Dump the built-in XML template to the specified directory.
- \-a, --authorization \<auth\>
Specify the authorization.
- \-b, --brex \<BREX\>
BREX data module code.
- \-d, --defaults \<file\>
Specify the `.defaults` file name.
- \-f, --overwrite
Overwrite existing file.
- \-h, -?, --help
Show help/usage message.
- \-I, --date \<date\>
The issue date of the new DDN in the form of YYYY-MM-DD.
- \-m, --remarks \<remarks\>
Set the remarks for the new data dispatch note.
- \-N, --receiver-country \<country\>
The receiver's country.
- \-n, --sender-country \<country\>
The sender's country.
- \-o, --sender \<name\>
The enterprise name of the sender.
- \-p, --prompt
Prompt the user for values left unspecified.
- \-q, --quiet
Do not report an error when the file already exists.
- \-r, --receiver \<name\>
The enterprise name of the receiver.
- \-T, --receiver-city \<city\>
The receiver's city.
- \-t, --sender-city \<city\>
The sender's city.
- \-v, --verbose
Print the file name of the newly created DDN.
- \--version
Show version information.
In addition, the following options allow configuration of the XML
parser:
- \--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.
## `.defaults` file
Refer to s1kd-newdm(1) for information on the `.defaults` file which is
used by all the s1kd-new\* commands.
# EXAMPLE
$ s1kd-newddn -# EX-12345-54321-2018-00001
gopher://khzae.net/0/s1000d/s1kd-tools/src/tools/s1kd-newddn/README.md