mirror of
https://github.com/tj/git-extras.git
synced 2026-09-10 23:46:24 -04:00
78 lines
2.5 KiB
Markdown
78 lines
2.5 KiB
Markdown
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 `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](#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>>
|