CO(1)                      OpenBSD Reference Manual                      CO(1)

NAME
     co - check out RCS revisions

SYNOPSIS
     co [-TV] [-ddate] [-f[rev]] [-I[rev]] [-kmode] [-l[rev]] [-M[rev]]
        [-p[rev]] [-q[rev]] [-r[rev]] [-sstate] [-u[rev]] [-w[user]]
        [-xsuffixes] [-ztz] file ...

DESCRIPTION
     The co program is used to check out revisions from RCS files.

     When a file is checked out, a copy is taken from the RCS repository, mi-
     nus its RCS information, and placed in the current working directory.
     Files may be checked out as the most recent revision or according to a
     specific revision, using the -r option.

     Files are checked out in one of two possible modes: unlocked (the de-
     fault) or locked (using the -l option).  In unlocked mode, any user may
     check out the file for reading.  If changes are to be made to a file
     though, it will have to be locked using the -l option.  During this time,
     no other users may check out the file whilst it is locked.

     co also supports keyword substitution - see the rcs(1) man page for more
     information.

     The following options are supported:

     -ddate  Retrieve revision as of the latest revision no later than date.

     -f[rev]
             Force the overwriting of the working file.

     -I[rev]
             Interactive mode.

     -kmode  Specify the keyword substitution mode.

     -l[rev]
             The same as -r, but also locks the revision.

     -M[rev]
             Set the modification time of the file to the date of the re-
             trieved revision.

     -p[rev]
             Print the latest revision no later than rev to standard output.

     -q[rev]
             Be quiet about reporting.

     -r[rev]
             Retrieve the latest revision no later than rev.

     -sstate
             Retrieve revision of the specified state only.

     -T      Preserve the modification time of RCS files.

     -u[rev]
             The same as -r, but also unlocks the retrieved revision if it was
             locked.

     -V      Print RCS's version number.

     -w[user]
             Retrieve the latest revision which was checked in by the speci-
             fied user.  If the user argument is omitted, the login of the us-
             er issuing the command is assumed.

     -xsuffixes
             Specifies the suffixes for RCS files.  Suffixes should be sepa-
             rated by the `/' character.

     -ztz    Specify the date output format in keyword substitution, and the
             default time zone for date used in the -d option.

     The co utility exits 0 on success, and >0 if an error occurs.

ENVIRONMENT
     RCSINIT  If set, this variable should contain a list of space-delimited
              options that are prepended to the argument list.

EXAMPLES
     Retrieve the latest revision of file foo.c and lock it for further edit-
     ing:

           $ co -l foo.c

     Retrieve revision 1.5 of file foo.c:

           $ co -r1.5 foo.c

SEE ALSO
     ci(1), ident(1), rcs(1), rcsclean(1), rcsdiff(1), rcsmerge(1), rlog(1)

OpenBSD 4.7                      May 31, 2007                                2
