Go to the previous, next section.

Substitution modes

You can control how RCS expands keywords through the use of the `-k' option (see section Common command options). The `-k' option is available with the add, checkout, diff and update commands.

Five different modes are available. They are:

`-kkv'

Generate keyword strings using the default form, e.g. $Revision: 5.7 $ for the Revision keyword.

`-kkvl'

Like `-kkv', except that a locker's name is always inserted if the given revision is currently locked. This option is normally not useful when CVS is used.

`-kk'

Generate only keyword names in keyword strings; omit their values. For example, for the Revision keyword, generate the string $Revision$ instead of $Revision: 5.7 $. This option is useful to ignore differences due to keyword substitution when comparing different revisions of a file.

`-ko'

Generate the old keyword string, present in the working file just before it was checked in. For example, for the Revision keyword, generate the string $Revision: 1.1 $ instead of $Revision: 5.7 $ if that is how the string appeared when the file was checked in. This can be useful for binary file formats that cannot tolerate any changes to substrings that happen to take the form of keyword strings.

`-kv'

Generate only keyword values for keyword strings. For example, for the Revision keyword, generate the string 5.7 instead of $Revision: 5.7 $. This can help generate files in programming languages where it is hard to strip keyword delimiters like $Revision: $ from a string. However, further keyword substitution cannot be performed once the keyword names are removed, so this option should be used with care.

This option is always use by cvs export---see section export--Export sources from CVS, similar to checkout.

Go to the previous, next section.