chevent

Default

For each object or event, chevent prompts for a comment string to apply to the corresponding event record.

–c/omment comment

Specifies a character string to replace the existing comment or be added to it.

–cfi/le comment-file-pname

Specifies a text file whose contents are to be placed in the event record.

Note: A final newline character in this file is included in the comment.

–cq/uery

Prompts for one comment, which will be used to update all of the event records.

–cqe/ach

Same as default; prompts for a separate comment string for each object or event ID.

–nc/omment

No comment. When combined with –replace, this option removes the existing comment. Otherwise, it nullifies the effect of chevent.

Default

The new comment is appended to the existing one. On UNIX and Linux systems, it is preceded by a newline character.

–app/end

Same as default.

–ins/ert

The new comment is inserted before the existing one. On UNIX and Linux systems, the new comment is followed by a newline character.

–rep/lace

The existing comment is discarded; the new comment replaces it.

You can indicate which event record is to be changed by specifying a file system object, a non-file-system object, or a numerical event ID.

Default

None.

–eve/nt [ –inv/ob vob-selector ] event-ID ...

Specifies one or more events by their numeric event IDs. The –event keyword can be used anywhere an option is valid; the event ID arguments must appear at the end of the command (that is, after all options). By default, event IDs specify events in the VOB containing the current working directory; use –invob vob-selector to specify another VOB.

To determine the event ID of an event, use lshistory –eventid.

[ –pna/me ] pname ...

A standard path name or VOB-extended path name, indicating the creation event record for an element, branch, or version object. The standard path name of an element specifies the version in your view. The –pname option is required only if the path name looks like an object-selector (for example, an element named pool:one).

Specifying a checked-out version changes its checkout version comment. You can use any of the following to specify the checked-out version:

hello.h	Standard path name
hello.h@@\main\rel2_bugfix\CHECKEDOUT	Extended path name to checked-out “placeholder” version
hello.h@@/main/rel2_bugfix/CHECKEDOUT.465	Placeholder version has unique numeric suffix

object-selector ...

One or more object-selectors, in any of these forms:

vob-selector	vob:pname-in-vob
	pname-in-vob can be the path name of the VOB tag (whether or not the VOB is mounted) or of any file system object within the VOB (if the VOB is mounted). It cannot be the path name of the VOB storage directory.
attribute-type-selector	attype:type-name[@vob-selector]
branch-type-selector	brtype:type-name[@vob-selector]
element-type-selector	eltype:type-name[@vob-selector]
hyperlink-type-selector	hltype:type-name[@vob-selector]
label-type-selector	lbtype:type-name[@vob-selector]
trigger-type-selector	trtype:type-name[@vob-selector]
pool-selector	pool:pool-name[@vob-selector]
hlink-selector	hlink:hlink-id[@vob-selector]
oid-obj-selector	oid:object-oid[@vob-selector]
The following object selector is valid only if you use MultiSite:
replica-selector	replica:replica-name[@vob-selector]