git-branch.html - external/gitster/git-htmldocs - Git at Google

 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
  "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
 <meta name="generator" content="AsciiDoc 8.2.5" />
 <style type="text/css">
 /* Debug borders */
 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
 /*
  border: 1px solid red;
 */
 }

 body {
  margin: 1em 5% 1em 5%;
 }

 a {
  color: blue;
  text-decoration: underline;
 }
 a:visited {
  color: fuchsia;
 }

 em {
  font-style: italic;
 }

 strong {
  font-weight: bold;
 }

 tt {
  color: navy;
 }

 h1, h2, h3, h4, h5, h6 {
  color: #527bbd;
  font-family: sans-serif;
  margin-top: 1.2em;
  margin-bottom: 0.5em;
  line-height: 1.3;
 }

 h1, h2, h3 {
  border-bottom: 2px solid silver;
 }
 h2 {
  padding-top: 0.5em;
 }
 h3 {
  float: left;
 }
 h3 + * {
  clear: left;
 }

 div.sectionbody {
  font-family: serif;
  margin-left: 0;
 }

 hr {
  border: 1px solid silver;
 }

 p {
  margin-top: 0.5em;
  margin-bottom: 0.5em;
 }

 pre {
  padding: 0;
  margin: 0;
 }

 span#author {
  color: #527bbd;
  font-family: sans-serif;
  font-weight: bold;
  font-size: 1.1em;
 }
 span#email {
 }
 span#revision {
  font-family: sans-serif;
 }

 div#footer {
  font-family: sans-serif;
  font-size: small;
  border-top: 2px solid silver;
  padding-top: 0.5em;
  margin-top: 4.0em;
 }
 div#footer-text {
  float: left;
  padding-bottom: 0.5em;
 }
 div#footer-badges {
  float: right;
  padding-bottom: 0.5em;
 }

 div#preamble,
 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
 div.admonitionblock {
  margin-right: 10%;
  margin-top: 1.5em;
  margin-bottom: 1.5em;
 }
 div.admonitionblock {
  margin-top: 2.5em;
  margin-bottom: 2.5em;
 }

 div.content { /* Block element content. */
  padding: 0;
 }

 /* Block element titles. */
 div.title, caption.title {
  font-family: sans-serif;
  font-weight: bold;
  text-align: left;
  margin-top: 1.0em;
  margin-bottom: 0.5em;
 }
 div.title + * {
  margin-top: 0;
 }

 td div.title:first-child {
  margin-top: 0.0em;
 }
 div.content div.title:first-child {
  margin-top: 0.0em;
 }
 div.content + div.title {
  margin-top: 0.0em;
 }

 div.sidebarblock > div.content {
  background: #ffffee;
  border: 1px solid silver;
  padding: 0.5em;
 }

 div.listingblock {
  margin-right: 0%;
 }
 div.listingblock > div.content {
  border: 1px solid silver;
  background: #f4f4f4;
  padding: 0.5em;
 }

 div.quoteblock > div.content {
  padding-left: 2.0em;
 }

 div.attribution {
  text-align: right;
 }
 div.verseblock + div.attribution {
  text-align: left;
 }

 div.admonitionblock .icon {
  vertical-align: top;
  font-size: 1.1em;
  font-weight: bold;
  text-decoration: underline;
  color: #527bbd;
  padding-right: 0.5em;
 }
 div.admonitionblock td.content {
  padding-left: 0.5em;
  border-left: 2px solid silver;
 }

 div.exampleblock > div.content {
  border-left: 2px solid silver;
  padding: 0.5em;
 }

 div.verseblock div.content {
  white-space: pre;
 }

 div.imageblock div.content { padding-left: 0; }
 div.imageblock img { border: 1px solid silver; }
 span.image img { border-style: none; }

 dl {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
 }
 dt {
  margin-top: 0.5em;
  margin-bottom: 0;
  font-style: italic;
 }
 dd > *:first-child {
  margin-top: 0;
 }

 ul, ol {
  list-style-position: outside;
 }
 div.olist2 ol {
  list-style-type: lower-alpha;
 }

 div.tableblock > table {
  border: 3px solid #527bbd;
 }
 thead {
  font-family: sans-serif;
  font-weight: bold;
 }
 tfoot {
  font-weight: bold;
 }

 div.hlist {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
 }
 div.hlist td {
  padding-bottom: 5px;
 }
 td.hlist1 {
  vertical-align: top;
  font-style: italic;
  padding-right: 0.8em;
 }
 td.hlist2 {
  vertical-align: top;
 }

 @media print {
  div#footer-badges { display: none; }
 }

 div#toctitle {
  color: #527bbd;
  font-family: sans-serif;
  font-size: 1.1em;
  font-weight: bold;
  margin-top: 1.0em;
  margin-bottom: 0.1em;
 }

 div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
  margin-top: 0;
  margin-bottom: 0;
 }
 div.toclevel2 {
  margin-left: 2em;
  font-size: 0.9em;
 }
 div.toclevel3 {
  margin-left: 4em;
  font-size: 0.9em;
 }
 div.toclevel4 {
  margin-left: 6em;
  font-size: 0.9em;
 }
 include1::./stylesheets/xhtml11-manpage.css[]
 /* Workarounds for IE6's broken and incomplete CSS2. */

 div.sidebar-content {
  background: #ffffee;
  border: 1px solid silver;
  padding: 0.5em;
 }
 div.sidebar-title, div.image-title {
  font-family: sans-serif;
  font-weight: bold;
  margin-top: 0.0em;
  margin-bottom: 0.5em;
 }

 div.listingblock div.content {
  border: 1px solid silver;
  background: #f4f4f4;
  padding: 0.5em;
 }

 div.quoteblock-content {
  padding-left: 2.0em;
 }

 div.exampleblock-content {
  border-left: 2px solid silver;
  padding-left: 0.5em;
 }

 /* IE6 sets dynamically generated links as visited. */
 div#toc a:visited { color: blue; }
 </style>
 <title>git-branch(1)</title>
 </head>
 <body>
 <div id="header">
 <h1>
 git-branch(1) Manual Page
 </h1>
 <h2>NAME</h2>
 <div class="sectionbody">
 <p>git-branch -
  List, create, or delete branches
 </p>
 </div>
 </div>
 <h2>SYNOPSIS</h2>
 <div class="sectionbody">
 <div class="verseblock">
 <div class="content"><em>git branch</em> [--color | --no-color] [-r | -a] [--merged | --no-merged]
  [-v [--abbrev=&lt;length&gt; | --no-abbrev]]
  [--contains &lt;commit&gt;]
 <em>git branch</em> [--track | --no-track] [-l] [-f] &lt;branchname&gt; [&lt;start-point&gt;]
 <em>git branch</em> (-m | -M) [&lt;oldbranch&gt;] &lt;newbranch&gt;
 <em>git branch</em> (-d | -D) [-r] &lt;branchname&gt;&#8230;</div></div>
 </div>
 <h2 id="_description">DESCRIPTION</h2>
 <div class="sectionbody">
 <div class="para"><p>With no arguments given a list of existing branches
 will be shown, the current branch will be highlighted with an asterisk.
 Option <tt>-r</tt> causes the remote-tracking branches to be listed,
 and option <tt>-a</tt> shows both.
 With <tt>--contains &lt;commit&gt;</tt>, shows only the branches that
 contains the named commit (in other words, the branches whose
 tip commits are descendant of the named commit).
 With <tt>--merged</tt>, only branches merged into HEAD will be listed, and
 with <tt>--no-merged</tt> only branches not merged into HEAD will be listed.</p></div>
 <div class="para"><p>In its second form, a new branch named &lt;branchname&gt; will be created.
 It will start out with a head equal to the one given as &lt;start-point&gt;.
 If no &lt;start-point&gt; is given, the branch will be created with a head
 equal to that of the currently checked out branch.</p></div>
 <div class="para"><p>Note that this will create the new branch, but it will not switch the
 working tree to it; use "git checkout &lt;newbranch&gt;" to switch to the
 new branch.</p></div>
 <div class="para"><p>When a local branch is started off a remote branch, git sets up the
 branch so that <em>git-pull</em> will appropriately merge from
 the remote branch. This behavior may be changed via the global
 <tt>branch.autosetupmerge</tt> configuration flag. That setting can be
 overridden by using the <tt>--track</tt> and <tt>--no-track</tt> options.</p></div>
 <div class="para"><p>With a <em>-m</em> or <em>-M</em> option, &lt;oldbranch&gt; will be renamed to &lt;newbranch&gt;.
 If &lt;oldbranch&gt; had a corresponding reflog, it is renamed to match
 &lt;newbranch&gt;, and a reflog entry is created to remember the branch
 renaming. If &lt;newbranch&gt; exists, -M must be used to force the rename
 to happen.</p></div>
 <div class="para"><p>With a <tt>-d</tt> or <tt>-D</tt> option, <tt>&lt;branchname&gt;</tt> will be deleted. You may
 specify more than one branch for deletion. If the branch currently
 has a reflog then the reflog will also be deleted.</p></div>
 <div class="para"><p>Use -r together with -d to delete remote-tracking branches. Note, that it
 only makes sense to delete remote-tracking branches if they no longer exist
 in remote repository or if <em>git-fetch</em> was configured not to fetch
 them again. See also <em>prune</em> subcommand of <a href="git-remote.html">git-remote(1)</a> for way to
 clean up all obsolete remote-tracking branches.</p></div>
 </div>
 <h2 id="_options">OPTIONS</h2>
 <div class="sectionbody">
 <div class="vlist"><dl>
 <dt>
 -d
 </dt>
 <dd>
 <p>
  Delete a branch. The branch must be fully merged in HEAD.
 </p>
 </dd>
 <dt>
 -D
 </dt>
 <dd>
 <p>
  Delete a branch irrespective of its merged status.
 </p>
 </dd>
 <dt>
 -l
 </dt>
 <dd>
 <p>
  Create the branch's reflog. This activates recording of
  all changes made to the branch ref, enabling use of date
  based sha1 expressions such as "&lt;branchname&gt;@{yesterday}".
 </p>
 </dd>
 <dt>
 -f
 </dt>
 <dd>
 <p>
  Force the creation of a new branch even if it means deleting
  a branch that already exists with the same name.
 </p>
 </dd>
 <dt>
 -m
 </dt>
 <dd>
 <p>
  Move/rename a branch and the corresponding reflog.
 </p>
 </dd>
 <dt>
 -M
 </dt>
 <dd>
 <p>
  Move/rename a branch even if the new branchname already exists.
 </p>
 </dd>
 <dt>
 --color
 </dt>
 <dd>
 <p>
  Color branches to highlight current, local, and remote branches.
 </p>
 </dd>
 <dt>
 --no-color
 </dt>
 <dd>
 <p>
  Turn off branch colors, even when the configuration file gives the
  default to color output.
 </p>
 </dd>
 <dt>
 -r
 </dt>
 <dd>
 <p>
  List or delete (if used with -d) the remote-tracking branches.
 </p>
 </dd>
 <dt>
 -a
 </dt>
 <dd>
 <p>
  List both remote-tracking branches and local branches.
 </p>
 </dd>
 <dt>
 -v
 </dt>
 <dt>
 --verbose
 </dt>
 <dd>
 <p>
  Show sha1 and commit subject line for each head.
 </p>
 </dd>
 <dt>
 --abbrev=&lt;length&gt;
 </dt>
 <dd>
 <p>
  Alter minimum display length for sha1 in output listing,
  default value is 7.
 </p>
 </dd>
 <dt>
 --no-abbrev
 </dt>
 <dd>
 <p>
  Display the full sha1s in output listing rather than abbreviating them.
 </p>
 </dd>
 <dt>
 --track
 </dt>
 <dd>
 <p>
  When creating a new branch, set up configuration so that <em>git-pull</em>
  will automatically retrieve data from the start point, which must be
  a branch. Use this if you always pull from the same upstream branch
  into the new branch, and if you don't want to use "git pull
  &lt;repository&gt; &lt;refspec&gt;" explicitly. This behavior is the default
  when the start point is a remote branch. Set the
  branch.autosetupmerge configuration variable to <tt>false</tt> if you want
  <em>git-checkout</em> and <em>git-branch</em> to always behave as if <em>--no-track</em> were
  given. Set it to <tt>always</tt> if you want this behavior when the
  start-point is either a local or remote branch.
 </p>
 </dd>
 <dt>
 --no-track
 </dt>
 <dd>
 <p>
  Ignore the branch.autosetupmerge configuration variable.
 </p>
 </dd>
 <dt>
 --contains &lt;commit&gt;
 </dt>
 <dd>
 <p>
  Only list branches which contain the specified commit.
 </p>
 </dd>
 <dt>
 --merged
 </dt>
 <dd>
 <p>
  Only list branches which are fully contained by HEAD.
 </p>
 </dd>
 <dt>
 --no-merged
 </dt>
 <dd>
 <p>
  Do not list branches which are fully contained by HEAD.
 </p>
 </dd>
 <dt>
 &lt;branchname&gt;
 </dt>
 <dd>
 <p>
  The name of the branch to create or delete.
  The new branch name must pass all checks defined by
  <a href="git-check-ref-format.html">git-check-ref-format(1)</a>. Some of these checks
  may restrict the characters allowed in a branch name.
 </p>
 </dd>
 <dt>
 &lt;start-point&gt;
 </dt>
 <dd>
 <p>
  The new branch will be created with a HEAD equal to this. It may
  be given as a branch name, a commit-id, or a tag. If this option
  is omitted, the current branch is assumed.
 </p>
 </dd>
 <dt>
 &lt;oldbranch&gt;
 </dt>
 <dd>
 <p>
  The name of an existing branch to rename.
 </p>
 </dd>
 <dt>
 &lt;newbranch&gt;
 </dt>
 <dd>
 <p>
  The new name for an existing branch. The same restrictions as for
  &lt;branchname&gt; applies.
 </p>
 </dd>
 </dl></div>
 </div>
 <h2 id="_examples">Examples</h2>
 <div class="sectionbody">
 <div class="vlist"><dl>
 <dt>
 Start development off of a known tag
 </dt>
 <dd>
 <div class="listingblock">
 <div class="content">
 <pre><tt>$ git clone git://git.kernel.org/pub/scm/.../linux-2.6 my2.6
 $ cd my2.6
 $ git branch my2.6.14 v2.6.14 <b>(1)</b>
 $ git checkout my2.6.14</tt></pre>
 </div></div>
 <div class="colist"><ol>
 <li>
 <p>
 This step and the next one could be combined into a single step with
 "checkout -b my2.6.14 v2.6.14".
 </p>
 </li>
 </ol></div>
 </dd>
 <dt>
 Delete unneeded branch
 </dt>
 <dd>
 <div class="listingblock">
 <div class="content">
 <pre><tt>$ git clone git://git.kernel.org/.../git.git my.git
 $ cd my.git
 $ git branch -d -r origin/todo origin/html origin/man <b>(1)</b>
 $ git branch -D test <b>(2)</b></tt></pre>
 </div></div>
 <div class="colist"><ol>
 <li>
 <p>
 Delete remote-tracking branches "todo", "html", "man". Next <em>fetch</em> or
 <em>pull</em> will create them again unless you configure them not to. See
 <a href="git-fetch.html">git-fetch(1)</a>.
 </p>
 </li>
 <li>
 <p>
 Delete "test" branch even if the "master" branch (or whichever branch is
 currently checked out) does not have all commits from test branch.
 </p>
 </li>
 </ol></div>
 </dd>
 </dl></div>
 </div>
 <h2 id="_notes">Notes</h2>
 <div class="sectionbody">
 <div class="para"><p>If you are creating a branch that you want to immediately checkout, it's
 easier to use the git checkout command with its <tt>-b</tt> option to create
 a branch and check it out with a single command.</p></div>
 <div class="para"><p>The options <tt>--contains</tt>, <tt>--merged</tt> and <tt>--no-merged</tt> serves three related
 but different purposes:</p></div>
 <div class="ilist"><ul>
 <li>
 <p>
 <tt>--contains &lt;commit&gt;</tt> is used to find all branches which will need
  special attention if &lt;commit&gt; were to be rebased or amended, since those
  branches contain the specified &lt;commit&gt;.
 </p>
 </li>
 <li>
 <p>
 <tt>--merged</tt> is used to find all branches which can be safely deleted,
  since those branches are fully contained by HEAD.
 </p>
 </li>
 <li>
 <p>
 <tt>--no-merged</tt> is used to find branches which are candidates for merging
  into HEAD, since those branches are not fully contained by HEAD.
 </p>
 </li>
 </ul></div>
 </div>
 <h2 id="_author">Author</h2>
 <div class="sectionbody">
 <div class="para"><p>Written by Linus Torvalds &lt;torvalds@osdl.org&gt; and Junio C Hamano &lt;junkio@cox.net&gt;</p></div>
 </div>
 <h2 id="_documentation">Documentation</h2>
 <div class="sectionbody">
 <div class="para"><p>Documentation by Junio C Hamano and the git-list &lt;git@vger.kernel.org&gt;.</p></div>
 </div>
 <h2 id="_git">GIT</h2>
 <div class="sectionbody">
 <div class="para"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
 </div>
 <div id="footer">
 <div id="footer-text">
 Last updated 2008-07-06 05:16:36 UTC
 </div>
 </div>
 </body>
 </html>
	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
	"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
	<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
	<head>
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
	<meta name="generator" content="AsciiDoc 8.2.5" />
	<style type="text/css">
	/* Debug borders */
	p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
	/*
	border: 1px solid red;
	*/
	}

	body {
	margin: 1em 5% 1em 5%;
	}

	a {
	color: blue;
	text-decoration: underline;
	}
	a:visited {
	color: fuchsia;
	}

	em {
	font-style: italic;
	}

	strong {
	font-weight: bold;
	}

	tt {
	color: navy;
	}

	h1, h2, h3, h4, h5, h6 {
	color: #527bbd;
	font-family: sans-serif;
	margin-top: 1.2em;
	margin-bottom: 0.5em;
	line-height: 1.3;
	}

	h1, h2, h3 {
	border-bottom: 2px solid silver;
	}
	h2 {
	padding-top: 0.5em;
	}
	h3 {
	float: left;
	}
	h3 + * {
	clear: left;
	}

	div.sectionbody {
	font-family: serif;
	margin-left: 0;
	}

	hr {
	border: 1px solid silver;
	}

	p {
	margin-top: 0.5em;
	margin-bottom: 0.5em;
	}

	pre {
	padding: 0;
	margin: 0;
	}

	span#author {
	color: #527bbd;
	font-family: sans-serif;
	font-weight: bold;
	font-size: 1.1em;
	}
	span#email {
	}
	span#revision {
	font-family: sans-serif;
	}

	div#footer {
	font-family: sans-serif;
	font-size: small;
	border-top: 2px solid silver;
	padding-top: 0.5em;
	margin-top: 4.0em;
	}
	div#footer-text {
	float: left;
	padding-bottom: 0.5em;
	}
	div#footer-badges {
	float: right;
	padding-bottom: 0.5em;
	}

	div#preamble,
	div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
	div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
	div.admonitionblock {
	margin-right: 10%;
	margin-top: 1.5em;
	margin-bottom: 1.5em;
	}
	div.admonitionblock {
	margin-top: 2.5em;
	margin-bottom: 2.5em;
	}

	div.content { /* Block element content. */
	padding: 0;
	}

	/* Block element titles. */
	div.title, caption.title {
	font-family: sans-serif;
	font-weight: bold;
	text-align: left;
	margin-top: 1.0em;
	margin-bottom: 0.5em;
	}
	div.title + * {
	margin-top: 0;
	}

	td div.title:first-child {
	margin-top: 0.0em;
	}
	div.content div.title:first-child {
	margin-top: 0.0em;
	}
	div.content + div.title {
	margin-top: 0.0em;
	}

	div.sidebarblock > div.content {
	background: #ffffee;
	border: 1px solid silver;
	padding: 0.5em;
	}

	div.listingblock {
	margin-right: 0%;
	}
	div.listingblock > div.content {
	border: 1px solid silver;
	background: #f4f4f4;
	padding: 0.5em;
	}

	div.quoteblock > div.content {
	padding-left: 2.0em;
	}

	div.attribution {
	text-align: right;
	}
	div.verseblock + div.attribution {
	text-align: left;
	}

	div.admonitionblock .icon {
	vertical-align: top;
	font-size: 1.1em;
	font-weight: bold;
	text-decoration: underline;
	color: #527bbd;
	padding-right: 0.5em;
	}
	div.admonitionblock td.content {
	padding-left: 0.5em;
	border-left: 2px solid silver;
	}

	div.exampleblock > div.content {
	border-left: 2px solid silver;
	padding: 0.5em;
	}

	div.verseblock div.content {
	white-space: pre;
	}

	div.imageblock div.content { padding-left: 0; }
	div.imageblock img { border: 1px solid silver; }
	span.image img { border-style: none; }

	dl {
	margin-top: 0.8em;
	margin-bottom: 0.8em;
	}
	dt {
	margin-top: 0.5em;
	margin-bottom: 0;
	font-style: italic;
	}
	dd > *:first-child {
	margin-top: 0;
	}

	ul, ol {
	list-style-position: outside;
	}
	div.olist2 ol {
	list-style-type: lower-alpha;
	}

	div.tableblock > table {
	border: 3px solid #527bbd;
	}
	thead {
	font-family: sans-serif;
	font-weight: bold;
	}
	tfoot {
	font-weight: bold;
	}

	div.hlist {
	margin-top: 0.8em;
	margin-bottom: 0.8em;
	}
	div.hlist td {
	padding-bottom: 5px;
	}
	td.hlist1 {
	vertical-align: top;
	font-style: italic;
	padding-right: 0.8em;
	}
	td.hlist2 {
	vertical-align: top;
	}

	@media print {
	div#footer-badges { display: none; }
	}

	div#toctitle {
	color: #527bbd;
	font-family: sans-serif;
	font-size: 1.1em;
	font-weight: bold;
	margin-top: 1.0em;
	margin-bottom: 0.1em;
	}

	div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
	margin-top: 0;
	margin-bottom: 0;
	}
	div.toclevel2 {
	margin-left: 2em;
	font-size: 0.9em;
	}
	div.toclevel3 {
	margin-left: 4em;
	font-size: 0.9em;
	}
	div.toclevel4 {
	margin-left: 6em;
	font-size: 0.9em;
	}
	include1::./stylesheets/xhtml11-manpage.css[]
	/* Workarounds for IE6's broken and incomplete CSS2. */

	div.sidebar-content {
	background: #ffffee;
	border: 1px solid silver;
	padding: 0.5em;
	}
	div.sidebar-title, div.image-title {
	font-family: sans-serif;
	font-weight: bold;
	margin-top: 0.0em;
	margin-bottom: 0.5em;
	}

	div.listingblock div.content {
	border: 1px solid silver;
	background: #f4f4f4;
	padding: 0.5em;
	}

	div.quoteblock-content {
	padding-left: 2.0em;
	}

	div.exampleblock-content {
	border-left: 2px solid silver;
	padding-left: 0.5em;
	}

	/* IE6 sets dynamically generated links as visited. */
	div#toc a:visited { color: blue; }
	</style>
	<title>git-branch(1)</title>
	</head>
	<body>
	<div id="header">
	<h1>
	git-branch(1) Manual Page
	</h1>
	<h2>NAME</h2>
	<div class="sectionbody">
	<p>git-branch -
	List, create, or delete branches
	</p>
	</div>
	</div>
	<h2>SYNOPSIS</h2>
	<div class="sectionbody">
	<div class="verseblock">
	<div class="content"><em>git branch</em> [--color \| --no-color] [-r \| -a] [--merged \| --no-merged]
	[-v [--abbrev=<length> \| --no-abbrev]]
	[--contains <commit>]
	<em>git branch</em> [--track \| --no-track] [-l] [-f] <branchname> [<start-point>]
	<em>git branch</em> (-m \| -M) [<oldbranch>] <newbranch>
	<em>git branch</em> (-d \| -D) [-r] <branchname>…</div></div>
	</div>
	<h2 id="_description">DESCRIPTION</h2>
	<div class="sectionbody">
	<div class="para"><p>With no arguments given a list of existing branches
	will be shown, the current branch will be highlighted with an asterisk.
	Option <tt>-r</tt> causes the remote-tracking branches to be listed,
	and option <tt>-a</tt> shows both.
	With <tt>--contains <commit></tt>, shows only the branches that
	contains the named commit (in other words, the branches whose
	tip commits are descendant of the named commit).
	With <tt>--merged</tt>, only branches merged into HEAD will be listed, and
	with <tt>--no-merged</tt> only branches not merged into HEAD will be listed.</p></div>
	<div class="para"><p>In its second form, a new branch named <branchname> will be created.
	It will start out with a head equal to the one given as <start-point>.
	If no <start-point> is given, the branch will be created with a head
	equal to that of the currently checked out branch.</p></div>
	<div class="para"><p>Note that this will create the new branch, but it will not switch the
	working tree to it; use "git checkout <newbranch>" to switch to the
	new branch.</p></div>
	<div class="para"><p>When a local branch is started off a remote branch, git sets up the
	branch so that <em>git-pull</em> will appropriately merge from
	the remote branch. This behavior may be changed via the global
	<tt>branch.autosetupmerge</tt> configuration flag. That setting can be
	overridden by using the <tt>--track</tt> and <tt>--no-track</tt> options.</p></div>
	<div class="para"><p>With a <em>-m</em> or <em>-M</em> option, <oldbranch> will be renamed to <newbranch>.
	If <oldbranch> had a corresponding reflog, it is renamed to match
	<newbranch>, and a reflog entry is created to remember the branch
	renaming. If <newbranch> exists, -M must be used to force the rename
	to happen.</p></div>
	<div class="para"><p>With a <tt>-d</tt> or <tt>-D</tt> option, <tt><branchname></tt> will be deleted. You may
	specify more than one branch for deletion. If the branch currently
	has a reflog then the reflog will also be deleted.</p></div>
	<div class="para"><p>Use -r together with -d to delete remote-tracking branches. Note, that it
	only makes sense to delete remote-tracking branches if they no longer exist
	in remote repository or if <em>git-fetch</em> was configured not to fetch
	them again. See also <em>prune</em> subcommand of <a href="git-remote.html">git-remote(1)</a> for way to
	clean up all obsolete remote-tracking branches.</p></div>
	</div>
	<h2 id="_options">OPTIONS</h2>
	<div class="sectionbody">
	<div class="vlist"><dl>
	<dt>
	-d
	</dt>
	<dd>
	<p>
	Delete a branch. The branch must be fully merged in HEAD.
	</p>
	</dd>
	<dt>
	-D
	</dt>
	<dd>
	<p>
	Delete a branch irrespective of its merged status.
	</p>
	</dd>
	<dt>
	-l
	</dt>
	<dd>
	<p>
	Create the branch's reflog. This activates recording of
	all changes made to the branch ref, enabling use of date
	based sha1 expressions such as "<branchname>@{yesterday}".
	</p>
	</dd>
	<dt>
	-f
	</dt>
	<dd>
	<p>
	Force the creation of a new branch even if it means deleting
	a branch that already exists with the same name.
	</p>
	</dd>
	<dt>
	-m
	</dt>
	<dd>
	<p>
	Move/rename a branch and the corresponding reflog.
	</p>
	</dd>
	<dt>
	-M
	</dt>
	<dd>
	<p>
	Move/rename a branch even if the new branchname already exists.
	</p>
	</dd>
	<dt>
	--color
	</dt>
	<dd>
	<p>
	Color branches to highlight current, local, and remote branches.
	</p>
	</dd>
	<dt>
	--no-color
	</dt>
	<dd>
	<p>
	Turn off branch colors, even when the configuration file gives the
	default to color output.
	</p>
	</dd>
	<dt>
	-r
	</dt>
	<dd>
	<p>
	List or delete (if used with -d) the remote-tracking branches.
	</p>
	</dd>
	<dt>
	-a
	</dt>
	<dd>
	<p>
	List both remote-tracking branches and local branches.
	</p>
	</dd>
	<dt>
	-v
	</dt>
	<dt>
	--verbose
	</dt>
	<dd>
	<p>
	Show sha1 and commit subject line for each head.
	</p>
	</dd>
	<dt>
	--abbrev=<length>
	</dt>
	<dd>
	<p>
	Alter minimum display length for sha1 in output listing,
	default value is 7.
	</p>
	</dd>
	<dt>
	--no-abbrev
	</dt>
	<dd>
	<p>
	Display the full sha1s in output listing rather than abbreviating them.
	</p>
	</dd>
	<dt>
	--track
	</dt>
	<dd>
	<p>
	When creating a new branch, set up configuration so that <em>git-pull</em>
	will automatically retrieve data from the start point, which must be
	a branch. Use this if you always pull from the same upstream branch
	into the new branch, and if you don't want to use "git pull
	<repository> <refspec>" explicitly. This behavior is the default
	when the start point is a remote branch. Set the
	branch.autosetupmerge configuration variable to <tt>false</tt> if you want
	<em>git-checkout</em> and <em>git-branch</em> to always behave as if <em>--no-track</em> were
	given. Set it to <tt>always</tt> if you want this behavior when the
	start-point is either a local or remote branch.
	</p>
	</dd>
	<dt>
	--no-track
	</dt>
	<dd>
	<p>
	Ignore the branch.autosetupmerge configuration variable.
	</p>
	</dd>
	<dt>
	--contains <commit>
	</dt>
	<dd>
	<p>
	Only list branches which contain the specified commit.
	</p>
	</dd>
	<dt>
	--merged
	</dt>
	<dd>
	<p>
	Only list branches which are fully contained by HEAD.
	</p>
	</dd>
	<dt>
	--no-merged
	</dt>
	<dd>
	<p>
	Do not list branches which are fully contained by HEAD.
	</p>
	</dd>
	<dt>
	<branchname>
	</dt>
	<dd>
	<p>
	The name of the branch to create or delete.
	The new branch name must pass all checks defined by
	<a href="git-check-ref-format.html">git-check-ref-format(1)</a>. Some of these checks
	may restrict the characters allowed in a branch name.
	</p>
	</dd>
	<dt>
	<start-point>
	</dt>
	<dd>
	<p>
	The new branch will be created with a HEAD equal to this. It may
	be given as a branch name, a commit-id, or a tag. If this option
	is omitted, the current branch is assumed.
	</p>
	</dd>
	<dt>
	<oldbranch>
	</dt>
	<dd>
	<p>
	The name of an existing branch to rename.
	</p>
	</dd>
	<dt>
	<newbranch>
	</dt>
	<dd>
	<p>
	The new name for an existing branch. The same restrictions as for
	<branchname> applies.
	</p>
	</dd>
	</dl></div>
	</div>
	<h2 id="_examples">Examples</h2>
	<div class="sectionbody">
	<div class="vlist"><dl>
	<dt>
	Start development off of a known tag
	</dt>
	<dd>
	<div class="listingblock">
	<div class="content">
	<pre><tt>$ git clone git://git.kernel.org/pub/scm/.../linux-2.6 my2.6
	$ cd my2.6
	$ git branch my2.6.14 v2.6.14 <b>(1)</b>
	$ git checkout my2.6.14</tt></pre>
	</div></div>
	<div class="colist"><ol>
	<li>
	<p>
	This step and the next one could be combined into a single step with
	"checkout -b my2.6.14 v2.6.14".
	</p>
	</li>
	</ol></div>
	</dd>
	<dt>
	Delete unneeded branch
	</dt>
	<dd>
	<div class="listingblock">
	<div class="content">
	<pre><tt>$ git clone git://git.kernel.org/.../git.git my.git
	$ cd my.git
	$ git branch -d -r origin/todo origin/html origin/man <b>(1)</b>
	$ git branch -D test <b>(2)</b></tt></pre>
	</div></div>
	<div class="colist"><ol>
	<li>
	<p>
	Delete remote-tracking branches "todo", "html", "man". Next <em>fetch</em> or
	<em>pull</em> will create them again unless you configure them not to. See
	<a href="git-fetch.html">git-fetch(1)</a>.
	</p>
	</li>
	<li>
	<p>
	Delete "test" branch even if the "master" branch (or whichever branch is
	currently checked out) does not have all commits from test branch.
	</p>
	</li>
	</ol></div>
	</dd>
	</dl></div>
	</div>
	<h2 id="_notes">Notes</h2>
	<div class="sectionbody">
	<div class="para"><p>If you are creating a branch that you want to immediately checkout, it's
	easier to use the git checkout command with its <tt>-b</tt> option to create
	a branch and check it out with a single command.</p></div>
	<div class="para"><p>The options <tt>--contains</tt>, <tt>--merged</tt> and <tt>--no-merged</tt> serves three related
	but different purposes:</p></div>
	<div class="ilist"><ul>
	<li>
	<p>
	<tt>--contains <commit></tt> is used to find all branches which will need
	special attention if <commit> were to be rebased or amended, since those
	branches contain the specified <commit>.
	</p>
	</li>
	<li>
	<p>
	<tt>--merged</tt> is used to find all branches which can be safely deleted,
	since those branches are fully contained by HEAD.
	</p>
	</li>
	<li>
	<p>
	<tt>--no-merged</tt> is used to find branches which are candidates for merging
	into HEAD, since those branches are not fully contained by HEAD.
	</p>
	</li>
	</ul></div>
	</div>
	<h2 id="_author">Author</h2>
	<div class="sectionbody">
	<div class="para"><p>Written by Linus Torvalds <torvalds@osdl.org> and Junio C Hamano <junkio@cox.net></p></div>
	</div>
	<h2 id="_documentation">Documentation</h2>
	<div class="sectionbody">
	<div class="para"><p>Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.</p></div>
	</div>
	<h2 id="_git">GIT</h2>
	<div class="sectionbody">
	<div class="para"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
	</div>
	<div id="footer">
	<div id="footer-text">
	Last updated 2008-07-06 05:16:36 UTC
	</div>
	</div>
	</body>
	</html>