Fossil

Help: branch
Login

The "branch" command:

Usage: fossil branch SUBCOMMAND ... ?OPTIONS?

Run various subcommands to manage branches of the open repository or of the repository identified by the -R or --repository option.

fossil branch close|reopen ?OPTIONS? BRANCH-NAME ?...BRANCH-NAMES?

Adds or cancels the "closed" tag to one or more branches. It accepts arbitrary unambiguous symbolic names but will only resolve check-in names and skips any which resolve to non-leaf check-ins.

Options:

-n|--dry-run
Do not commit changes, but dump artifact to stdout
-v|--verbose
Output more information
--date-override DATE
DATE to use instead of 'now'
--user-override USER
USER to use instead of the current default

fossil branch current

Print the name of the branch for the current check-out

fossil branch hide|unhide ?OPTIONS? BRANCH-NAME ?...BRANCH-NAMES?

Adds or cancels the "hidden" tag for the specified branches or or check-in IDs. Accepts the same options as the close subcommand.

fossil branch info BRANCH-NAME

Print information about a branch

fossil branch list|ls ?OPTIONS? ?GLOB?
fossil branch lsh ?OPTIONS? ?LIMIT?

List all branches.

Options:

-a|--all
List all branches. Default show only open branches
-c|--closed
List closed branches
-m|--merged
List branches merged into the current branch
-M|--unmerged
List branches not merged into the current branch
-p
List only private branches
-r
Reverse the sort order
-t
Show recently changed branches first
--self
List only branches where you participate
--username USER
List only branches where USER participates
--users N
List up to N users participating

The current branch is marked with an asterisk. Private branches are marked with a hash sign.

If GLOB is given, show only branches matching the pattern.

The "lsh" variant of this subcommand shows recently changed branches, and accepts an optional LIMIT argument (defaults to 5) to cap output, but no GLOB argument. All other options are supported, with -t being an implied no-op.

fossil branch new BRANCH-NAME BASIS ?OPTIONS?

Create a new branch BRANCH-NAME off of check-in BASIS.

This command is available for people who want to create a branch in advance. But the use of this command is discouraged. The preferred idiom in Fossil is to create new branches at the point of need, using the "--branch NAME" option to the "fossil commit" command.

Options:

--private
Branch is private (i.e., remains local)
--bgcolor COLOR
Use COLOR instead of automatic background
--nosign
Do not sign the manifest for the check-in that creates this branch
--nosync
Do not auto-sync prior to creating the branch
--date-override DATE
DATE to use instead of 'now'
--user-override USER
USER to use instead of the current default

Options:

-R|--repository REPO
Run commands on repository REPO