|Version Management with CVS - the CVS manual|
by Per Cederqvist et al.
Paperback (6"x9"), 216 pages, 8 figures
RRP £19.95 ($29.95)
A.8.1 checkout options
These standard options are supported by
(see section A.5 Common command options, for a complete description of
- Use the most recent revision no later than date. This option is sticky, and implies ‘-P’. See section 4.9 Sticky tags, for more information on sticky tags/dates.
- 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).
Process keywords according to kflag. See
section 12 Keyword substitution.
This option is sticky; future updates of
this file in this working directory will use the same
statuscommand can be viewed to see the sticky options. See section G Quick reference to CVS commands, for more information on the
- Local; run only in current working directory.
- Do not run any checkout program (as specified with the ‘-o’ option in the modules file; see section B.1 The modules file).
- Prune empty directories. See section 7.5 Moving and renaming directories.
- Pipe files to the standard output.
- Checkout directories recursively. This option is on by default.
- Use revision tag. This option is sticky, and implies ‘-P’. See section 4.9 Sticky tags, for more information on sticky tags/dates.
In addition to those, you can use these special command
- Reset any sticky tags, dates, or ‘-k’ options. Does not reset sticky ‘-k’ options on modified files. See section 4.9 Sticky tags, for more information on sticky tags/dates.
- Copy the module file, sorted, to the standard output, instead of creating or modifying any files or directories in your working directory.
- 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.
- 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’. See section 5 Branching and merging.
- 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.
- Like ‘-c’, but include the status of all modules, and sort it by the status string. See section B.1 The modules file, for info about the ‘-s’ option that is used inside the modules file to set the module status.
|ISBN 0954161718||Version Management with CVS - the CVS manual||See the print edition|