3. The File Browser : File Browser: Working in the Searches Pane

File Browser: Working in the Searches Pane
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 65 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.
See also:
AccuRev Element Status on page 89
Using the File Browser's Include/Exclude Mode on page 102
Performing Searches of the Entire Workspace or Stream
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.
You can perform as many searches as you like; the File Browser remembers the results of the most recent search of each kind. So, for example, you might:
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.
3.
Click the Kept search criterion again.
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 cache of search results is maintained until you close the File Browser tab.
Restricting a Search to a Subtree
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:
Search Progress Box
A search can be almost instantaneous or not, depending on the number of elements in the workspace or stream. During a longer search, AccuRev displays a progress box.
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:
The indicator disappears when the search completes.
Search Criteria
The Searches pane contains these search criteria:
Pending
(workspace only) Select elements whose status includes either (modified) or (kept). These are elements that have had a content change or a namespace change.
Modified
(workspace only) Select files whose status includes (modified). This indicates a content change that has not yet been preserved with Keep (but may have followed a previous Keep).
Kept
(workspace only) Select files whose status includes (kept). These are files whose content changes have all been preserved with Keep, or elements with namespace changes (Rename or Defunct command).
Non-member
(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.
Default Group
Select elements whose status includes (member). These are elements in the workspace's default group, for which you've entered one of these commands: Keep, Rename, Defunct, Anchor .
Update Preview
Displays what elements would be affected by an update operation, and enables you to easily select the elements and perform operations on them in advance of the update. By default the following columns are displayed:
·
Element -- (When "Display of element name..." is set to "single column") The depot-relative path of the element in the  workspace, followed by the name of the element as it currently appears in the workspace.
·
Name -- (When "Display of element name..." is set to "separate name and in-folder") The name of the element as it currently  appears in the workspace.
·
·
·
Action -- What will happen to the element if you proceed with the update. Possible values are move, remove, create, overlapped, re-link, replace content, and no such element. For elements with a status of no such element, the only operations that are enabled are History and Properties.
·
·
Note: The File->Update Preview menu option now displays this filter rather than the text display generated in previous releases.
Overlap
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.
Deep Overlap
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.
Underlap
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 128). Alternatively, you can perform a merge, just as with (overlap)-status elements.
Modified in Default Group
(workspace only) Select elements whose status includes both (modified) and (member). This is the intersection of the sets of files selected by the Modified and Default Group search criteria.
External
(workspace only) Select files and directories that exist in the workspace tree, but have never been placed under version control with the Add to Depot command.
Missing
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.
Stranded
Select the elements in the default group that have become stranded. In the Details pane, a stranded element is identified by its element-ID, since it has no pathname in the workspace or stream.
Notes: Example
Here's the most typical scenario for stranding a file in a workspace:
1.
Create a new version of a file with Keep. This places the file element in the workspace's default group.
2.
Remove the file's parent directory with Defunct. With the parent directory gone, there's no pathname in the workspace to the file element.
For more information, see Version Control of Namespace-Related Changes on page 49 in AccuRev Technical Notes.
Defunct
Selects the elements in the default group of a workspace or dynamic stream whose status is (defunct).
Search Optimizations
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":
Deep Overlap Optimization
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.
When unchecked, these  elements are displayed, but with orange highlighting. 
This setting is not saved between GUI sessions.
Operating on Elements Selected by a Search
The set of elements located by a search are displayed in the Details pane. The operations that you can perform on these elements are described in Details Pane Command Reference on page 80.
Notes:
Selecting all objects in the Details pane can be particularly useful after a search. For example, to promote all files that you've saved with Keep:
1.
Click Kept in the Searches pane
2.
3.
Press Ctrl-A to selects all the elements in the Details pane
4.
Invoke the Promote command.
A file can disappear from the Details pane if you change it in a search-related way. For example, after you promote all the files displayed by a Kept search, the files' status changes from (kept) to (backed). Accordingly, the files disappear from the Kept search results.

AccuRev, Inc.
Phone: 781-861-8700
Fax: 781-861-8704
support@accurev.com