VCP::Source::cvs - A CVS repository source
vcp cvs:module/... -d ">=2000-11-18 5:26:30" <dest> # All file revs newer than a date/time vcp cvs:module/... -r foo # all files in module and below labelled foo vcp cvs:module/... -r foo: # All revs of files labelled foo and newer, # including files not tagged with foo. vcp cvs:module/... -r 1.1:1.10 # revs 1.1..1.10 vcp cvs:module/... -r 1.1: # revs 1.1 and up ## NOTE: Unlike cvs, vcp requires spaces after option letters.
Source driver enabling
vcp to extract versions form a cvs repository.
This doesn't deal with branches yet (at least not intentionally). That will require a bit of Deep Thought.
The source specification for CVS looks like:
cvsroot is passed to
cvs with the
-d option if provided (
cvsroot is optional if the environment variable
CVSROOT is set) and the filespec and <options> determine what revisions to extract.
filespec may contain trailing wildcards, like
/a/b/... to extract an entire directory tree.
- -b, --bootstrap
-b ... --bootstrap=... -b file1[,file2[, etc.]] --bootstrap=file1[,file2[, etc. ]]
...there is three periods, a Regexp::Shellish wildcard borrowed from
Forces bootstrap mode for an entire export (
-b ...) or for certain files. Filenames may contain wildcards, see Regexp::Shellish for details on what wildcards are accepted.
Controls how the first revision of a file is exported. A bootstrap export contains the entire contents of the first revision in the revision range. This should only be necessary when exporting for the first time.
An incremental export contains a digest of the revision preceding the first revision in the revision range, followed by a delta record between that revision and the first revision in the range. This allows the destination import function to make sure that the incremental export begins where the last export left off.
The default is decided on a per-file basis: if the first revision in the range is revision #.1, the full contents are exported. Otherwise an incremental export is done for that file.
This option is necessary when exporting only more recent revisions from a repository.
Used to set the CVS working directory. VCP::Source::cvs will cd to this directory before calling cvs, and won't initialize a CVS workspace of it's own (normally, VCP::Source::cvs does a "cvs checkout" in a temporary directory).
This is an advanced option that allows you to use a CVS workspace you establish instead of letting vcp create one in a temporary directory somewhere. This is useful if you want to read from a CVS branch or if you want to delete some files or subdirectories in the workspace.
If this option is a relative directory, then it is treated as relative to the current directory.
- -kb, -k b
Pass the -kb option to cvs, forces a binary checkout. This is useful when you want a text file to be checked out with Unix linends, or if you know that some files in the repository are not flagged as binary files and should be.
Falsifies the root of the source tree being extracted; files will appear to have been extracted from some place else in the hierarchy. This can be useful when exporting RevML, the RevML file can be made to insert the files in to a different place in the eventual destination repository than they existed in the source repository.
rev-rootis the file spec up to the first path segment (directory name) containing a wildcard, so
would have a rev-root of
In direct repository-to-repository transfers, this option should not be necessary, the destination filespec overrides it.
-r v_0_001:v_0_002 -r v_0_002:
cvs logas a
-rrevision specification. This corresponds to the
-roption for the rlog command, not either of the
-roptions for the cvs command. Yes, it's confusing, but 'cvs log' calls 'rlog' and passes the options through.
IMPORTANT: When using tags to specify CVS file revisions, it would ordinarily be the case that a number of unwanted revisions would be selected. This is because the behavior of the cvs log command dumps the entire log history for any files that do not contain the tag. VCP captures the histories of such files and ignores all revisions that are older or newer than any files that match the tags.
Be cautious using HEAD as the end of a revision range, this seems to cause the delete actions for files deleted in the last revision to not be noticed. Not sure why.
-dmust be specified.
-d "2000-11-18 5:26:30<="
Passed to 'cvs log' as a
WARNING: if this string doesn't contain a '>' or '<', you're probably doing something wrong, since you're not specifying a range. vcp may warn about this in the future.
-dmust be specified.
CVS has one peculiarity that this driver works around.
If a file does not contain the tag(s) used to select the source files,
cvs log outputs the entire life history of that file. We don't want to capture the entire history of such files, so VCP::Source::cvs goes ignores any revisions before and after the oldest and newest tagged file in the range.
"What we have here is a failure to communicate!" - The warden in Cool Hand Luke
CVS does not try to protect itself from people checking in things that look like snippets of CVS log file: they come out exactly like they went in, confusing the log file parser.
So, if a repository contains messages in the log file that look like the output from some other "cvs log" command, things will likely go awry.
At least one cvs repository out there has multiple revisions of a single file with the same rev number. The second and later revisions with the same rev number are ignored with a warning like "Can't add same revision twice:...".
Barrie Slaymaker <email@example.com>
Copyright (c) 2000, 2001, 2002 Perforce Software, Inc. All rights reserved.
See VCP::License (