NAME

       hg branch - set or show the current branch name

SYNOPSIS

       hg branch [-fC] [NAME]

DESCRIPTION

       Note   Branch  names  are  permanent  and global. Use hg bookmark to create a light-weight
              bookmark instead. See hg help glossary for more information  about  named  branches
              and bookmarks.

       With  no  argument,  show  the  current  branch  name.  With one argument, set the working
       directory branch name (the branch will not exist in the repository until the next commit).
       Standard practice recommends that primary development take place on the 'default' branch.

       Unless  -f/--force  is  specified,  branch will not let you set a branch name that already
       exists.

       Use -C/--clean to reset the working directory branch to that of the parent of the  working
       directory, negating a previous branch change.

       Use the command hg update to switch to an existing branch. Use hg commit --close-branch to
       mark this branch head as closed.  When all heads of a branch are closed, the  branch  will
       be considered closed.

       Returns 0 on success.

OPTIONS

       -f, --force
              set branch name even if it shadows an existing branch

       -C, --clean
              reset branch name to parent branch name

       -r,--rev <VALUE[+]>
              change branches of the given revs (EXPERIMENTAL)

              [+] marked option can be specified multiple times

                                                                                       HG(BRANCH)