Each change to a VOB (checkin of new version, attaching of a version label, and so on) is recorded in an event record, which is created in the VOB database. Many commands allow you to annotate the event records that they create with a comment string. Commands that display event record information (describe, lscheckout, lshistory, lslock, lspool, lsreplica, and lstype) show the comments, as well. See the fmt_ccase reference page for a description of the report-writing facility built in to these commands.
A comment string may not exceed 256 bytes per line. All commands that accept comment strings recognize the same options:
Note: A final line-terminator in this file is included in the comment.
A –cq or –cqe comment string can span several lines. To end a comment, enter an EOF character at the beginning of a line, typically by pressing CTRL+D (UNIX) or CTRL+Z and RETURN (Windows), or by typing a period and pressing RETURN. For example:
cmd-context checkout main.c
Checkout comments for "main.c":
This is my comment; the following line terminates the comment.
Checked out "main.c" from version "\main\3"
The chevent command revises the comment string in an existing event record. For a detailed discussion of event records, see the events_ccase reference page.
cleartool can reuse a previously specified comment as the default comment. If the environment variable CLEARCASE_CMNT_PN specifies a file, that file is used as a comment cache:
Exception: If an element's checkout record includes a comment, that comment is the default for checkin, not the contents of the comment cache file.
Note: A comment specified noninteractively (for example, with the command cleartool mkdir –c “test files”), does not update the comment cache file.
The value of CLEARCASE_CMNT_PN can be any valid pathname. Using a simple file name (for example, .ccase_cmnt) can implement a comment cache for the current working directory; different directories then have different .ccase_cmnt files. Using the full pathname $HOME/.ccase_cmnt (UNIX) or %HOME%\.ccase_cmnt (Windows) implements a cache of the individual user's comments, across all VOBs.
If environment variable CLEARCASE_CMNT_PN is not defined in a cleartool process, a default comment is supplied only in certain situations:
Each command that accepts a comment string has a comment default, which takes effect if you enter the command without a comment option. For example, the comment default for the checkin command is –cqe, so you are prompted to enter a comment for each element being checked in. The comment default for the ln command is –nc: create the event record without a comment.
You can customize comment handling with a user profile file, .clearcase_profile, in your home directory. For example, you can establish –cqe as the comment default for the ln command. See the profile_ccase reference page for details.
Copyright© 2003 Rational Software. All Rights Reserved.