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