NAME

      cover - check out files from a RCS library


SYNOPSIS

      cover [-all] [-i] [-n] [-O] [-tdir] [-ddate] [-f] [-I] [-ksubst]  [-M]
      [-p] [-q] [-rrev] [-sstate] [-T] [-Vn] [-wwho] [-zzone] [file...]


DESCRIPTION

      The command cover checks out RCS files and copies them to the
      corresponding working files. If file is omitted, all files that are
      not up to date are checked out. Otherwise, if file is specified, the
      file is checked out whether it is up to date or not. The updated files
      have readonly access. The command corresponds to the SDE menu command
      Update Working Directory.

      If the specified file version has the state Obsolete, it will not be
      checked unless the -O option is specified.

    PARAMETERS
      file denotes a file to be updated, whether it is up to date or not. A
           wild card naming may be used when specifying files. If no file is
           specified then the command updates all the files which are not up
           to date.

    OPTIONS
      -all Check out all files, also when the file in the working directory
           is up-to-date.

      -i   Ask for each check out.

      -n   Just show the co commands; don't execute them (cf. make -n).

      -O   Checkout even if the version has the state Obsolete.

      -tdir
           Traverse the directory structure starting from directory dir. If
           dir is omitted, the current directory is assumed.

      -ddate
           Retrieves the lates revision on the selected branch whose checkin
           date/time is less than or equal to date. The date and time may be
           given in free format (see co(1)).

      -f   Forces the overwriting of the working file. Otherwise, the
           default is to abort the checkout if a working file with write
           permission exists.

      -I   Interactive mode even if input is not a terminal.

      -ksubst
           Generate keyword strings using the specified keyword
           substitution. See co(1).

      -M   Set the modification time on the new working file to be the date
           of the retrieved revision. Use this option with care; it can
           confuse make(1).

      -p   Prints the retrieved revision on standard output, rather than
           storing it in the working file.

      -q   Do not write a log message on the screen.

      -rrev
           Retrieves the latest revision whose number is less than or equal
           to rev. If rev indicates a branch rather than a revision, the
           latest revision on that branch is retrieved. If rev is omitted,
           the latest revision on the default branch is retrieved. If rev is
           $, checkout determines the revision number from keyword values in
           the working file. Otherwise, a revision is composed of one or
           more numeric or symbolic fields separated by periods.

      -sstate
           Retrieves the latest revision on the selected branch whose state
           is set to state.

      -T   Preserve the modification time on the RCS file.

      -Vn  Emulate RCS version n.

      -wlogin
           Retrieves the latest revision on the selected branch which was
           checked in by the user with login name login. If the login is
           omitted, the caller's login is assumed.

      -zzone
           Specify time zone for -d and keyword substitution.


EXAMPLES

      cover # check out files which are not up to date in the current
      directory

      cover -t2.1-0 # check out files which are not up to date in directory
      2.1-0 and its subdirectories

      cover proj* # check out all proj* files independent of if the files
      are up to date or not

      cover -sStable * # check out the latest revisions of files with status
      Stable in current directory, independent of if the files are up to
      date or not



SEE ALSO

      lsver(1), checkout(1), co(1), checkin(1), ci(1)


AUTHOR

      Stefan Frennemo