/ .. / / -> download
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)


/ gopher://khzae.net/0/s1000d/s1kd-tools/docs/creating/s1kd-newcom.txt
Styles: Light Dark Classic