GLOBREV
NAME
globrev - deposit a new revision for a set of rcs files.
USAGE
globrev -RCS directory -r revision -log logfile -tous
globrev -h to display the calling sequence
globrev [-+] to go to full-screen mode of operation
DESCRIPTION
globrev is a command used to create a new revision of all the rcs
files in a directory. Unless the -tous parameter is used,only the files with
extensions .ftn,v .ptn,v .f,v .c,v .s,v .cdk,v and .h,v in the target
directory will be considered by globrev. If there exists a working file in the
current directory that corresponds to a rcs file in the rcs target directory,
the working file will be used to create the new revision in the rcs file. If
no working file is found, the latest revision on the trunk of the revision
tree of the rcs file will be used.
PARAMETER DEFINITION
RCS - This key indicates to globrev that the following
argument is the name of the rcs target directory.
directory - Name of the target directory.
-r - This key indicates to globrev that the following
parameter is the revision number to use when depositing
the new revision.
revision - revision number.
-log - This key indicates to globrev that the following
parameter is the name of the file containing the log
message to be used when depositing the new revision.
logfile - name of the file that contains the log message for ci.
-tous - This key indicates to globrev that all the working files
of the current directory are to be used to create new
revisions in the target rcs directory.
EXAMPLE
Suppose we have a working directory with the following contents:
a.ftn b.ftn d.ftn logfile
The .ftn files contain the latest modifications for a set of
subroutines and will be used to create revision number 4.0 in the rcs files of
a directory called MY_RCS. The file named logfile contains the log message
that will be used by ci when depositing the new revision.
The directory MY_RCS contains the following files:
a.ftn,v b.ftn,v c.ftn,v
Entering the command
globrev -RCS MY_RCS -r 4.0 -log logfile
will:
1 - create a list of the files to process from the contents of
the MY_RCS directory (a.ftn, b.ftn and c.ftn).
2 - lock the latest revision on the tree for all the files in
the above list that have a corresponding working file in
the current directory.
(rcs -l MY_RCS/a.ftn,v MY_RCS/b.ftn,v)
3 - do a co (with lock) of the remaining files of the list
given in 1.
(co -l MY_RCS/c.ftn,v)
4 - do a ci, at the specified revision number, of all the files
given in the list. logfile will be used for the log
message.
(ci -r4.0 MY_RCS/a.ftn,v MY_RCS/b.ftn,v MY_RCS/c.ftn,v <
logfile)
After execution, the only remaining file in the current directory will
be d.ftn since there is no MY_RCS/d.ftn,v file.
If we had used the -tous parameter, the d.ftn file would have been
included in the list of files to use thus creating a MY_RCS/d.ftn,v.
AUTHOR
James Caveen - RPN
NOTE
See also ci(1), co(1), rcsintro(1), rcsfile(1), rlog(1), refuse(1)
Latest revision: april 28, 1992