s1kd-newcom(1)                    s1kd-tools                    s1kd-newcom(1)

NAME
      s1kd-newcom - Create a new S1000D comment.

SYNOPSIS
             s1kd-newcom [options]

DESCRIPTION
      The  s1kd-newcom  tool  creates  a new S1000D comment with the code and
      metadata specified.

OPTIONS
      -#, --code <code>
             The code of the comment, in the form of  MODELIDENTCODE-SENDERI‐
             DENT-YEAR-SEQ-TYPE.

      -$, --issue <issue>
             Specify  which  issue of S1000D to use.  Currently supported is‐
             sues 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 comment to <path>.  If <path> is an existing direc‐
             tory,  the  comment will be created in it instead of the current
             directory.  Otherwise, the comment 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  comment.xml  in‐
             side <dir> and must conform to the default S1000D issue (5.0).

      -~, --dump-templates <dir>
             Dump the built-in XML template to the specified directory.

      -b, --brex <BREX>
             BREX data module code.

      -C, --country <country>
             The country ISO code of the new comment.

      -c, --security <sec>
             The security classification of the new comment.

      -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 comment in the form of YYYY-MM-DD.

      -L, --language <lang>
             The language ISO code of the new comment.

      -m, --remarks <remarks>
             Set the remarks for the new comment.

      -o, --origname <orig>
             The enterprise name of the originator of the comment.

      -P, --priority <code>
             The priority code of the new comment.

      -p, --prompt
             Prompt the user for values left unspecified.

      -q, --quiet
             Do not report an error when the file already exists.

      -r, --response <type>
             The response type of the new comment.

      -t, --title <title>
             The title of the new comment.

      -v, --verbose
             Print the file name of the newly created comment.

      -z, --issue-type <type>
             The issue type of the new comment.

      --version
             Show version information.

      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.

  .defaults file
      Refer  to  s1kd-newdm(1) for information on the .defaults file which is
      used by all the s1kd-new* commands.

EXAMPLE
             $ s1kd-newcom -# EX-12345-2018-00001-Q

AUTHORS
      khzae.net.

                                 2021-04-16                    s1kd-newcom(1)