Filter Revisions

When the "Revision Information" tab is selected in the lower pane, QWin will display the revision information associated with the selected files. If the project node is selected, it will display revision information for all the files in the selected project. Using the Filter Revisions feature, it is possible to filter this revision information to a more useful sub-set of information.

You can define and enable revision filters by clicking on the Filter Revisions toolbar button. This will bring up a dialog which allows you to filter revisions by user name, label, date, etc. You can enable as many filters as you like, though some combinations may not make any sense. Any revision that appears in the Revision Information pane must satisfy all the enabled filter conditions. QWin remembers the last used value for a filter so that you can enable and disable a filter without having to redefine its value each time.

Define Revision Filter Dialog

This is the dialog which appears when you click the Filter Revisions toolbar button.

The possible values for filters are:

User Name

The User Name filter can be a single QVCS user name, or a set of QVCS user names, each separated by commas (no white space). Only those revisions created by one of the QVCS users defined in the filter will be displayed.

With Label

The "With Label" filter identifies a single label string that a revision must be a part of in order to be displayed. Revisions not associated with the given label string will not be displayed.

Up to Label

Only revisions labeled with the given label string or created before the labeled revision will be displayed. Revisions created after the given label string will not be displayed.

After Label

Only those revisions that were created after the label was applied will be displayed. Note that if a QVCS archive was created after the label was applied, none of its revisions will show up when using this filter. In this circumstance, it might be better to use the After Date filter.

Before Date

The "Before Date" filter identifies a date in the format defined for the current locale. Only those revisions that were created before that date will be displayed. You can filter a range of dates by using this filter in concert with the After Date filter.

After Date

The "After Date" filter identifies a date in the format defined for the current locale. Only those revisions that were created after that date will be displayed. You can filter a range of dates by using this filter in concert with the Before Date filter.

File Extension

The "File Extension" filter defines the file extension of those work files whose revision information you want to see. The extension should not include the '.' character. You can filter multiple file extensions by adding additional extensions to the filter, separating them by a single comma. For example, to see just those revisions from .h and .cpp files, you would define a filter of "h,cpp" (without the quotes).

Locked By

The "Locked By" filter allows you to show just those revisions that are locked. The filter value can be the * character, in which case the filter shows all locked revisions, regardless of who holds the lock. Alternately, the filter value can be a QVCS user name (or set of user names separated by a single comma) to show just those revisions that are locked by the named user(s).

Containing Text

The "Containing text" filter allows you to show only those revisions that have a revision description containing the text defined in the filter. For example, suppose you establish the practice of prefixing all your bug fix revision descriptions with the words "BUG FIX:". Using the Containing text filter, you can enable the filter, set the filter value to "BUG FIX", and QWin will display only those revisions that contain that text in their revision descriptions -- i.e. all the revisions associated with a bug fix. This filter can also be used to "search" all the revisions for given string. The filter is not sensitive to case -- i.e. "BUG FIX" is the same as "bug fix". The filter will find matching text anywhere in the revision description.

Tip Rev. Only

This filter allows you to show only the tip revision, i.e. the newest revision on a branch, of each of the selected files. This is most useful in the case of multi-file or project-level views, as it lets you see the most recent changes made to the selected files.

Toolbar Operations

Get

Check Out

Add

Check In

Undo Check-out

Lock

Label

File Groups

Sort Revisions

Filter Revisions

Filter Files

Compare