Fossil Forum

Help: branch

Help: branch

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.


Do not commit changes, but dump artifact to stdout
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.


List all branches. Default show only open branches
List closed branches
List branches merged into the current branch
List branches not merged into the current branch
List only private branches
Reverse the sort order
Show recently changed branches first
List only branches where you participate
--username USER
List only branches where USER participate
--users N
List up to N users partipiating

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.


Branch is private (i.e., remains local)
--bgcolor COLOR
Use COLOR instead of automatic background
Do not sign contents on this branch
--date-override DATE
DATE to use instead of 'now'
--user-override USER
USER to use instead of the current default

DATE may be "now" or "YYYY-MM-DDTHH:MM:SS.SSS". If in year-month-day form, it may be truncated, the "T" may be replaced by a space, and it may also name a timezone offset from UTC as "-HH:MM" (westward) or "+HH:MM" (eastward). Either no timezone suffix or "Z" means UTC.


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