.\" 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\-ADD" "1" "03/02/2007" "" ""
+.TH "GIT\-ADD" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-AM" "1" "03/25/2007" "" ""
+.TH "GIT\-AM" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-ANNOTATE" "1" "10/03/2006" "" ""
+.TH "GIT\-ANNOTATE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-annotate \- Annotate file lines with commit info
.SH "SYNOPSIS"
git\-annotate [options] file [revision]
-.sp
.SH "DESCRIPTION"
Annotates each line in the given file with information from the commit which introduced the line. Optionally annotate from a given revision.
-.sp
.SH "OPTIONS"
.TP
\-l, \-\-long
Show help message.
.SH "SEE ALSO"
\fBgit\-blame\fR(1)
-.sp
.SH "AUTHOR"
Written by Ryan Anderson <ryan@michonline.com>.
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-APPLY" "1" "01/19/2007" "" ""
+.TH "GIT\-APPLY" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-APPLYMBOX" "1" "01/10/2007" "" ""
+.TH "GIT\-APPLYMBOX" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-APPLYPATCH" "1" "01/17/2007" "" ""
+.TH "GIT\-APPLYPATCH" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-ARCHIMPORT" "1" "03/08/2007" "" ""
+.TH "GIT\-ARCHIMPORT" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-ARCHIVE" "1" "01/19/2007" "" ""
+.TH "GIT\-ARCHIVE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-BISECT" "1" "03/24/2007" "" ""
+.TH "GIT\-BISECT" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-BLAME" "1" "02/06/2007" "" ""
+.TH "GIT\-BLAME" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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" "03/14/2007" "" ""
+.TH "GIT\-BRANCH" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-BUNDLE" "1" "03/02/2007" "" ""
+.TH "GIT\-BUNDLE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-CAT\-FILE" "1" "02/01/2007" "" ""
+.TH "GIT\-CAT\-FILE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-CHECK\-REF\-FORMAT" "1" "10/03/2006" "" ""
+.TH "GIT\-CHECK\-REF\-FORMAT" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-check\-ref\-format \- Make sure ref name is well formed
.SH "SYNOPSIS"
\fIgit\-check\-ref\-format\fR <refname>
-.sp
.SH "DESCRIPTION"
Checks if a given \fIrefname\fR is acceptable, and exits non\-zero if it is not.
-.sp
+
A reference is used in git to specify branches and tags. A branch head is stored under $GIT_DIR/refs/heads directory, and a tag is stored under $GIT_DIR/refs/tags directory. git imposes the following rules on how refs are named:
-.sp
.TP 3
1.
-It can include slash
-/
-for hierarchical (directory) grouping, but no slash\-separated component can begin with a dot
-.;
+It can include slash / for hierarchical (directory) grouping, but no slash\-separated component can begin with a dot .;
.TP
2.
-It cannot have two consecutive dots
-..
-anywhere;
+It cannot have two consecutive dots .. anywhere;
.TP
3.
-It cannot have ASCII control character (i.e. bytes whose values are lower than \\040, or \\177
-DEL), space, tilde
-~, caret
-^, colon
-:, question\-mark
-?, asterisk
-*, or open bracket
-[
-anywhere;
+It cannot have ASCII control character (i.e. bytes whose values are lower than \\040, or \\177 DEL), space, tilde ~, caret ^, colon :, question\-mark ?, asterisk *, or open bracket [ anywhere;
.TP
4.
-It cannot end with a slash
-/.
+It cannot end with a slash /.
+
These rules makes it easy for shell script based tools to parse refnames, pathname expansion by the shell when a refname is used unquoted (by mistake), and also avoids ambiguities in certain refname expressions (see \fBgit\-rev\-parse\fR(1)). Namely:
-.sp
.TP 3
1.
-double\-dot
-..
-are often used as in
-ref1..ref2, and in some context this notation means
-^ref1 ref2
-(i.e. not in ref1 and in ref2).
+double\-dot .. are often used as in ref1..ref2, and in some context this notation means ^ref1 ref2 (i.e. not in ref1 and in ref2).
.TP
2.
-tilde
-~
-and caret
-^
-are used to introduce postfix
-\fInth parent\fR
-and
-\fIpeel onion\fR
-operation.
+tilde ~ and caret ^ are used to introduce postfix \fInth parent\fR and \fIpeel onion\fR operation.
.TP
3.
-colon
-:
-is used as in
-srcref:dstref
-to mean "use srcref's value and store it in dstref" in fetch and push operations. It may also be used to select a specific object such as with
-\fBgit\-cat\-file\fR(1)
-"git\-cat\-file blob v1.3.3:refs.c".
+colon : is used as in srcref:dstref to mean "use srcref's value and store it in dstref" in fetch and push operations. It may also be used to select a specific object such as with \fBgit\-cat\-file\fR(1) "git\-cat\-file blob v1.3.3:refs.c".
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-CHECKOUT\-INDEX" "1" "01/19/2007" "" ""
+.TH "GIT\-CHECKOUT\-INDEX" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-CHECKOUT" "1" "03/14/2007" "" ""
+.TH "GIT\-CHECKOUT" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-CHERRY\-PICK" "1" "01/18/2007" "" ""
+.TH "GIT\-CHERRY\-PICK" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-CHERRY" "1" "10/27/2006" "" ""
+.TH "GIT\-CHERRY" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-cherry \- Find commits not merged upstream
.SH "SYNOPSIS"
\fIgit\-cherry\fR [\-v] <upstream> [<head>] [<limit>]
-.sp
.SH "DESCRIPTION"
The changeset (or "diff") of each commit between the fork\-point and <head> is compared against each commit between the fork\-point and <upstream>.
-.sp
+
Every commit that doesn't exist in the <upstream> branch has its id (sha1) reported, prefixed by a symbol. The ones that have equivalent change already in the <upstream> branch are prefixed with a minus (\-) sign, and those that only exist in the <head> branch are prefixed with a plus (+) symbol:
.sp
-.sp
.nf
__*__*__*__*__> <upstream>
/
.fi
If a <limit> has been given then the commits along the <head> branch up to and including <limit> are not reported:
.sp
-.sp
.nf
__*__*__*__*__> <upstream>
/
\\__*__*__<limit>__\-__+__> <head>
.fi
Because git\-cherry compares the changeset rather than the commit id (sha1), you can use git\-cherry to find out if a commit you made locally has been applied <upstream> under a different commit id. For example, this will happen if you're feeding patches <upstream> via email rather than pushing or pulling commits directly.
-.sp
.SH "OPTIONS"
.TP
\-v
Working branch; defaults to HEAD.
.SH "AUTHOR"
Written by Junio C Hamano <junkio@cox.net>
-.sp
.SH "DOCUMENTATION"
Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-CLEAN" "1" "10/03/2006" "" ""
+.TH "GIT\-CLEAN" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.fi
.SH "DESCRIPTION"
Removes files unknown to git. This allows to clean the working tree from files that are not under version control. If the \fI\-x\fR option is specified, ignored files are also removed, allowing to remove all build products. When optional <paths>\&... arguments are given, the paths affected are further limited to those that match them.
-.sp
.SH "OPTIONS"
.TP
\-d
Be quiet, only report errors, but not the files that are successfully removed.
.TP
\-x
-Don't use the ignore rules. This allows removing all untracked files, including build products. This can be used (possibly in conjunction with
-\fBgit\-reset\fR(1)) to create a pristine working directory to test a clean build.
+Don't use the ignore rules. This allows removing all untracked files, including build products. This can be used (possibly in conjunction with \fBgit\-reset\fR(1)) to create a pristine working directory to test a clean build.
.TP
\-X
Remove only files ignored by git. This may be useful to rebuild everything from scratch, but keep manually created files.
.SH "AUTHOR"
Written by Pavel Roskin <proski@gnu.org>
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-CLONE" "1" "02/20/2007" "" ""
+.TH "GIT\-CLONE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-COMMIT\-TREE" "1" "03/02/2007" "" ""
+.TH "GIT\-COMMIT\-TREE" "1" "04/04/2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-COMMIT" "1" "03/12/2007" "" ""
+.TH "GIT\-COMMIT" "1" "04/04/2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-CONFIG" "1" "03/19/2007" "" ""
+.TH "GIT\-CONFIG" "1" "04/04/2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-CONVERT\-OBJECTS" "1" "10/03/2006" "" ""
+.TH "GIT\-CONVERT\-OBJECTS" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-convert\-objects \- Converts old\-style git repository
.SH "SYNOPSIS"
\fIgit\-convert\-objects\fR
-.sp
.SH "DESCRIPTION"
Converts old\-style git repository to the latest format
-.sp
.SH "AUTHOR"
Written by Linus Torvalds <torvalds@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
+
.\" 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\-COUNT\-OBJECTS" "1" "01/19/2007" "" ""
+.TH "GIT\-COUNT\-OBJECTS" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-CVSEXPORTCOMMIT" "1" "02/21/2007" "" ""
+.TH "GIT\-CVSEXPORTCOMMIT" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-CVSIMPORT" "1" "02/28/2007" "" ""
+.TH "GIT\-CVSIMPORT" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-CVSSERVER" "1" "04/01/2007" "" ""
+.TH "GIT\-CVSSERVER" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-DAEMON" "1" "01/25/2007" "" ""
+.TH "GIT\-DAEMON" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-DESCRIBE" "1" "01/28/2007" "" ""
+.TH "GIT\-DESCRIBE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-DIFF\-FILES" "1" "03/25/2007" "" ""
+.TH "GIT\-DIFF\-FILES" "1" "04/04/2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-DIFF\-INDEX" "1" "03/25/2007" "" ""
+.TH "GIT\-DIFF\-INDEX" "1" "04/04/2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-DIFF\-TREE" "1" "03/25/2007" "" ""
+.TH "GIT\-DIFF\-TREE" "1" "04/04/2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-DIFF" "1" "03/25/2007" "" ""
+.TH "GIT\-DIFF" "1" "04/04/2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-FAST\-IMPORT" "1" "03/12/2007" "" ""
+.TH "GIT\-FAST\-IMPORT" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-FETCH\-PACK" "1" "03/05/2007" "" ""
+.TH "GIT\-FETCH\-PACK" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-FETCH" "1" "03/02/2007" "" ""
+.TH "GIT\-FETCH" "1" "04/04/2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-FMT\-MERGE\-MSG" "1" "10/03/2006" "" ""
+.TH "GIT\-FMT\-MERGE\-MSG" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-fmt\-merge\-msg \- Produce a merge commit message
.SH "SYNOPSIS"
\fIgit\-fmt\-merge\-msg\fR <$GIT_DIR/FETCH_HEAD
-.sp
.SH "DESCRIPTION"
Takes the list of merged objects on stdin and produces a suitable commit message to be used for the merge commit, usually to be passed as the \fI<merge\-message>\fR argument of git\-merge.
-.sp
+
This script is intended mostly for internal use by scripts automatically invoking git\-merge.
-.sp
.SH "SEE ALSO"
\fBgit\-merge\fR(1)
-.sp
.SH "AUTHOR"
Written by Junio C Hamano <junkio@cox.net>
-.sp
.SH "DOCUMENTATION"
Documentation by Petr Baudis, Junio C Hamano and the git\-list <git@vger.kernel.org>.
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-FOR\-EACH\-REF" "1" "02/06/2007" "" ""
+.TH "GIT\-FOR\-EACH\-REF" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-FORMAT\-PATCH" "1" "03/25/2007" "" ""
+.TH "GIT\-FORMAT\-PATCH" "1" "04/04/2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-FSCK\-OBJECTS" "1" "01/29/2007" "" ""
+.TH "GIT\-FSCK\-OBJECTS" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-FSCK" "1" "01/29/2007" "" ""
+.TH "GIT\-FSCK" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-GC" "1" "02/13/2007" "" ""
+.TH "GIT\-GC" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-GET\-TAR\-COMMIT\-I" "1" "10/03/2006" "" ""
+.TH "GIT\-GET\-TAR\-COMMIT\-I" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-get\-tar\-commit\-id \- Extract commit ID from an archive created using git\-tar\-tree
.SH "SYNOPSIS"
\fIgit\-get\-tar\-commit\-id\fR < <tarfile>
-.sp
.SH "DESCRIPTION"
Acts as a filter, extracting the commit ID stored in archives created by git\-tar\-tree. It reads only the first 1024 bytes of input, thus its runtime is not influenced by the size of <tarfile> very much.
-.sp
+
If no commit ID is found, git\-get\-tar\-commit\-id quietly exists with a return code of 1. This can happen if <tarfile> had not been created using git\-tar\-tree or if the first parameter of git\-tar\-tree had been a tree ID instead of a commit ID or tag.
-.sp
.SH "AUTHOR"
Written by Rene Scharfe <rene.scharfe@lsrfire.ath.cx>
-.sp
.SH "DOCUMENTATION"
Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-GREP" "1" "01/17/2007" "" ""
+.TH "GIT\-GREP" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-HASH\-OBJECT" "1" "01/19/2007" "" ""
+.TH "GIT\-HASH\-OBJECT" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-HTTP\-FETCH" "1" "01/19/2007" "" ""
+.TH "GIT\-HTTP\-FETCH" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-HTTP\-PUSH" "1" "01/19/2007" "" ""
+.TH "GIT\-HTTP\-PUSH" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-IMAP\-SEND" "1" "10/03/2006" "" ""
+.TH "GIT\-IMAP\-SEND" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-imap\-send \- Dump a mailbox from stdin into an imap folder
.SH "SYNOPSIS"
\fIgit\-imap\-send\fR
-.sp
.SH "DESCRIPTION"
This command uploads a mailbox generated with git\-format\-patch into an imap drafts folder. This allows patches to be sent as other email is sent with mail clients that cannot read mailbox files directly.
-.sp
+
Typical usage is something like:
-.sp
+
git\-format\-patch \-\-signoff \-\-stdout \-\-attach origin | git\-imap\-send
-.sp
.SH "CONFIGURATION"
git\-imap\-send requires the following values in the repository configuration file (shown with examples):
.sp
-.sp
.nf
[imap]
Folder = "INBOX.Drafts"
.fi
.SH "BUGS"
Doesn't handle lines starting with "From " in the message body.
-.sp
.SH "AUTHOR"
Derived from isync 1.0.1 by Mike McCormack.
-.sp
.SH "DOCUMENTATION"
Documentation by Mike McCormack
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-INDEX\-PACK" "1" "11/08/2006" "" ""
+.TH "GIT\-INDEX\-PACK" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-index\-pack \- Build pack index file for an existing packed archive
.SH "SYNOPSIS"
\fIgit\-index\-pack\fR [\-v] [\-o <index\-file>] <pack\-file> \fIgit\-index\-pack\fR \-\-stdin [\-\-fix\-thin] [\-\-keep] [\-v] [\-o <index\-file>] [<pack\-file>]
-.sp
.SH "DESCRIPTION"
Reads a packed archive (.pack) from the specified file, and builds a pack index file (.idx) for it. The packed archive together with the pack index can then be placed in the objects/pack/ directory of a git repository.
-.sp
.SH "OPTIONS"
.TP
\-v
Write the generated pack index into the specified file. Without this option the name of pack index file is constructed from the name of packed archive file by replacing .pack with .idx (and the program fails if the name of packed archive does not end with .pack).
.TP
\-\-stdin
-When this flag is provided, the pack is read from stdin instead and a copy is then written to <pack\-file>. If <pack\-file> is not specified, the pack is written to objects/pack/ directory of the current git repository with a default name determined from the pack content. If <pack\-file> is not specified consider using \-\-keep to prevent a race condition between this process and
-\fB:git\-repack\fR(1)
-.
+When this flag is provided, the pack is read from stdin instead and a copy is then written to <pack\-file>. If <pack\-file> is not specified, the pack is written to objects/pack/ directory of the current git repository with a default name determined from the pack content. If <pack\-file> is not specified consider using \-\-keep to prevent a race condition between this process and \fB:git\-repack\fR(1) .
.TP
\-\-fix\-thin
-It is possible for
-\fBgit\-pack\-objects\fR(1)
-to build "thin" pack, which records objects in deltified form based on objects not included in the pack to reduce network traffic. Those objects are expected to be present on the receiving end and they must be included in the pack for that pack to be self contained and indexable. Without this option any attempt to index a thin pack will fail. This option only makes sense in conjunction with \-\-stdin.
+It is possible for \fBgit\-pack\-objects\fR(1) to build "thin" pack, which records objects in deltified form based on objects not included in the pack to reduce network traffic. Those objects are expected to be present on the receiving end and they must be included in the pack for that pack to be self contained and indexable. Without this option any attempt to index a thin pack will fail. This option only makes sense in conjunction with \-\-stdin.
.TP
\-\-keep
-Before moving the index into its final destination create an empty .keep file for the associated pack file. This option is usually necessary with \-\-stdin to prevent a simultaneous
-\fBgit\-repack\fR(1)
-process from deleting the newly constructed pack and index before refs can be updated to use objects contained in the pack.
+Before moving the index into its final destination create an empty .keep file for the associated pack file. This option is usually necessary with \-\-stdin to prevent a simultaneous \fBgit\-repack\fR(1) process from deleting the newly constructed pack and index before refs can be updated to use objects contained in the pack.
.TP
\-\-keep=\fIwhy\fR
-Like \-\-keep create a .keep file before moving the index into its final destination, but rather than creating an empty file place
-\fIwhy\fR
-followed by an LF into the .keep file. The
-\fIwhy\fR
-message can later be searched for within all .keep files to locate any which have outlived their usefulness.
+Like \-\-keep create a .keep file before moving the index into its final destination, but rather than creating an empty file place \fIwhy\fR followed by an LF into the .keep file. The \fIwhy\fR message can later be searched for within all .keep files to locate any which have outlived their usefulness.
.SH "NOTE"
Once the index has been created, the list of object names is sorted and the SHA1 hash of that list is printed to stdout. If \-\-stdin was also used then this is prefixed by either "pack\\t", or "keep\\t" if a new .keep file was successfully created. This is useful to remove a .keep file used as a lock to prevent the race with \fBgit\-repack\fR(1) mentioned above.
-.sp
.SH "AUTHOR"
Written by Sergey Vlasov <vsu@altlinux.ru>
-.sp
.SH "DOCUMENTATION"
Documentation by Sergey Vlasov
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-INIT\-DB" "1" "01/12/2007" "" ""
+.TH "GIT\-INIT\-DB" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-INIT" "1" "01/19/2007" "" ""
+.TH "GIT\-INIT" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-INSTAWEB" "1" "01/19/2007" "" ""
+.TH "GIT\-INSTAWEB" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-LOCAL\-FETCH" "1" "01/19/2007" "" ""
+.TH "GIT\-LOCAL\-FETCH" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-LOG" "1" "03/28/2007" "" ""
+.TH "GIT\-LOG" "1" "04/04/2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-LOST\-FOUND" "1" "10/03/2006" "" ""
+.TH "GIT\-LOST\-FOUND" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-lost\-found \- Recover lost refs that luckily have not yet been pruned
.SH "SYNOPSIS"
\fIgit\-lost\-found\fR
-.sp
.SH "DESCRIPTION"
Finds dangling commits and tags from the object database, and creates refs to them in .git/lost\-found/ directory. Commits and tags that dereference to commits go to .git/lost\-found/commit and others are stored in .git/lost\-found/other directory.
-.sp
.SH "OUTPUT"
One line description from the commit and tag found along with their object name are printed on the standard output.
-.sp
.SH "EXAMPLE"
Suppose you run \fIgit tag \-f\fR and mistyped the tag to overwrite. The ref to your tag is overwritten, but until you run \fIgit prune\fR, it is still there.
.sp
-.sp
.nf
$ git lost\-found
[1ef2b196d909eed523d4f3c9bf54b78cdd6843c6] GIT 0.99.9c
.fi
Also you can use gitk to browse how they relate to each other and existing (probably old) tags.
.sp
-.sp
.nf
$ gitk $(cd .git/lost\-found/commit && echo ??*)
.fi
After making sure that it is the object you are looking for, you can reconnect it to your regular .git/refs hierarchy.
.sp
-.sp
.nf
$ git cat\-file \-t 1ef2b196
tag
.fi
.SH "AUTHOR"
Written by Junio C Hamano 濱野 純 <junkio@cox.net>
-.sp
.SH "DOCUMENTATION"
Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-LS\-FILES" "1" "01/19/2007" "" ""
+.TH "GIT\-LS\-FILES" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-LS\-REMOTE" "1" "01/17/2007" "" ""
+.TH "GIT\-LS\-REMOTE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-LS\-TREE" "1" "01/19/2007" "" ""
+.TH "GIT\-LS\-TREE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-MAILINFO" "1" "01/19/2007" "" ""
+.TH "GIT\-MAILINFO" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-MAILSPLIT" "1" "01/19/2007" "" ""
+.TH "GIT\-MAILSPLIT" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-MERGE\-BASE" "1" "01/19/2007" "" ""
+.TH "GIT\-MERGE\-BASE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-MERGE\-FILE" "1" "01/19/2007" "" ""
+.TH "GIT\-MERGE\-FILE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-MERGE\-INDEX" "1" "01/19/2007" "" ""
+.TH "GIT\-MERGE\-INDEX" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-MERGE\-ONE\-FILE" "1" "01/19/2007" "" ""
+.TH "GIT\-MERGE\-ONE\-FILE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-MERGE\-TREE" "1" "10/03/2006" "" ""
+.TH "GIT\-MERGE\-TREE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-merge\-tree \- Show three\-way merge without touching index
.SH "SYNOPSIS"
\fIgit\-merge\-tree\fR <base\-tree> <branch1> <branch2>
-.sp
.SH "DESCRIPTION"
Reads three treeish, and output trivial merge results and conflicting stages to the standard output. This is similar to what three\-way read\-tree \-m does, but instead of storing the results in the index, the command outputs the entries to the standard output.
-.sp
+
This is meant to be used by higher level scripts to compute merge results outside index, and stuff the results back into the index. For this reason, the output from the command omits entries that match <branch1> tree.
-.sp
.SH "AUTHOR"
Written by Linus Torvalds <torvalds@osdl.org>
-.sp
.SH "DOCUMENTATION"
Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-MERGE" "1" "03/02/2007" "" ""
+.TH "GIT\-MERGE" "1" "04/04/2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-MERGETOOL" "1" "03/30/2007" "" ""
+.TH "GIT\-MERGETOOL" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-MKTAG" "1" "10/03/2006" "" ""
+.TH "GIT\-MKTAG" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-mktag \- Creates a tag object
.SH "SYNOPSIS"
\fIgit\-mktag\fR < signature_file
-.sp
.SH "DESCRIPTION"
Reads a tag contents on standard input and creates a tag object that can also be used to sign other objects.
-.sp
+
The output is the new tag's <object> identifier.
-.sp
.SH "TAG FORMAT"
A tag signature file has a very simple fixed format: three lines of
.sp
-.sp
.nf
object <sha1>
type <typename>
tag <tagname>
.fi
followed by some \fIoptional\fR free\-form signature that git itself doesn't care about, but that can be verified with gpg or similar.
-.sp
+
The size of the full object is artificially limited to 8kB. (Just because I'm a lazy bastard, and if you can't fit a signature in that size, you're doing something wrong)
-.sp
.SH "AUTHOR"
Written by Linus Torvalds <torvalds@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
+
.\" 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\-MKTREE" "1" "10/03/2006" "" ""
+.TH "GIT\-MKTREE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-mktree \- Build a tree\-object from ls\-tree formatted text
.SH "SYNOPSIS"
\fIgit\-mktree\fR [\-z]
-.sp
.SH "DESCRIPTION"
Reads standard input in non\-recursive ls\-tree output format, and creates a tree object. The object name of the tree object built is written to the standard output.
-.sp
.SH "OPTIONS"
.TP
\-z
-Read the NUL\-terminated
-ls\-tree \-z
-output instead.
+Read the NUL\-terminated ls\-tree \-z output instead.
.SH "AUTHOR"
Written by Junio C Hamano <junkio@cox.net>
-.sp
.SH "DOCUMENTATION"
Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-MV" "1" "01/19/2007" "" ""
+.TH "GIT\-MV" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-NAME\-REV" "1" "02/18/2007" "" ""
+.TH "GIT\-NAME\-REV" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-P4IMPORT" "1" "01/13/2007" "" ""
+.TH "GIT\-P4IMPORT" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-PACK\-OBJECTS" "1" "11/08/2006" "" ""
+.TH "GIT\-PACK\-OBJECTS" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.fi
.SH "DESCRIPTION"
Reads list of objects from the standard input, and writes a packed archive with specified base\-name, or to the standard output.
-.sp
+
A packed archive is an efficient way to transfer set of objects between two repositories, and also is an archival format which is efficient to access. The packed archive format (.pack) is designed to be unpackable without having anything else, but for random access, accompanied with the pack index file (.idx).
-.sp
+
\fIgit\-unpack\-objects\fR command can read the packed archive and expand the objects contained in the pack into "one\-file one\-object" format; this is typically done by the smart\-pull commands when a pack is created on\-the\-fly for efficient network transport by their peers.
-.sp
+
Placing both in the pack/ subdirectory of $GIT_OBJECT_DIRECTORY (or any of the directories on $GIT_ALTERNATE_OBJECT_DIRECTORIES) enables git to read from such an archive.
-.sp
+
In a packed archive, an object is either stored as a compressed whole, or as a difference from some other object. The latter is often called a delta.
-.sp
.SH "OPTIONS"
.TP
base\-name
Write the pack contents (what would have been written to .pack file) out to the standard output.
.TP
\-\-revs
-Read the revision arguments from the standard input, instead of individual object names. The revision arguments are processed the same way as
-\fBgit\-rev\-list\fR(1)
-with
-\-\-objects
-flag uses its
-commit
-arguments to build the list of objects it outputs. The objects on the resulting list are packed.
+Read the revision arguments from the standard input, instead of individual object names. The revision arguments are processed the same way as \fBgit\-rev\-list\fR(1) with \-\-objects flag uses its commit arguments to build the list of objects it outputs. The objects on the resulting list are packed.
.TP
\-\-unpacked
-This implies
-\-\-revs. When processing the list of revision arguments read from the standard input, limit the objects packed to those that are not already packed.
+This implies \-\-revs. When processing the list of revision arguments read from the standard input, limit the objects packed to those that are not already packed.
.TP
\-\-all
-This implies
-\-\-revs. In addition to the list of revision arguments read from the standard input, pretend as if all refs under
-$GIT_DIR/refs
-are specified to be included.
+This implies \-\-revs. In addition to the list of revision arguments read from the standard input, pretend as if all refs under $GIT_DIR/refs are specified to be included.
.TP
\-\-window=[N], \-\-depth=[N]
These two options affect how the objects contained in the pack are stored using delta compression. The objects are first internally sorted by type, size and optionally names and compared against the other objects within \-\-window to see if using delta compression saves space. \-\-depth limits the maximum delta depth; making it too deep affects the performance on the unpacker side, because delta data needs to be applied that many times to get to the necessary object. The default value for both \-\-window and \-\-depth is 10.
This flag causes an object already in a pack ignored even if it appears in the standard input.
.TP
\-\-local
-This flag is similar to
-\-\-incremental; instead of ignoring all packed objects, it only ignores objects that are packed and not in the local object store (i.e. borrowed from an alternate).
+This flag is similar to \-\-incremental; instead of ignoring all packed objects, it only ignores objects that are packed and not in the local object store (i.e. borrowed from an alternate).
.TP
\-\-non\-empty
Only create a packed archive if it would contain at least one object.
A packed archive can express base object of a delta as either 20\-byte object name or as an offset in the stream, but older version of git does not understand the latter. By default, git\-pack\-objects only uses the former format for better compatibility. This option allows the command to use the latter format for compactness. Depending on the average delta chain length, this option typically shrinks the resulting packfile by 3\-5 per\-cent.
.SH "AUTHOR"
Written by Linus Torvalds <torvalds@osdl.org>
-.sp
.SH "DOCUMENTATION"
Documentation by Junio C Hamano
-.sp
.SH "SEE ALSO"
\fBgit\-rev\-list\fR(1) \fBgit\-repack\fR(1) \fBgit\-prune\-packed\fR(1)
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-PACK\-REDUNDANT" "1" "01/29/2007" "" ""
+.TH "GIT\-PACK\-REDUNDANT" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-PACK\-REFS" "1" "01/26/2007" "" ""
+.TH "GIT\-PACK\-REFS" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-PARSE\-REMOTE" "1" "01/19/2007" "" ""
+.TH "GIT\-PARSE\-REMOTE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-PATCH\-ID" "1" "01/19/2007" "" ""
+.TH "GIT\-PATCH\-ID" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-PEEK\-REMOTE" "1" "01/25/2007" "" ""
+.TH "GIT\-PEEK\-REMOTE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-PRUNE\-PACKED" "1" "01/19/2007" "" ""
+.TH "GIT\-PRUNE\-PACKED" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-PRUNE" "1" "01/29/2007" "" ""
+.TH "GIT\-PRUNE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-PULL" "1" "03/02/2007" "" ""
+.TH "GIT\-PULL" "1" "04/04/2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-PUSH" "1" "03/02/2007" "" ""
+.TH "GIT\-PUSH" "1" "04/04/2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-QUILTIMPORT" "1" "03/02/2007" "" ""
+.TH "GIT\-QUILTIMPORT" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-READ\-TREE" "1" "12/13/2006" "" ""
+.TH "GIT\-READ\-TREE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-REBASE" "1" "03/02/2007" "" ""
+.TH "GIT\-REBASE" "1" "04/04/2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-RECEIVE\-PACK" "1" "03/12/2007" "" ""
+.TH "GIT\-RECEIVE\-PACK" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-REFLOG" "1" "02/09/2007" "" ""
+.TH "GIT\-REFLOG" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-RELINK" "1" "10/03/2006" "" ""
+.TH "GIT\-RELINK" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-relink \- Hardlink common objects in local repositories
.SH "SYNOPSIS"
\fIgit\-relink\fR [\-\-safe] <dir> <dir> [<dir>]*
-.sp
.SH "DESCRIPTION"
This will scan 2 or more object repositories and look for common objects, check if they are hardlinked, and replace one with a hardlink to the other if not.
-.sp
.SH "OPTIONS"
.TP
\-\-safe
Directories containing a .git/objects/ subdirectory.
.SH "AUTHOR"
Written by Ryan Anderson <ryan@michonline.com>
-.sp
.SH "DOCUMENTATION"
Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-REMOTE" "1" "03/01/2007" "" ""
+.TH "GIT\-REMOTE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-REPACK" "1" "02/12/2007" "" ""
+.TH "GIT\-REPACK" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-REPO\-CONFIG" "1" "01/29/2007" "" ""
+.TH "GIT\-REPO\-CONFIG" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-REQUEST\-PULL" "1" "10/03/2006" "" ""
+.TH "GIT\-REQUEST\-PULL" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-request\-pull \- Generates a summary of pending changes
.SH "SYNOPSIS"
\fIgit\-request\-pull\fR <start> <url> [<end>]
-.sp
.SH "DESCRIPTION"
Summarizes the changes between two commits to the standard output, and includes the given URL in the generated summary.
-.sp
.SH "OPTIONS"
.TP
<start>
Commit to send at; defaults to HEAD.
.SH "AUTHOR"
Written by Ryan Anderson <ryan@michonline.com> and Junio C Hamano <junkio@cox.net>
-.sp
.SH "DOCUMENTATION"
Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-RERERE" "1" "02/18/2007" "" ""
+.TH "GIT\-RERERE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-RESET" "1" "02/18/2007" "" ""
+.TH "GIT\-RESET" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-REV\-LIST" "1" "03/02/2007" "" ""
+.TH "GIT\-REV\-LIST" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
[ [\-\-objects | \-\-objects\-edge] [ \-\-unpacked ] ]
[ \-\-pretty | \-\-header ]
[ \-\-bisect ]
+ [ \-\-bisect\-vars ]
[ \-\-merge ]
[ \-\-reverse ]
[ \-\-walk\-reflogs ]
$ git\-rev\-list midpoint ^bar ^baz
.fi
would be of roughly the same length. Finding the change which introduces a regression is thus reduced to a binary search: repeatedly generate and test new 'midpoint's until the commit chain is of length one.
+.TP
+\-\-bisect\-vars
+This calculates the same as \-\-bisect, but outputs text ready to be eval'ed by the shell. These lines will assign the name of the midpoint revision to the variable bisect_rev, and the expected number of commits to be tested after bisect_rev is tested to bisect_nr, the expected number of commits to be tested if bisect_rev turns out to be good to bisect_good, the expected number of commits to be tested if bisect_rev turns out to be bad to bisect_bad, and the number of commits we are bisecting right now to bisect_all.
.SS "Commit Ordering"
By default, the commits are shown in reverse chronological order.
.TP
.\" 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\-REV\-PARSE" "1" "03/30/2007" "" ""
+.TH "GIT\-REV\-PARSE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-REVERT" "1" "01/18/2007" "" ""
+.TH "GIT\-REVERT" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-RM" "1" "01/16/2007" "" ""
+.TH "GIT\-RM" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-RUNSTATUS" "1" "02/18/2007" "" ""
+.TH "GIT\-RUNSTATUS" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-SEND\-EMAIL" "1" "03/19/2007" "" ""
+.TH "GIT\-SEND\-EMAIL" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-SEND\-PACK" "1" "02/04/2007" "" ""
+.TH "GIT\-SEND\-PACK" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-SH\-SETUP" "1" "01/17/2007" "" ""
+.TH "GIT\-SH\-SETUP" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-SHELL" "1" "01/19/2007" "" ""
+.TH "GIT\-SHELL" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-SHORTLOG" "1" "01/17/2007" "" ""
+.TH "GIT\-SHORTLOG" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-SHOW\-BRANCH" "1" "02/05/2007" "" ""
+.TH "GIT\-SHOW\-BRANCH" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-SHOW\-INDEX" "1" "10/03/2006" "" ""
+.TH "GIT\-SHOW\-INDEX" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-show\-index \- Show packed archive index
.SH "SYNOPSIS"
\fIgit\-show\-index\fR < idx\-file
-.sp
.SH "DESCRIPTION"
Reads given idx file for packed git archive created with git\-pack\-objects command, and dumps its contents.
-.sp
+
The information it outputs is subset of what you can get from \fIgit\-verify\-pack \-v\fR; this command only shows the packfile offset and SHA1 of each object.
-.sp
.SH "AUTHOR"
Written by Linus Torvalds <torvalds@osdl.org>
-.sp
.SH "DOCUMENTATION"
Documentation by Junio C Hamano
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-SHOW\-REF" "1" "11/02/2006" "" ""
+.TH "GIT\-SHOW\-REF" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.fi
.SH "DESCRIPTION"
Displays references available in a local repository along with the associated commit IDs. Results can be filtered using a pattern and tags can be dereferenced into object IDs. Additionally, it can be used to test whether a particular ref exists.
-.sp
+
Use of this utility is encouraged in favor of directly accessing files under in the .git directory.
-.sp
.SH "OPTIONS"
.TP
\-h, \-\-head
Only show the SHA1 hash, not the reference name. When also using \-\-dereference the dereferenced tag will still be shown after the SHA1.
.TP
\-\-verify
-Enable stricter reference checking by requiring an exact ref path. Aside from returning an error code of 1, it will also print an error message if
-\fI\-\-quiet\fR
-was not specified.
+Enable stricter reference checking by requiring an exact ref path. Aside from returning an error code of 1, it will also print an error message if \fI\-\-quiet\fR was not specified.
.TP
\-\-abbrev, \-\-abbrev=len
-Abbreviate the object name. When using
-\-\-hash, you do not have to say
-\-\-hash \-\-abbrev;
-\-\-hash=len
-would do.
+Abbreviate the object name. When using \-\-hash, you do not have to say \-\-hash \-\-abbrev; \-\-hash=len would do.
.TP
\-q, \-\-quiet
-Do not print any results to stdout. When combined with
-\fI\-\-verify\fR
-this can be used to silently check if a reference exists.
+Do not print any results to stdout. When combined with \fI\-\-verify\fR this can be used to silently check if a reference exists.
.TP
<pattern>
Show references matching one or more patterns.
.SH "OUTPUT"
The output is in the format: \fI<SHA\-1 ID>\fR \fI<space>\fR \fI<reference name>\fR.
.sp
-.sp
.nf
$ git show\-ref \-\-head \-\-dereference
832e76a9899f560a90ffd62ae2ce83bbeff58f54 HEAD
.fi
When using \-\-hash (and not \-\-dereference) the output format is: \fI<SHA\-1 ID>\fR
.sp
-.sp
.nf
$ git show\-ref \-\-heads \-\-hash
2e3ba0114a1f52b47df29743d6915d056be13278
.SH "EXAMPLE"
To show all references called "master", whether tags or heads or anything else, and regardless of how deep in the reference naming hierarchy they are, use:
.sp
-.sp
.nf
git show\-ref master
.fi
This will show "refs/heads/master" but also "refs/remote/other\-repo/master", if such references exists.
-.sp
+
When using the \fI\-\-verify\fR flag, the command requires an exact path:
.sp
-.sp
.nf
git show\-ref \-\-verify refs/heads/master
.fi
will only match the exact branch called "master".
-.sp
+
If nothing matches, \fBgit\-show\-ref\fR(1) will return an error code of 1, and in the case of verification, it will show an error message.
-.sp
+
For scripting, you can ask it to be quiet with the "\-\-quiet" flag, which allows you to do things like
.sp
-.sp
.nf
git\-show\-ref \-\-quiet \-\-verify \-\- "refs/heads/$headname" ||
echo "$headname is not a valid branch"
.fi
to check whether a particular branch exists or not (notice how we don't actually want to show any results, and we want to use the full refname for it in order to not trigger the problem with ambiguous partial matches).
-.sp
+
To show only tags, or only proper branch heads, use "\-\-tags" and/or "\-\-heads" respectively (using both means that it shows tags and heads, but not other random references under the refs/ subdirectory).
-.sp
+
To do automatic tag object dereferencing, use the "\-d" or "\-\-dereference" flag, so you can do
.sp
-.sp
.nf
git show\-ref \-\-tags \-\-dereference
.fi
to get a listing of all tags together with what they dereference.
-.sp
.SH "SEE ALSO"
\fBgit\-ls\-remote\fR(1), \fBgit\-peek\-remote\fR(1)
-.sp
.SH "AUTHORS"
Written by Linus Torvalds <torvalds@osdl.org>. Man page by Jonas Fonseca <fonseca@diku.dk>.
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-SHOW" "1" "03/02/2007" "" ""
+.TH "GIT\-SHOW" "1" "04/04/2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-SSH\-FETCH" "1" "01/19/2007" "" ""
+.TH "GIT\-SSH\-FETCH" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-SSH\-UPLOAD" "1" "01/19/2007" "" ""
+.TH "GIT\-SSH\-UPLOAD" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-STATUS" "1" "02/18/2007" "" ""
+.TH "GIT\-STATUS" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-STRIPSPACE" "1" "10/03/2006" "" ""
+.TH "GIT\-STRIPSPACE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-stripspace \- Filter out empty lines
.SH "SYNOPSIS"
\fIgit\-stripspace\fR < <stream>
-.sp
.SH "DESCRIPTION"
Remove multiple empty lines, and empty lines at beginning and end.
-.sp
.SH "OPTIONS"
.TP
<stream>
Byte stream to act on.
.SH "AUTHOR"
Written by Linus Torvalds <torvalds@osdl.org>
-.sp
.SH "DOCUMENTATION"
Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-SVN" "1" "03/14/2007" "" ""
+.TH "GIT\-SVN" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-SVNIMPORT" "1" "03/30/2007" "" ""
+.TH "GIT\-SVNIMPORT" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-SYMBOLIC\-REF" "1" "02/05/2007" "" ""
+.TH "GIT\-SYMBOLIC\-REF" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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" "02/12/2007" "" ""
+.TH "GIT\-TAG" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-TAR\-TREE" "1" "01/19/2007" "" ""
+.TH "GIT\-TAR\-TREE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-UNPACK\-FILE" "1" "10/03/2006" "" ""
+.TH "GIT\-UNPACK\-FILE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-unpack\-file \- Creates a temporary file with a blob's contents
.SH "SYNOPSIS"
\fIgit\-unpack\-file\fR <blob>
-.sp
.SH "DESCRIPTION"
Creates a file holding the contents of the blob specified by sha1. It returns the name of the temporary file in the following format: .merge_file_XXXXX
-.sp
.SH "OPTIONS"
.TP
<blob>
Must be a blob id
.SH "AUTHOR"
Written by Linus Torvalds <torvalds@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
+
.\" 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\-UNPACK\-OBJECTS" "1" "10/03/2006" "" ""
+.TH "GIT\-UNPACK\-OBJECTS" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-unpack\-objects \- Unpack objects from a packed archive
.SH "SYNOPSIS"
\fIgit\-unpack\-objects\fR [\-n] [\-q] [\-r] <pack\-file
-.sp
.SH "DESCRIPTION"
Read a packed archive (.pack) from the standard input, expanding the objects contained within and writing them into the repository in "loose" (one object per file) format.
-.sp
+
Objects that already exist in the repository will \fBnot\fR be unpacked from the pack\-file. Therefore, nothing will be unpacked if you use this command on a pack\-file that exists within the target repository.
-.sp
+
Please see the git\-repack documentation for options to generate new packs and replace existing ones.
-.sp
.SH "OPTIONS"
.TP
\-n
When unpacking a corrupt packfile, the command dies at the first corruption. This flag tells it to keep going and make the best effort to recover as many objects as possible.
.SH "AUTHOR"
Written by Linus Torvalds <torvalds@osdl.org>
-.sp
.SH "DOCUMENTATION"
Documentation by Junio C Hamano
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-UPDATE\-INDEX" "1" "03/05/2007" "" ""
+.TH "GIT\-UPDATE\-INDEX" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-UPDATE\-REF" "1" "01/19/2007" "" ""
+.TH "GIT\-UPDATE\-REF" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-UPDATE\-SERVER\-IN" "1" "10/03/2006" "" ""
+.TH "GIT\-UPDATE\-SERVER\-IN" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-update\-server\-info \- Update auxiliary info file to help dumb servers
.SH "SYNOPSIS"
\fIgit\-update\-server\-info\fR [\-\-force]
-.sp
.SH "DESCRIPTION"
A dumb server that does not do on\-the\-fly pack generations must have some auxiliary information files in $GIT_DIR/info and $GIT_OBJECT_DIRECTORY/info directories to help clients discover what references and packs the server has. This command generates such auxiliary files.
-.sp
.SH "OPTIONS"
.TP
\-f|\-\-force
Update the info files from scratch.
.SH "OUTPUT"
Currently the command updates the following files. Please see [1]\&\fIrepository\-layout\fR for description of what they are for:
-.sp
.TP 3
\(bu
objects/info/packs
info/refs
.SH "BUGS"
When you remove an existing ref, the command fails to update info/refs file unless \-\-force flag is given.
-.sp
.SH "AUTHOR"
Written by Junio C Hamano <junkio@cox.net>
-.sp
.SH "DOCUMENTATION"
Documentation by Junio C Hamano.
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
.SH "REFERENCES"
.TP 3
1.\ repository\-layout
.\" 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\-UPLOAD\-ARCHIVE" "1" "01/19/2007" "" ""
+.TH "GIT\-UPLOAD\-ARCHIVE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-UPLOAD\-PACK" "1" "03/05/2007" "" ""
+.TH "GIT\-UPLOAD\-PACK" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-VAR" "1" "01/29/2007" "" ""
+.TH "GIT\-VAR" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-VERIFY\-PACK" "1" "10/03/2006" "" ""
+.TH "GIT\-VERIFY\-PACK" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-verify\-pack \- Validate packed git archive files
.SH "SYNOPSIS"
\fIgit\-verify\-pack\fR [\-v] [\-\-] <pack>.idx \&...
-.sp
.SH "DESCRIPTION"
Reads given idx file for packed git archive created with git\-pack\-objects command and verifies idx file and the corresponding pack file.
-.sp
.SH "OPTIONS"
.TP
<pack>.idx \&...
.SH "OUTPUT FORMAT"
When specifying the \-v option the format used is:
.sp
-.sp
.nf
SHA1 type size offset\-in\-packfile
.fi
for objects that are not deltified in the pack, and
.sp
-.sp
.nf
SHA1 type size offset\-in\-packfile depth base\-SHA1
.fi
for objects that are deltified.
-.sp
.SH "AUTHOR"
Written by Junio C Hamano <junkio@cox.net>
-.sp
.SH "DOCUMENTATION"
Documentation by Junio C Hamano
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-VERIFY\-TAG" "1" "10/03/2006" "" ""
+.TH "GIT\-VERIFY\-TAG" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
git\-verify\-tag \- Check the GPG signature of tag
.SH "SYNOPSIS"
\fIgit\-verify\-tag\fR <tag>
-.sp
.SH "DESCRIPTION"
Validates the gpg signature created by git\-tag.
-.sp
.SH "OPTIONS"
.TP
<tag>
SHA1 identifier of a git tag object.
.SH "AUTHOR"
Written by Jan Harkes <jaharkes@cs.cmu.edu> and Eric W. Biederman <ebiederm@xmission.com>
-.sp
.SH "DOCUMENTATION"
Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
-.sp
.SH "GIT"
Part of the \fBgit\fR(7) suite
-.sp
+
.\" 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\-WHATCHANGED" "1" "01/17/2007" "" ""
+.TH "GIT\-WHATCHANGED" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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\-WRITE\-TREE" "1" "01/19/2007" "" ""
+.TH "GIT\-WRITE\-TREE" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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 "GITK" "1" "02/04/2007" "" ""
+.TH "GITK" "1" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.\" 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" "7" "04/04/2007" "" ""
+.TH "GIT" "7" "04/04/2007" "Git 1.5.1.31.ge421f" "Git Manual"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)