NAME

       git-create-branch - Create branches

SYNOPSIS

DESCRIPTION

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

OPTIONS

       Setup  a  remote  tracking  branch  using remote_name. If remote_name 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   <jw@jonhnnyweslley.net>   Modified   by   Mark   Pitman
       <mark.pitman@gmail.com>, Brian Murrell <btmurrell@gmail.com>.

REPORTING BUGS

       <https://github.com/tj/git-extras/issues>

SEE ALSO

       <https://github.com/tj/git-extras>

                                           October 2022                      GIT-CREATE-BRANCH(1)