The incldo command supports the ability of AccuRev to include files and directories that are deep in a depot’s directory hierarchy, without having to include lots of other, unwanted elements. For example, suppose a depot contains a
tools subdirectory, which contains a
scripts subdirectory, which contains a
unix subdirectory, which contains two subdirectories,
perl and
python. If you need only the
python subdirectory, not the rest of the
tools subtree, you can enter these commands:
Note: As of Version 4.6, you need not enter the
incldo commands for the
scripts and
unix directories — AccuRev automatically executes the required
incldo commands to “traverse” intermediate directory levels.
Note that incldo includes a directory, but merely for the purpose of providing a path to some data lower in the directory hierarchy.
incldo actually serves to
exclude the entire contents of the specified directory; subsequent
incl commands can override this exclusion for particular files/directories under it.
To clarify the preceding paragraph, here’s an example. Suppose directory widget contains subdirectories
devel,
test, and
support. The command “incldo widget”:
Keep in mind the relationship between the update level of the workspace you’re modifying with incldo (or the basis time of the stream you’re modifying). For example, a subsequent “incl devel” command will succeed only if subdirectory
devel existed in directory
widget at the time of the workspace’s most recent update.
Include just the top-level readme.txt file and the
online subdirectory from the hierarchy
widget\support\documentation\online: