version 1.45, 2005/02/09 16:11:15 |
version 1.46, 2005/02/09 16:34:56 |
|
|
obtain a new revision of the file. |
obtain a new revision of the file. |
The possible keywords are as follows: |
The possible keywords are as follows: |
.Bl -tag -width "RevisionXXX" |
.Bl -tag -width "RevisionXXX" |
.It $Author$ |
.It \&$Author\&$ |
The name of the user who checked in the revision. |
The name of the user who checked in the revision. |
.It $Date$ |
.It \&$Date\&$ |
The date and hour (UTC) the revision was checked in. |
The date and hour (UTC) the revision was checked in. |
.It $Header$ |
.It \&$Header\&$ |
Standard header containing the full pathname of the RCS |
Standard header containing the full pathname of the RCS |
file, the revision number, the date (UTC), the author and the state. |
file, the revision number, the date (UTC), the author and the state. |
.It $Id$ |
.It \&$Id\&$ |
The same content as $Header$ but without the path |
The same content as $Header$ but without the path |
of the RCS file. |
of the RCS file. |
.It $Log$ |
.It \&$Log\&$ |
.It Revision 1.45 2005/02/09 16:11:15 xsa |
|
.It add a KEYWORD SUBSTITUTION section; ok jmc@ jfb@ Joris Vink; |
|
.It |
|
The log message supplied during commit, preceded by a header |
The log message supplied during commit, preceded by a header |
containing the RCS filename, the revision number, the |
containing the RCS filename, the revision number, the |
author, and the date (UTC). |
author, and the date (UTC). |
.It $Name$ |
.It \&$Name\&$ |
The tag name used to check out the file. |
The tag name used to check out the file. |
.It $RCSfile$ |
.It \&$RCSfile\&$ |
The name of the RCS file, but without a path. |
The name of the RCS file, but without a path. |
.It $Revision$ |
.It \&$Revision\&$ |
The revision number assigned to the revision. |
The revision number assigned to the revision. |
.It $Source$ |
.It \&$Source\&$ |
The full pathname of the RCS file. |
The full pathname of the RCS file. |
.It $State$ |
.It \&$State\&$ |
The state assigned to the revision. |
The state assigned to the revision. |
.El |
.El |
.Pp |
.Pp |
Keyword substitution has its disadvantages: sometimes the |
Keyword substitution has its disadvantages: sometimes the |
literal text string $Author$ is wanted inside a file without |
literal text string \&$Author\&$ is wanted inside a file without |
.Nm |
.Nm |
interpreting it as a keyword and expanding it into something like |
interpreting it as a keyword and expanding it into something like |
$Author$. |
\&$Author\&$. |
The |
The |
.Fl k Ar o |
.Fl k Ar o |
option can be used to turn off keyword substitution entirely though. |
option can be used to turn off keyword substitution entirely though. |
|
|
command to avoid displaying the differences between keyword substitutions. |
command to avoid displaying the differences between keyword substitutions. |
.It Fl k Ar kv |
.It Fl k Ar kv |
The default behaviour. |
The default behaviour. |
Keywords are normally substituted i.e. $Revision$ becomes $Revision$. |
Keywords are normally substituted i.e. \&$Revision\&$ becomes $Revision$. |
.It Fl k Ar kvl |
.It Fl k Ar kvl |
Like |
Like |
.Fl k Ar kv , |
.Fl k Ar kv , |
|
|
do not get modified. |
do not get modified. |
.It Fl k Ar v |
.It Fl k Ar v |
Substitue the value of keywords instead of keywords themselves |
Substitue the value of keywords instead of keywords themselves |
e.g. instead of $Revision$, only insert 1.1 and not $Revision$. |
e.g. instead of \&$Revision\&$, only insert 1.1 and not $Revision$. |
This option must be used with care, as it can only be used once. |
This option must be used with care, as it can only be used once. |
It is often used with the |
It is often used with the |
.Ic export |
.Ic export |