CO(1) | General Commands Manual | CO(1)

# NAME

`co` — check out RCS revisions

# SYNOPSIS

`co` | [`-TV`] [`-d` date] [`-f`[rev]] [`-I`[rev]] [`-k` mode] [`-l`[rev]] [`-M`[rev]] [`-p`[rev]] [`-q`[rev]] [`-r`[rev]] [`-s` state] [`-u`[rev]] [`-w`[user]] [`-x` suffixes] [`-z` tz] 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, minus 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 default) 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:

`-d` date
  Retrieve revision as of the latest revision no later than date.
`-f`[rev]
  Force the overwriting of the working file.
`-I`[rev]
  Interactive mode.
`-k` mode
  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 retrieved 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.
`-s` state
  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 specified user. If the user argument is omitted, the login of the user issuing the command is assumed.
`-x` suffixes
  Specifies the suffixes for RCS files. Suffixes should be separated by the ‘/’ character.
`-z` tz
  Specify the date output format in keyword substitution, and the default time zone for date used in the `-d` option.

# ENVIRONMENT

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

# EXIT STATUS

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

# EXAMPLES

Retrieve the latest revision of file foo.c and lock it for further editing:

`$ 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)

September 3, 2010 | Debian