table of contents
STG-BRANCH(1) | StGit Manual | STG-BRANCH(1) |
NAME¶
stg-branch - Branch operations: switch, list, create, rename, delete, ...SYNOPSIS¶
stg branch stg branch <branch> stg branch --list stg branch --create <new-branch> [<committish>] stg branch --clone [<new-branch>] stg branch --rename <old-name> <new-name> stg branch --protect [<branch>] stg branch --unprotect [<branch>] stg branch --delete [--force] <branch> stg branch --description=<description> [<branch>]
DESCRIPTION¶
Create, clone, switch between, rename, or delete development branches within a git repository. stg branchDisplay the name of the current branch.
stg branch <branch>
Switch to the given branch.
OPTIONS¶
-l, --listList each branch in the current repository,
followed by its branch description (if any). The current branch is prefixed
with >. Branches that have been initialized for StGit (with
linkstg:init[]) are prefixed with s. Protected branches are prefixed
with p.
-c, --create
Create (and switch to) a new branch. The new
branch is already initialized as an StGit patch stack, so you do not have to
run linkstg:init[] manually. If you give a committish argument, the new branch
is based there; otherwise, it is based at the current HEAD.
StGit will try to detect the branch off of which the new branch is forked, as
well as the remote repository from which that parent branch is taken (if any),
so that running linkstg:pull[] will automatically pull new commits from the
correct branch. It will warn if it cannot guess the parent branch (e.g. if you
do not specify a branch name as committish).
--clone
Clone the current branch, under the name
<new-branch> if specified, or using the current branch’s name plus
a timestamp.
The description of the new branch is set to tell it is a clone of the current
branch. The parent information of the new branch is copied from the current
branch.
-r, --rename
Rename an existing branch.
-p, --protect
Prevent StGit from modifying a branch —
either the current one, or one named on the command line.
-u, --unprotect
Allow StGit to modify a branch — either
the current one, or one named on the command line. This undoes the effect of
an earlier stg branch --protect command.
--delete
Delete the named branch. If there are any
patches left in the branch, StGit will refuse to delete it unless you give the
--force flag.
A protected branch cannot be deleted; it must be unprotected first (see
--unprotect above).
If you delete the current branch, you are switched to the "master"
branch, if it exists.
-d DESCRIPTION, --description DESCRIPTION
Set the branch description.
--force
Force a delete when the series is not
empty.
STGIT¶
Part of the StGit suite - see linkman:stg[1]03/13/2012 | StGit |