qrecurse (QVCS-Pro Only)
If you have QVCS-Pro, you can use the qrecurse utility to make other command line utilities recursive--i.e., qrecurse allows the specified command to act within all subdirectories of the current directory as well as the current directory itself. This is the command line equivalent of QWin's recurse files option available for the file list pane.
A qrecurse command should be used from the workfile directory that will serve as the 'root' of the directories that it will traverse.
Note that if you need to use any command line options that include spaces, you need to escape the quote character in order for the command line to be passed correctly. See the qget and qput examples below.
Command Template
qrecurse {-worktree|-archivetree} <<QVCS command>>
*One of the options enclosed in {} must be specified.
where:
-worktree (cannot be used with -archivetree)
Indicates that QVCS should use the existing work file directory hierarchy to navigate through subdirectories.
-archivetree (cannot be used with -worktree)
Indicates that QVCS should use the archive file directory hierarchy to navigate through subdirectories. When using the -archivetree option, qrecurse will guarantee that the associated workfile directory gets created as qrecurse traverses the archive file directories.
<<QVCS command>> (required)
The QVCS command line utility that you wish to behave recursively. You can include both the command name and all its associated switches here.
Examples
qrecurse -archivetree qlog -l *
shows the filenames and user ID's of all locked revisions in QVCS archives accessible from the current directory and any of its subdirectories. This would be a simple way on the command line to show all the locked revisions within a project.
qrecurse -archivetree qget -label \"Label String\" *.*
If your current directory is the root directory of the workfile hierarchy, this will get all the files of the project that have the label "Label String."
qrecurse -worktree qput -create -comment \"Added by command line\" *.cpp
creates archives for all the .cpp files within the current directory tree.
Command Line Utilities
| 
