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 `