File Groups

File Groups are a useful way to cause QWin to treat files that share the same name (except for their file extensions) as a single unit for version control operations. For example, if you develop code in C++, often when you want to modify a C++ source file, you need also to modify the header file associated with that source file. If you create a C++ file group, and include cpp and h files in that group, whenever you select either a .cpp file or a .h file, QWin will automatically select the other file(s) with the same name. For example, if you select a file called foobar.cpp, QWin will automatically select foobar.h if the file exists.

To enable or disable file group behavior, click the File Groups toolbar button. This will bring up a dialog with which you can modify your file groups settings.

Edit File Groups Dialog

This is the dialog which appears when you click the File Groups toolbar button.

The fields themselves are relatively self-explanatory, though their use may not be.

To create a file group, follow these steps:

• Enter the name that you want to associate with the file group into the "New Group Name" edit box. The name should just be a simple descriptive name that helps you identify the purpose of the group; an appropriate name might be "Delphi Development," or "Visual Basic Development," etc.

• Enter the file extensions that compose the file group into the "New Group Extensions" edit box, separating the file extensions with a single comma character. Make sure that the "New Group Extensions" string has just the extensions in the group, and a single comma to separate each extension ? don't include any spaces in the New Group Extensions string. A sample group for C++ might look like: "h,c,cpp" (without the quote characters).

• Click the "Add Group" button.

To edit an existing file group, simply select the group, edit the extensions which appear in the "New Group Extensions" edit box, and click the "Update Group" button.

To enable the file groups that you define, just enable the "Enable File Groups" check box at the top of the dialog, and click the OK button.

Note that QWin only allows file extensions to exist in one file group at a time. For example, it won't allow you to create a C++ file group that has "c,cpp,h" file extensions, and a C file group that has "c,h" extensions. Since the "c,h" extensions overlap between the two groups, QWin won't allow it.

When file groups are enabled, the File Groups button on the toolbar will appear to be depressed.

Toolbar Operations

Get

Check Out

Add

Check In

Undo Check-out

Lock

Label

File Groups

Sort Revisions

Filter Revisions

Filter Files

Compare