File: git-create-branch.md

package info (click to toggle)
git-extras 6.1.0-1
  • links: PTS
  • area: main
  • in suites: bullseye
  • size: 1,720 kB
  • sloc: sh: 3,480; makefile: 126
file content (73 lines) | stat: -rw-r--r-- 2,403 bytes parent folder | download 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
 
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.

<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 &lt;<jw@jonhnnyweslley.net>&gt;
Modified by Mark Pitman &lt;<mark.pitman@gmail.com>&gt;, Brian Murrell &lt;<btmurrell@gmail.com>&gt;.

## REPORTING BUGS

&lt;<https://github.com/tj/git-extras/issues>&gt;

## SEE ALSO

&lt;<https://github.com/tj/git-extras>&gt;