MPE/iX Shell and Utilities Reference Manual, Vol 1

co(1) MPE/iX Shell and Utilities co(1)
NAME
co — check out a file under RCS
SYNOPSIS
co [–ddate][–f[rev]] [–Ffile...][–G][–g][–h][–I][–jjoinlist][–K][–k]
[–l[rev]] [–O][–p[rev]] [–q[rev]] [–r[rev]] [–sstate][–u[rev]] [–w[author]]
[–x][–Yfile] file ...
DESCRIPTION
Note: The
MPE/iX implementation of this utility does not function exactly as this man page
describes. For details, see the MPE/iX NOTES section at the end of this man page.
co checks out the most recent revision of a file from the corresponding
RCS file and makes it
available in a working file.
Revisions from an RCS file may be checked out locked or unlocked. Locking a revision pre-
vents overlapping updates. A revision checked out for reading or processing (that is, compil-
ing) need not be locked. A revision checked out for editing should usually be locked, to pre-
vent someone else from editing the file at the same time. If you try to check out a revision and
lock it, the operation fails if the revision is already locked by another user. (A lock may be
broken with the rcs(1) command if you insist.)
To use co with locking, you must be on the access list of the
RCS file, unless you are the owner
of the file, you are the system administrator, or the access list is empty. co without locking is
not subject to access list restrictions, and is not affected by the presence of locks.
Revisions may be selected for check-out according to revision number, branch number,
check-in date/time, author, or state. This is done by putting options after the co command.
When two or more options are specified in combination, co retrieves the latest revision that
satisfies all of them. If no options are specified, co retrieves the latest revision on the default
branch (normally the trunk; see the –b option of rcs(1)). A revision or branch number may
be attached to any of the options –f, –l, –p, –q, –r,or–u. The options –ddate, –sstate,
and –wauthor retrieve a revision with particular identification fields from the default branch
or the branch specified by one of –f, –l, –p, –q, –r,or–u.
A co command applied to an
RCS file with no revisions creates a zero-length working file.
co suppresses keyword expansion unless the configuration file specifies KeywordExpand.
If you specify the –k or –K options, keyword expansion is suppressed in any case.
You do not need to specify whether the RCS file is compressed when checking out a revision.
For all commands, RCS automatically determines whether or not the file is compressed; in
either case, the checked-out working file is not compressed.
Commands and Utilities 1-109