If an output data object is specified, the input data object is copied to the output data object and the comment on the output data object is changed. If there was no output data object specified, then the comment is changed on the input data object. Note that the underlying data format for the image actually determines whether the comment can be stored with the data object or not. For instance, Khoros VIFF and XVIMAGE formats support the storage of a comment while the XPM format does not. Thus changing the comment on an XPM image will have essentially no effect.
A comment string can be provided (-s). Depending on the selected
option, this string will replace the comment (-re), be appended to the
existing comment (-ap), or be prepended to the existing comment (-pr).
Yet another option allows the comment can be edited directly (-ed).
If editing is desired, this routine will bring up an editor session
as determined by your KEDITOR environment variable. Within this session
will be the previous comment. Once you have completed editing the comment,
save and quit the editor, and the edited comment will be assigned.
Mutually Exclusive Group; if desired, specify ONE of:
OR
OR
OR
kcomment -i image.viff -c "This is a new comment"
will change the comment on image.viff to "This is a new comment"