DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

(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