By default, a workspace contains a copy of each file under version control in a particular depot. (More precisely, a workspace contains a copy of each version in a particular stream.) But sometimes, you don't want or need a copy of every file -- for example, if your current assignment doesn't include "rebuilding the world" each night. The depot might contain many thousands of files, of which you might need only a small subset. The File Browser's
Include/Exclude facility enables you to define and work with a subset of the depot's elements.
When you check (or clear) the Include/Exclude Mode checkbox, the File Browser immediately switches into (or out of) Include/Exclude mode. (There's no
Ok button to press.)
In Include/Exclude mode, both the Folders and Details panes show all elements in the workspace or stream. Elements that are currently excluded have
(backed)(excluded) indicators in the Status column. For example, if top-level directory
doc is excluded, the File Browser still shows it in both the Folders and Details panes:

You can navigate into an excluded directory. Its elements have (missing)(excluded) status, except for those that are
stranded, which have
(member)(excluded) status.

The File Browser gets a new pane, the rules pane, in Include/Exclude mode. This pane shows include and exclude rules that affect the current workspace or stream:
·
If the Show Inherited Rules checkbox is cleared, only the rules that were explicitly set for the current workspace are listed.
·
If the Show Inherited Rules checkbox is checked, the listing also includes rules inherited from higher-level streams. The
Set in Stream column indicates which higher-level stream.

In Include/Exclude mode, the Details pane toolbar changes: most of the buttons for AccuRev's version-control commands -- Keep ,
Promote ,
Merge , etc.-- disappear. Instead, buttons for the several
Include/Exclude commands appear. A few of the standard toolbar buttons remain, to aid you in navigating the depot and determining element history.
In each depot, there is one hard-coded base rule: the depot's base stream has an include rule that specifies the depot's top-level (root) directory. This rule makes the depot's entire directory hierarchy visible in the depot's base stream.

Any number of rules can be added. Each rule applies to a particular pathname within the depot's directory hierarchy ("Element"), and applies at a particular level in the depot's stream hierarchy ("Set in Stream"). A rule set in a dynamic stream gets inherited by lower-level streams; but a rule for the same element in a lower-level stream or workspace overrides a rule in a higher-level stream.
1.
Make sure that your File Browser tab is displaying the stream or workspace in which the rule was explicitly set (Set In Stream column). If necessary, open a new File Browser on that stream or workspace.
2.
Right-click the rule, and select Clear Rule from the context menu.

When you remove a rule from a stream, the effect is immediate on the stream itself and on streams below it. The effect does not take place on workspaces below the stream until they are Update'd.
When you remove a rule from a workspace, the effect is immediate on the workspace itself: files are copied into the workspace tree if you remove an exclude rule; files are deleted from the workspace tree if you remove an include rule.
·
not displaying elements that have been excluded from the current workspace or stream
A depot contains a tools subdirectory, which contains a
src subdirectory, which contain a
scripts subdirectory, which contains two subdirectories,
perl and
python. If you need only the
python subdirectory, not the rest of the tools subtree, use these commands:
•
|
Invoke Include Directory Only on tools
|
Establish a cross-link, making the selected element(s) appear in the workspace or stream. Instead of inheriting versions of the element(s) from the backing stream (as with the
Include command), inherit the versions from the stream you specify in the Basis Stream dialog.

·
|
The Refresh button contacts the AccuRev Server to refresh the list of streams shown.
|
·
|
The Snapshots Only checkbox restricts the streams shown to snapshot streams only. This setting (as well as the sort order of the columns in the dialog) is stored as a preference.
|
·
|
The Name Filter field filters the streams shown using the text you enter in the field. If the stream name contains the text entered in this field, the stream appears. Otherwise, it is filtered out and does not appear.
|