view ==== :Purpose: Manage filtered views. :Usage: brz view [FILE...] :Options: --all Apply list or delete action to all views. --delete Delete the view. -h, --help Show help message. --name=ARG Name of the view to define, list or delete. -q, --quiet Only display errors and warnings. --switch=ARG Name of the view to switch to. --usage Show usage message and options. -v, --verbose Display more information. :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:: brz view file1 dir1 ... To list the current view:: brz view To delete the current view:: brz view --delete To disable the current view without deleting it:: brz view --switch off To define a named view and switch to it:: brz view --name view-name file1 dir1 ... To list a named view:: brz view --name view-name To delete a named view:: brz view --name view-name --delete To switch to a named view:: brz view --switch view-name To list all views defined:: brz view --all To delete all views:: brz view --delete --all