Tutorial: QWin Basics

Creating a QVCS Archive for an Uncontrolled File

In this step, you'll create a QVCS archive for a single work file, thereby adding it to the project.

• Select the "Test Project" in the project tree hierarchy.
• In the file list pane, select one of the files marked as "Not controlled"--SimpleTrigger.cpp, for example. Notice that the Get and Check-out toolbar buttons are disabled, and the Add File button is enabled.
• Click on the Add File toolbar button to bring up the following dialog:

  

• In the "Enter a description for this module" edit box, enter an appropriate description of the file you're adding. For the SampleTrigger.cpp, you might enter "This is source code for a sample trigger program." You can also use this dialog to change certain defaults for the archive you're creating, including the QVCS attributes.
• Click the OK button to go ahead and create a QVCS archive for SampleTrigger.cpp. In the file list pane, you'll notice that both the bitmap for SampleTrigger.cpp and its file status change to indicate that it now has an archive associated with it. If you look at the Revision Information, you'll see a 1.0 revision in the archive with a revision description of "Initial Revision."

Labeling Your QVCS Archives

You now have created QVCS archives for all the .txt files in the QVCS distribution, and for SampleTrigger.cpp. In this next step of the tutorial, you'll add a label to these files so you can easily retrieve them as a single, defined set of file revisions.

• Select the "Test Project" on the project tree control.
• Click on the Apply label toolbar button. The "Label all project files" dialog will appear.

  

• In the "With the Label:" field, enter a label you'd like to associate with these files. QVCS labels are limited to 80 characters in length. A typical label might be "Original QVCS distribution."
• Click the OK button. QWin will apply the label that you defined to the default revision of all the QVCS archives for the current project. In the case of this tutorial, that will be the initial 1.0 revisions of the six files for which you created QVCS archives.
• After QWin completes labeling the archives, the "Label all project files" dialog will disappear. Select any version controlled file in the list of project files. In the Revision Information tab below, you'll see the label you applied above the revision description.

There is one new twist in this exercise: because you had set focus on the project tree control, the toolbar button acted on the project as a whole. If you have a single file selected, or several files selected, the toolbar button will apply to just those selected files. Project-level actions may also "recurse" into project subdirectories if you enable the recursive option, in this case the "Label all children" check box.

In general, when the project tree is selected, toolbar buttons apply at the project level; when a file or several files are selected, toolbar buttons apply only to the selected files.

« Previous - Next »