extra-git/man/create-branch.txt

Common utility commands for Git repositories.

git-create-branch(1) -- Create branches

SYNOPSIS

git-create-branch [-r|--remote [remote_name]] <branchname>

DESCRIPTION

Creates local branch named <branchname> and optionally sets up a remote tracking branch.

OPTIONS

<-r|--remote [remote_name]>

Setup a remote tracking branch using remotename. If remotename is not supplied, use origin by default.

<--from [start_point]>

Setup a start point when the branch created. If --from is not supplied, use the current branch by default.

<branchname>

The name of the branch to create.

PREFERENCES

You may save your default preference for the remote option above by using git config with the key git-extras.create-branch.remote whose value will be the default remote when [-r|--remote] is not specified.

    $ git config git-extras.create-branch.remote lucinda

The command line option -r|--remote will override this preference.

EXAMPLES

With no remote preference set:

creates local branch 'integration'
    $ git create-branch integration

creates local & remote branch 'integration' (on default 'origin')
    $ git create-branch -r integration

creates local & remote branch 'integration' on 'upstream'
    $ git create-branch -r upstream integration

With git-extras.create-branch.remote preference set to 'lucinda':

creates local & remote branch 'integration' (on preference 'lucinda')
    $ git create-branch integration

overriding preference, using default -r of 'origin'
creates local & remote branch 'integration' on default 'origin'
    $ git create-branch -r integration

overriding preference, using specified -r of 'upstream'
creates local & remote branch 'integration' on 'upstream'
    $ git create-branch -r upstream integration

NOTES

As of 4.4.0, the default behavior has changed. git-create-branch will no longer automatically setup a remote tracking branch unless the -r|-remote option is specified.  See additional note on preference feature in 4.8.0-dev below.

As of 4.8.0-dev, the remote option can be set via git config preference as described in Preferences section.

AUTHOR

Written by Jonhnny Weslley <>
Modified by Mark Pitman <>, Brian Murrell <>.

REPORTING BUGS

<>

SEE ALSO

<>