Tutorial: QWin Basics

Checking Out a File

In this step, you'll check out a file and change its "Expand Keywords" attribute.

• Select the "Test Project" project in the tree control.
• In the file list pane, you should see the six files for which you created QVCS archives. Select the file readme.txt.
• Click on the Check-out File toolbar button. This will bring up the following dialog:

  

• Click the OK button to go ahead with the check-out of the default revision.
• Notice that the symbol next to readme.txt has changed to show a , that your QVCS user name appears in the "Locked By" column, and that the directory location of the readme.txt work file is shown in the "Workfile In" column.

  

• Before going to the next step, you need to modify the QVCS archive attributes associated with readme.txt's QVCS archive. Right click on readme.txt and select Modify Archive→Attributes... from the context menu. This will bring up the following dialog:

  

  Enable keyword expansion by making sure the "Expand Keywords" check box is checked. Don't change any of the other settings. Click OK.

Editing a File to Add Keywords

In the previous step, you checked out readme.txt. In this step, you'll edit readme.txt to add several QVCS keywords. Keywords allow you to imbed version control information within the work file itself. In a text file, you add them in their short form, and then QVCS will edit them to add or update the appropriate information when it updates the work file. QVCS supports over 10 different keywords.

• Select readme.txt in the file list. Double click on readme.txt (or right click on readme.txt and select the View menu option). This will launch Notepad (or whatever tool you have associated with .txt files).
• At the top of the file, you'll see two lines that include version information, and copyright information.
• Beneath these two lines, add the following three lines (make sure to get the capitalization right):
  $Date$
$Filename$
$Log3$
• Save your edits, and exit your editor.

In the next step, you'll check in these edits and look at the work file again to see how it changed when the keywords expanded.

« Previous - Next »