COMMENT Option for DSEE Commands:
-comment
Lets you supply commentary on an operation in the command line.
Format
-comment { text | "<"pathname } ...
Description
The DSEE facility has a number of commands that, by default, display edit panes
in which you enter commentary or other information. The -comment option allows
you to respond to a DSEE request for commentary directly from the command line.
You can supply commentary in a text string or by specifying a file containing
comments. If you supply a text string, be sure to enclose your comment string
in single or double quotation marks (for example, "This is a comment."). If you
want the DSEE facility to take comments from a file, precede the pathname with a
left angle bracket (for example, <//node1/alfred/update_comments). Sending
comments from a file is particularly useful when you want to provide commentary
that is more than one line long.
You may give as many as four arguments (text strings, pathnames, or both) to the
-comment option.
The -title option for create task is like the -comment option, except that you
use it to enter a task title from the command line.
While you can add the -comment option to any DSEE command, it only affects those
commands that, by default, display edit panes. (There is one exception to this
rule, which is discussed in the next paragraph.) Commentary supplied with the
-comment option can be used to fill any edit pane that the DSEE facility
displays. For example, you can alter the protection on a library by writing a
comment file that contains all of the appropriate protection specifications you
wish on the file and then executing a command like the following one.
DSEE> protect library -comment <//my_node/alfred/attributes -nq
(The -nq option suppresses the DSEE facility's query as to whether you want to
change the library's protection. Type help $nq for more information on this
option.)
The one command affected by -comment that does not display an edit pane by
default is the build command. The only way that you can supply commentary on a
build process is to add the -comment option to the build command.