(rcs.info)Substitution mode option

---

Next: Log message option Prev: Description option Up: Common elements

---

Enter node , (file) or (file)node

2.1.4 Substitution mode option
------------------------------

Some commands accept an option of the form ‘-kSUBST’, used to control
how keywords (Note: Concepts) are expanded in the working file.  In
the following table of SUBST values, the example keyword is ‘Revision’
and its value is ‘5.13’.

‘kv’
     Generate ‘$Revision: 5.13 $’ (dollar-sign, keyword, colon, space,
     value, space, dollar-sign).  A locker’s name is inserted in the
     value of the ‘Header’, ‘Id’ and ‘Locker’ keyword strings only as a
     file is being locked, i.e., by ‘ci -l’ and ‘co -l’.  This is the
     default substitution mode.

‘kvl’
     Like ‘-kkv’, except that a locker’s name is always inserted if the
     given revision is currently locked.

‘k’
     Generate ‘$Revision$’ (dollar-sign, keyword, dollar-sign).  This is
     useful when comparing different revisions of a file.  Log messages
     are inserted after ‘Log’ keywords even if ‘-kk’ is specified, since
     this tends to be more useful when merging changes.

‘o’
     Like ‘-kkv’, but use the old value present in the working file just
     before it was checked in.  This can be useful for file formats that
     cannot tolerate any changes to substrings that happen to take the
     form of keyword strings.

‘b’
     Like ‘-ko’, but do all file i/o in binary mode.  This makes little
     difference on POSIX and Unix hosts, but on DOS-like hosts one
     should use ‘rcs -i -kb’ to initialize an RCS file intended to be
     used for binary files.  Also, on all hosts, rcsmerge normally
     refuses to merge files when ‘-kb’ is in effect.

‘v’
     Generate ‘5.13’ (value only).  Further keyword substitution cannot
     be performed once the keyword names are removed, so this should be
     used with care.  Because of this danger of losing keywords, ‘-kv’
     cannot be combined with ‘-l’, and the owner write permission of the
     working file is turned off; to edit the file later, check it out
     again without ‘-kv’.