.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-BRANCH" "1" "12/13/2006" "" ""
+.TH "GIT\-BRANCH" "1" "12/22/2006" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
\fIgit\-branch\fR [\-r | \-a] [\-v [\-\-abbrev=<length>]]
\fIgit\-branch\fR [\-l] [\-f] <branchname> [<start\-point>]
\fIgit\-branch\fR (\-m | \-M) [<oldbranch>] <newbranch>
-\fIgit\-branch\fR (\-d | \-D) <branchname>\&...
+\fIgit\-branch\fR (\-d | \-D) [\-r] <branchname>\&...
.fi
.SH "DESCRIPTION"
With no arguments given a list of existing branches will be shown, the current branch will be highlighted with an asterisk. Option \-r causes the remote\-tracking branches to be listed, and option \-a shows both.
With a \fI\-m\fR or \fI\-M\fR 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.
-With a \-d or \-D option, <branchname> will be deleted. You may specify more than one branch for deletion. If the branch currently has a ref log then the ref log will also be deleted.
+With a \-d or \-D option, <branchname> will be deleted. You may specify more than one branch for deletion. If the branch currently has a ref log then the ref log will also be deleted. Use \-r together with \-d to delete remote\-tracking branches.
.SH "OPTIONS"
.TP
\-d
Move/rename a branch even if the new branchname already exists.
.TP
\-r
-List the remote\-tracking branches.
+List or delete (if used with \-d) the remote\-tracking branches.
.TP
\-a
List both remote\-tracking branches and local branches.
.nf
$ git clone git://git.kernel.org/.../git.git my.git
$ cd my.git
-$ git branch \-D todo \fB(1)\fR
+$ git branch \-d \-r todo html man \fB(1)\fR
+$ git branch \-D test \fB(2)\fR
.fi
.sp
-\fB1. \fRdelete todo branch even if the "master" branch does not have all commits from todo branch.
+\fB1. \fRdelete remote\-tracking branches "todo", "html", "man"
+.br
+\fB2. \fRdelete "test" branch even if the "master" branch does not have all commits from todo branch.
.br
.SH "NOTES"
If you are creating a branch that you want to immediately checkout, it's easier to use the git checkout command with its \-b option to create a branch and check it out with a single command.
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GIT\-TAG" "1" "10/03/2006" "" ""
+.TH "GIT\-TAG" "1" "12/22/2006" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.SH "SYNOPSIS"
.sp
.nf
-\fIgit\-tag\fR [\-a | \-s | \-u <key\-id>] [\-f | \-d] [\-m <msg>] <name> [<head>]
+\fIgit\-tag\fR [\-a | \-s | \-u <key\-id>] [\-f | \-d] [\-m <msg> | \-F <file>]
+ <name> [<head>]
\fIgit\-tag\fR \-l [<pattern>]
.fi
.SH "DESCRIPTION"
Adds a \fItag\fR reference in .git/refs/tags/
-.sp
+
Unless \-f is given, the tag must not yet exist in .git/refs/tags/ directory.
-.sp
+
If one of \-a, \-s, or \-u <key\-id> is passed, the command creates a \fItag\fR object, and requires the tag message. Unless \-m <msg> is given, an editor is started for the user to type in the tag message.
-.sp
+
Otherwise just the SHA1 object name of the commit object is written (i.e. a lightweight tag).
-.sp
+
A GnuPG signed tag object will be created when \-s or \-u <key\-id> is used. When \-u <key\-id> is not used, the committer identity for the current user is used to find the GnuPG key for signing.
-.sp
+
\-d <tag> deletes the tag.
-.sp
+
\-l <pattern> lists tags that match the given pattern (or all if no pattern is given).
-.sp
.SH "OPTIONS"
.TP
\-a
.TP
\-m <msg>
Use the given tag message (instead of prompting)
+.TP
+\-F <file>
+Take the tag message from the given file. Use \fI\-\fR to read the message from the standard input.
.SH "AUTHOR"
Written by Linus Torvalds <torvalds@osdl.org>, Junio C Hamano <junkio@cox.net> and Chris Wright <chrisw@osdl.org>.
-.sp
.SH "DOCUMENTATION"
Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger.kernel.org>.
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+