The File Browser can organize the contents of a workspace or stream by AccuRev status, instead of by directory location. (You can also search by element name. See
File Browser: Searching by Element Name on page 61 for details.) When you click one of the items in the Searches pane (e.g.
Kept), the File Browser searches the entire workspace or stream for objects that meet that search criterion, and displays those elements in the Details pane. You can perform commands on these objects, using the toolbars and menus.

File Browser searches enable you to see "just the files you care about", instead of all the files in your workspace. (The AccuRev CLI uses the term "filter" instead of "search".) Which files do you care about? Roughly speaking, a workspace contains a copy of its backing stream -- often, the entire source base -- which might include hundreds or thousands of files. But for a given development project, you'll probably modify only a handful of the files. You may not need the other files at all; or you may need them for general reference, or to enable you to perform software builds and tests in the workspace.
The searches are not mutually exclusive: some objects may be selected by more than one search criterion -- for example,
Kept and
Pending: every object selected by a
Kept search will also appear in the results of a
Pending search.
To perform a search of the entire workspace, dynamic stream, or snapshot on which you opened the File Browser, just click one of the search criteria in the Searches pane. AccuRev performs the search and displays the resulting set of elements in the Details pane.
1.
|
Click the Kept search criterion to search for files with (kept) status in your workspace.
|
2.
|
Click the Overlap search criterion to search for files with (overlap) status in your workspace.
|
Instead of performing another search, the File Browser just displays the results of your previous search for files with
(kept) status. You can refresh the display (with
View > Refresh , the

toolbar button, or function key
F5) to have the File Browser perform the Kept search again, in order to take into account recent changes.
The Search in Selected Folder checkbox at the bottom of the Searches pane enables you to restrict any search to the subtree of the folder that is currently selected in the Navigation pane.

If you check or clear this checkbox when the Details pane already contains the results of a search, AccuRev automatically performs the search again in the restricted (or unrestricted) context. If
Search in Selected Folder is checked, the folder context appears in the Searches pane banner:

If you click the Run in Background button, the progress box is replaced by an indicator in the lower right corner of the GUI window:

(workspace only) Select files whose status includes (modified) but not
(member). These are files that have content changes, but are not in the workspace's default group. They have not been activated with a
Keep or
Anchor command since the file's last update or promotion.
Note: The File->Update Preview menu option now displays this filter rather than the text display generated in previous releases.
Select elements whose status includes (overlap) -- the current version in the parent stream is not an ancestor of this version. This means there might be
content changes or
namespace changes in the parent stream version that are not present in this version.
You must perform a Merge with the parent stream version before you can
Promote your version. If you're in a dynamic stream, you must perform the
Merge in the
Change Palette.
Select elements that satisfy the Overlap search criterion in the current workspace or stream, along with
Overlap elements in the
parent stream, in the
grandparent stream, and so on -- all the way up the depot's stream hierarchy. From the Deep Overlap filter display, you can
merge your changes to resolve the overlap and then
keep the merged file. The Overlap Filter display updates to show the merged element with a
(kept) Member) status, and you can select it and
promote to the backing stream.
Select elements whose status includes (underlap) -- the current version in the parent stream is not an ancestor of this version, but the parent-stream version already contains all the changes of this version. In most cases, you can safely
Revert to Backed your version, so that you'll get the parent-stream version the next time you
Update the workspace (see
Revert to Backed Dialog on page 120). Alternatively, you can perform a
merge, just as with
(overlap)-status elements.
Selects elements that should be present, but aren't. That is, there's a version of the file or directory in the workspace stream, but the file or directory was removed from the
workspace tree by an operating system command or some non-AccuRev program.
Many of the File Browser's searches described above require that AccuRev consider every file in your workspace, even the
external objects that you haven't placed under version control (e.g. editor backup files, files produced by software builds). If your workspace contains many thousands of files, such operations can be time-consuming. AccuRev can use optimizations during a full-workspace search to significantly improve search performance, and to reduce "visual clutter":
The Deep Overlap Optimization checkbox controls whether or not to consider and display elements beyond a time basis stream.

When checked (default), deep overlap elements beyond a time basis stream are not displayed. This improves performance, and also simplifies the display by not showing elements that are not relevant.
1.
|
Click Kept in the Searches pane
|
3.
|
Press Ctrl-A to selects all the elements in the Details pane
|