OLD | NEW |
| (Empty) |
1 git-new-branch(1) | |
2 ================= | |
3 | |
4 NAME | |
5 ---- | |
6 git-new-branch - | |
7 include::_git-new-branch_desc.helper.txt[] | |
8 | |
9 SYNOPSIS | |
10 -------- | |
11 [verse] | |
12 'git new-branch' <branch_name> | |
13 'git new-branch' --upstream_current <branch_name> | |
14 'git new-branch' --upstream <REF> <branch_name> | |
15 'git new-branch' --lkgr <branch_name> | |
16 | |
17 DESCRIPTION | |
18 ----------- | |
19 | |
20 Creates a new branch. By default the new branch will track the configured | |
21 upstream for the repo (defaults to 'origin/master'). If one of the other options | |
22 is specified, it will track that other ref instead. | |
23 | |
24 Conceptually, each branch in your repo represents one 'Change List (CL)'. If you | |
25 have many independent CLs (i.e. the changes in one do not interact with/depend | |
26 on the changes in another), then you should create them as new branches tracking | |
27 the default upstream (i.e. `git new-branch <branch_name>`). If you have features | |
28 which depend on each other, you should create stacked branches using `git | |
29 new-branch --upstream_current <branch_name>`. | |
30 | |
31 OPTIONS | |
32 ------- | |
33 | |
34 --upstream_current:: | |
35 Set the tracking (upstream) branch to the currently-checked-out branch. | |
36 | |
37 --uptstream <REF>:: | |
38 Set the tracking (upstream) branch to <REF>. <REF> may be a local branch, | |
39 remote branch, or a tag. | |
40 | |
41 --lkgr:: | |
42 Alias for `--upstream lkgr`. | |
43 | |
44 <branch_name>:: | |
45 The name for the new branch. | |
46 | |
47 | |
48 CONFIGURATION VARIABLES | |
49 ----------------------- | |
50 | |
51 depot-tools.upstream | |
52 ~~~~~~~~~~~~~~~~~~~~ | |
53 | |
54 This configures the default 'upstream' for all new branches. If it is unset, it | |
55 defaults to 'origin/master'. This is considered to be the 'root' branch. | |
56 | |
57 EXAMPLE | |
58 ------- | |
59 demo:1[] | |
60 | |
61 1. Note that both branches are cyan because they are currently the same | |
62 'commit' object. See linkgit:git-map-branches[1] for more detail. | |
63 | |
64 include::_aliases.txt[] | |
65 | |
66 ---- | |
67 [alias] | |
68 git nb = new-branch | |
69 git tb = new-branch --upstream_current <1> | |
70 ---- | |
71 <1> mnemonic: tb -> "track branch" | |
72 | |
73 | |
74 SEE ALSO | |
75 -------- | |
76 linkgit:git-rebase-update[1], linkgit:git-reparent-branch[1], | |
77 linkgit:git-rename-branch[1], linkgit:git-upstream-diff[1] | |
78 | |
79 include::_footer.txt[] | |
80 | |
81 // vim: ft=asciidoc: | |
OLD | NEW |