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: