view

Purpose:

Manage filtered views.

Usage:

bzr view [FILE...]

Options:

--all	Apply list or delete action to all views.
-v, --verbose	Display more information.
-h, --help	Show help message.
-q, --quiet	Only display errors and warnings.
--name=ARG	Name of the view to define, list or delete.
--switch=ARG	Name of the view to switch to.
--usage	Show usage message and options.
--delete	Delete the view.

Description:

Views provide a mask over the tree so that users can focus on a subset of a tree when doing their work. After creating a view, commands that support a list of files - status, diff, commit, etc - effectively have that list of files implicitly given each time. An explicit list of files can still be given but those files must be within the current view.

In most cases, a view has a short life-span: it is created to make a selected change and is deleted once that change is committed. At other times, you may wish to create one or more named views and switch between them.

To disable the current view without deleting it, you can switch to the pseudo view called off. This can be useful when you need to see the whole tree for an operation or two (e.g. merge) but want to switch back to your view after that.

Examples:

To define the current view:

bzr view file1 dir1 ...

To list the current view:

bzr view

To delete the current view:

bzr view --delete

To disable the current view without deleting it:

bzr view --switch off

To define a named view and switch to it:

bzr view --name view-name file1 dir1 ...

To list a named view:

bzr view --name view-name

To delete a named view:

bzr view --name view-name --delete

To switch to a named view:

bzr view --switch view-name

To list all views defined:

bzr view --all

To delete all views:

bzr view --delete --all