oracular (1) git-create-branch.1.gz

Provided by: git-extras_7.2.0-1_all bug

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>

                                                    May 2024                                GIT-CREATE-BRANCH(1)