Go to the previous, next section.

checkout options

These standard options are supported by checkout (see section Common command options, for a complete description of them):

-D date
Use the most recent revision no later than date. This option is sticky, and implies `-P'.

-f
Only useful with the `-D date' or `-r tag' flags. If no matching revision is found, retrieve the most recent revision (instead of ignoring the file).

-k kflag
Process RCS keywords according to kflag. See co(1). This option is sticky; future updates of this file in this working directory will use the same kflag. The status command can be viewed to see the sticky options. See section status--Status info on the revisions.

-l
Local; run only in current working directory.

-n
Do not run any checkout program (as specified with the `-o' option in the modules file; see section The modules file).

-P
Prune empty directories.

-p
Pipe files to the standard output.

-Q
Really quiet.

-q
Somewhat quiet.

-r tag
Use revision tag. This option is sticky, and implies `-P'.

In addition to those, you can use these special command options with checkout:

-A
Reset any sticky tags, dates, or `-k' options. (If you get a working file using one of the `-r', `-D', or `-k' options, CVS remembers the corresponding tag, date, or kflag and continues using it for future updates; use the `-A' option to make CVS forget these specifications, and retrieve the `head' revision of the file).

-c
Copy the module file, sorted, to the standard output, instead of creating or modifying any files or directories in your working directory.

-d dir
Create a directory called dir for the working files, instead of using the module name. Unless you also use `-N', the paths created under dir will be as short as possible.

-j tag
Merge the changes made between the resulting revision and the revision that it is based on (e.g., if tag refers to a branch, CVS will merge all changes made on that branch into your working file).

With two `-j tag' options, CVS will merge in the changes between the two respective revisions. This can be used to undo changes made between two revisions (see section Merging differences between any two revisions) in your working copy, or to move changes between different branches.

In addition, each -j option can contain an optional date specification which, when used with branches, can limit the chosen revision to one within a specific date. An optional date is specified by adding a colon (:) to the tag. An example might be what import tells you to do when you have just imported sources that have conflicts with local changes:

$ cvs checkout -jTAG:yesterday -jTAG module

-N
Only useful together with `-d dir'. With this option, CVS will not shorten module paths in your working directory. (Normally, CVS shortens paths as much as possible when you specify an explicit target directory).

-s
Like `-c', but include the status of all modules, and sort it by the status string. See section The modules file, for info about the `-s' option that is used inside the modules file to set the module status.

Go to the previous, next section.