branch
======

:Purpose: Create a new branch that is a copy of an existing branch.
:Usage:   brz branch FROM_LOCATION [TO_LOCATION]

:Options:
  --bind                Bind new branch to from location.
  -b ARG, --colocated-branch=ARG
                        Name of colocated branch to sprout.
  --files-from=ARG      Get file contents from this tree.
  --hardlink            Hard-link working tree files where possible.
  -h, --help            Show help message.
  --no-recurse-nested   Do not recursively check out nested trees.
  --no-tree             Create a branch without a working-tree.
  -q, --quiet           Only display errors and warnings.
  -r ARG, --revision=ARG
                        See "help revisionspec" for details.
  --stacked             Create a stacked branch referring to the source
                        branch. The new branch will depend on the availability
                        of the source branch for all operations.
  --standalone          Do not use a shared repository, even if available.
  --switch              Switch the checkout in the current directory to the
                        new branch.
  --usage               Show usage message and options.
  --use-existing-dir    By default branch will fail if the target directory
                        exists, but does not already have a control directory.
                        This flag will allow branch to proceed.
  -v, --verbose         Display more information.

:Description:
  If the TO_LOCATION is omitted, the last component of the FROM_LOCATION will
  be used.  In other words, "branch ../foo/bar" will attempt to create ./bar.
  If the FROM_LOCATION has no / or path separator embedded, the TO_LOCATION
  is derived from the FROM_LOCATION by stripping a leading scheme or drive
  identifier, if any. For example, "branch lp:foo-bar" will attempt to
  create ./foo-bar.
  
  To retrieve the branch as of a particular revision, supply the --revision
  parameter, as in "branch foo/bar -r 5".

:See also: :doc:`checkout <checkout-help>`


