Tutorial: QWin Basics

Checking in a file

In the previous step, you added three QVCS keywords to readme.txt. In this step, you'll check in readme.txt and then look at the readme.txt work file to see how QVCS transformed these keywords into more useful information.

Select readme.txt in the file list pane. If you refresh the display, you'll notice that its file status has changed to "Your copy changed" and that the accompanying icon is now a lock with a delta superimposed on it.
Click on the Check In File toolbar button (or right click on the file and select Check In...). The following dialog will appear:
Enter some suitable revision description in the "Description of changes" edit box. "Added some keywords," for example.
Click the OK button to proceed with the check-in and store the new revision in the associated QVCS archive.
Notice that your name disappears from the "Locked By" column, since you no longer hold a lock on readme.txt's archive. The file status also changes to "Current."
Double click on readme.txt to look at the contents of readme.txt. (Note that it will now be read-only).
Notice that the $Date$ keyword expanded to show the edit date of readme.txt, that $Filename$ expanded to show the full path of the readme.txt work file, and that $Log3$ expanded to show both the module description, and your revision comments. The format for the expanded $Date$ keyword depends on the Windows formatting preferences that you have defined for your workstation.

Changing the Copyright Message

In the previous step, you may have noticed that the $Copyright$ keyword expanded to read "Insert your copyright information here," rather than containing any particular copyright message.

To change the copyright message that QVCS uses when expanding the $Copyright$ keyword, select the "QVCS Projects" node in the project tree pane of the window. Then select the Project→Edit Settings... menu command. On the resulting dialog, enter your own copyright message into the "Expanded copyright keyword string" edit box located on the Settings tab. Then click the OK button.

QVCS automatically deduces the year range of the copyright claim based on the oldest and newest revision date within the archive file.

The change you make in the copyright message will take effect the next time you start QWin. So...

Exit and re-start QWin.
Select the "Test Project" project.
Select readme.txt in the file list.
Click on the Get File toolbar button, and click OK on the Get File dialog.
After QWin has retrieved the copy of readme.txt, double click on readme.txt to launch notepad. Notice that the $Copyright$ keyword has now expanded to the alternate copyright message that you entered above. Close readme.txt without making any changes.

« Previous - Next »