(cvs.info.gz) checkout options
Info Catalog
(cvs.info.gz) checkout
(cvs.info.gz) checkout examples
A.9.1 checkout options
----------------------
These standard options are supported by `checkout' ( Common
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'. See Sticky tags, for more
information on sticky tags/dates.
`-f'
Only useful with the `-D' or `-r' flags. If no matching revision
is found, retrieve the most recent revision (instead of ignoring
the file).
`-k KFLAG'
Process keywords according to KFLAG. See Keyword
substitution. 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
Invoking CVS, for more information on the `status' command.
`-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; modules).
`-P'
Prune empty directories. See Moving directories.
`-p'
Pipe files to the standard output.
`-R'
Checkout directories recursively. This option is on by default.
`-r TAG[:DATE]'
Checkout the revision specified by TAG or, when DATE is specified
and TAG is a branch tag, the version from the branch TAG as it
existed on DATE. This option is sticky, and implies `-P'. See
Sticky tags, for more information on sticky tags/dates.
Also, see Common options.
In addition to those, you can use these special command options with
`checkout':
`-A'
Reset any sticky tags, dates, or `-k' options. See Sticky
tags, for more information on sticky tags/dates.
`-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. In general, using this flag is equivalent
to using `mkdir DIR; cd DIR' followed by the checkout command
without the `-d' flag.
There is an important exception, however. It is very convenient
when checking out a single item to have the output appear in a
directory that doesn't contain empty intermediate directories. In
this case _only_, CVS tries to "shorten" pathnames to avoid those
empty directories.
For example, given a module `foo' that contains the file `bar.c',
the command `cvs co -d dir foo' will create directory `dir' and
place `bar.c' inside. Similarly, given a module `bar' which has
subdirectory `baz' wherein there is a file `quux.c', the command
`cvs co -d dir bar/baz' will create directory `dir' and place
`quux.c' inside.
Using the `-N' flag will defeat this behavior. Given the same
module definitions above, `cvs co -N -d dir foo' will create
directories `dir/foo' and place `bar.c' inside, while `cvs co -N -d
dir bar/baz' will create directories `dir/bar/baz' and place
`quux.c' inside.
`-j TAG'
With two `-j' options, merge changes from the revision specified
with the first `-j' option to the revision specified with the
second `j' option, into the working directory.
With one `-j' option, merge changes from the ancestor revision to
the revision specified with the `-j' option, into the working
directory. The ancestor revision is the common ancestor of the
revision which the working directory is based on, and the revision
specified in the `-j' option.
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:
`-jSYMBOLIC_TAG:DATE_SPECIFIER'.
Branching and merging.
`-N'
Only useful together with `-d DIR'. With this option, CVS will
not "shorten" module paths in your working directory when you
check out a single module. See the `-d' flag for examples and a
discussion.
`-s'
Like `-c', but include the status of all modules, and sort it by
the status string. modules, for info about the `-s'
option that is used inside the modules file to set the module
status.
Info Catalog
(cvs.info.gz) checkout
(cvs.info.gz) checkout examples
automatically generated byinfo2html