Man page - git-create-branch(1)

Packages contains this manual

Package:  git-extras
apt-get install git-extras

Manuals in package:
• git-unlock(1)
• git-browse(1)
• git-standup(1)
• git-alias(1)
• git-setup(1)
• git-abort(1)
• git-rename-tag(1)
• git-lock(1)
• git-scp(1)
• git-repl(1)
• git-fresh-branch(1)
• git-touch(1)
• git-delta(1)
• git-force-clone(1)
• git-gh-pages(1)
• git-release(1)
• git-info(1)
• git-delete-squashed-branches(1)
• git-archive-file(1)
• git-get(1)
• git-rebase-patch(1)
• git-delete-tag(1)
• git-clear-soft(1)
• git-count(1)
• git-root(1)
• git-pull-request(1)
• git-local-commits(1)
• git-pr(1)
• git-ignore(1)
• git-cp(1)
• git-show-merged-branches(1)
• git-feature(1)
• git-sed(1)
• git-effort(1)
• git-utimes(1)
• git-show-tree(1)
• git-reauthor(1)
• git-authors(1)
• git-commits-since(1)
• git-changelog(1)
• git-delete-branch(1)
• git-fork(1)
• git-squash(1)
• git-magic(1)
• git-summary(1)
• git-rename-remote(1)
• git-ignore-io(1)
• git-show-unmerged-branches(1)
• git-locked(1)
• git-missing(1)
• git-undo(1)
• git-clear(1)
• git-obliterate(1)
• git-reset-file(1)
• git-guilt(1)
• git-bulk(1)
• git-merge-repo(1)
• git-rename-file(1)
• git-contrib(1)
• git-stamp(1)
• git-extras(1)
• git-delete-merged-branches(1)
• git-browse-ci(1)
• git-merge-into(1)
• git-graft(1)
• git-rename-branch(1)
• git-create-branch(1)
• git-sync(1)
• git-delete-submodule(1)
• git-coauthor(1)
• git-psykorebase(1)
• git-brv(1)
• git-paste(1)
• git-mr(1)
Documentations in package:
• git-extras

Manual

GIT-CREATE-BRANCH

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
PREFERENCES
EXAMPLES
NOTES
AUTHOR
REPORTING BUGS
SEE ALSO

---

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 >

---