-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-ADD" 1 "" "" ""
-.SH NAME
-git-add \- Add files to the index file
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-add \- Add files to the index file
.SH "SYNOPSIS"
-
-
-\fIgit\-add\fR [\-n] [\-v] [\-\-] <file>...
-
+\fIgit\-add\fR [\-n] [\-v] [\-\-] <file>\&...
+.sp
.SH "DESCRIPTION"
-
-
-A simple wrapper for git\-update\-index to add files to the index, for people used to do "cvs add"\&.
-
-
-It only adds non\-ignored files, to add ignored files use "git update\-index \-\-add"\&.
-
+A simple wrapper for git\-update\-index to add files to the index, for people used to do "cvs add".
+.sp
+It only adds non\-ignored files, to add ignored files use "git update\-index \-\-add".
+.sp
.SH "OPTIONS"
-
.TP
-<file>...
-Files to add to the index (see \fBgit\-ls\-files\fR(1))\&.
-
+<file>\&...
+Files to add to the index (see
+\fBgit\-ls\-files\fR(1)).
.TP
\-n
-Don't actually add the file(s), just show if they exist\&.
-
+Don't actually add the file(s), just show if they exist.
.TP
\-v
-Be verbose\&.
-
+Be verbose.
.TP
\-\-
-This option can be used to separate command\-line options from the list of files, (useful when filenames might be mistaken for command\-line options)\&.
-
+This option can be used to separate command\-line options from the list of files, (useful when filenames might be mistaken for command\-line options).
.SH "DISCUSSION"
-
-
-The list of <file> given to the command is fed to git\-ls\-files command to list files that are not registered in the index and are not ignored/excluded by $GIT_DIR/info/exclude file or \&.gitignore file in each directory\&. This means two things:
-
+The list of <file> given to the command is fed to git\-ls\-files command to list files that are not registered in the index and are not ignored/excluded by $GIT_DIR/info/exclude file or .gitignore file in each directory. This means two things:
+.sp
.TP 3
1.
You can put the name of a directory on the command line, and the command will add all files in it and its subdirectories;
.TP
2.
-Giving the name of a file that is already in index does not run git\-update\-index on that path\&.
-.LP
-
+Giving the name of a file that is already in index does not run
+git\-update\-index
+on that path.
.SH "EXAMPLES"
-
.TP
-git\-add Documentation/\\*\&.txt
-Adds all *\&.txt files that are not in the index under Documentation directory and its subdirectories\&.
-
-Note that the asterisk * is quoted from the shell in this example; this lets the command to include the files from subdirectories of Documentation/ directory\&.
-
+git\-add Documentation/\\*.txt
+Adds all
+*.txt
+files that are not in the index under
+Documentation
+directory and its subdirectories.
+.sp
+Note that the asterisk
+*
+is quoted from the shell in this example; this lets the command to include the files from subdirectories of
+Documentation/
+directory.
.TP
-git\-add git\-*\&.sh
-Adds all git\-*\&.sh scripts that are not in the index\&. Because this example lets shell expand the asterisk (i\&.e\&. you are listing the files explicitly), it does not add subdir/git\-foo\&.sh to the index\&.
-
+git\-add git\-*.sh
+Adds all git\-*.sh scripts that are not in the index. Because this example lets shell expand the asterisk (i.e. you are listing the files explicitly), it does not add
+subdir/git\-foo.sh
+to the index.
.SH "SEE ALSO"
-
-
\fBgit\-rm\fR(1) \fBgit\-ls\-files\fR(1)
-
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+Written by Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-AM" 1 "" "" ""
-.SH NAME
-git-am \- Apply a series of patches in a mailbox
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-am \- Apply a series of patches in a mailbox
.SH "SYNOPSIS"
-
+.sp
.nf
\fIgit\-am\fR [\-\-signoff] [\-\-dotest=<dir>] [\-\-utf8] [\-\-binary] [\-\-3way]
- [\-\-interactive] [\-\-whitespace=<option>] <mbox>...
+ [\-\-interactive] [\-\-whitespace=<option>] <mbox>\&...
\fIgit\-am\fR [\-\-skip | \-\-resolved]
.fi
-
.SH "DESCRIPTION"
-
-
-Splits mail messages in a mailbox into commit log message, authorship information and patches, and applies them to the current branch\&.
-
+Splits mail messages in a mailbox into commit log message, authorship information and patches, and applies them to the current branch.
+.sp
.SH "OPTIONS"
-
.TP
\-\-signoff
-Add Signed\-off\-by: line to the commit message, using the committer identity of yourself\&.
-
+Add
+Signed\-off\-by:
+line to the commit message, using the committer identity of yourself.
.TP
\-\-dotest=<dir>
-Instead of \&.dotest directory, use <dir> as a working area to store extracted patches\&.
-
+Instead of
+.dotest
+directory, use <dir> as a working area to store extracted patches.
.TP
\-\-utf8, \-\-keep
-Pass \-u and \-k flags to git\-mailinfo (see \fBgit\-mailinfo\fR(1))\&.
-
+Pass
+\-u
+and
+\-k
+flags to
+git\-mailinfo
+(see
+\fBgit\-mailinfo\fR(1)).
.TP
\-\-binary
-Pass \-\-allow\-binary\-replacement flag to git\-apply (see \fBgit\-apply\fR(1))\&.
-
+Pass
+\-\-allow\-binary\-replacement
+flag to
+git\-apply
+(see
+\fBgit\-apply\fR(1)).
.TP
\-\-3way
-When the patch does not apply cleanly, fall back on 3\-way merge, if the patch records the identity of blobs it is supposed to apply to, and we have those blobs locally\&.
-
+When the patch does not apply cleanly, fall back on 3\-way merge, if the patch records the identity of blobs it is supposed to apply to, and we have those blobs locally.
.TP
\-\-skip
-Skip the current patch\&. This is only meaningful when restarting an aborted patch\&.
-
+Skip the current patch. This is only meaningful when restarting an aborted patch.
.TP
\-\-whitespace=<option>
-This flag is passed to the git\-apply program that applies the patch\&.
-
+This flag is passed to the
+git\-apply
+program that applies the patch.
.TP
\-\-interactive
-Run interactively, just like git\-applymbox\&.
-
+Run interactively, just like git\-applymbox.
.TP
\-\-resolved
-After a patch failure (e\&.g\&. attempting to apply conflicting patch), the user has applied it by hand and the index file stores the result of the application\&. Make a commit using the authorship and commit log extracted from the e\-mail message and the current index file, and continue\&.
-
+After a patch failure (e.g. attempting to apply conflicting patch), the user has applied it by hand and the index file stores the result of the application. Make a commit using the authorship and commit log extracted from the e\-mail message and the current index file, and continue.
.SH "DISCUSSION"
-
-
-When initially invoking it, you give it names of the mailboxes to crunch\&. Upon seeing the first patch that does not apply, it aborts in the middle, just like \fIgit\-applymbox\fR does\&. You can recover from this in one of two ways:
-
+When initially invoking it, you give it names of the mailboxes to crunch. Upon seeing the first patch that does not apply, it aborts in the middle, just like \fIgit\-applymbox\fR does. You can recover from this in one of two ways:
+.sp
.TP 3
1.
-skip the current one by re\-running the command with \fI\-\-skip\fR option\&.
+skip the current one by re\-running the command with
+\fI\-\-skip\fR
+option.
.TP
2.
-hand resolve the conflict in the working directory, and update the index file to bring it in a state that the patch should have produced\&. Then run the command with \fI\-\-resolved\fR option\&.
-.LP
-
-
-The command refuses to process new mailboxes while \&.dotest directory exists, so if you decide to start over from scratch, run rm \-f \&.dotest before running the command with mailbox names\&.
-
+hand resolve the conflict in the working directory, and update the index file to bring it in a state that the patch should have produced. Then run the command with
+\fI\-\-resolved\fR
+option.
+The command refuses to process new mailboxes while .dotest directory exists, so if you decide to start over from scratch, run rm \-f .dotest before running the command with mailbox names.
+.sp
.SH "SEE ALSO"
-
-
-\fBgit\-applymbox\fR(1), \fBgit\-applypatch\fR(1), \fBgit\-apply\fR(1)\&.
-
+\fBgit\-applymbox\fR(1), \fBgit\-applypatch\fR(1), \fBgit\-apply\fR(1).
+.sp
.SH "AUTHOR"
-
-
-Written by Junio C Hamano <junkio@cox\&.net>
-
+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>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-ANNOTATE" 1 "" "" ""
-.SH NAME
-git-annotate \- Annotate file lines with commit info
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+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\&.
-
+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 long rev (Defaults off)\&.
-
+Show long rev (Defaults off).
.TP
\-t, \-\-time
-Show raw timestamp (Defaults off)\&.
-
+Show raw timestamp (Defaults off).
.TP
\-r, \-\-rename
-Follow renames (Defaults on)\&.
-
+Follow renames (Defaults on).
.TP
\-S, \-\-rev\-file <revs\-file>
-Use revs from revs\-file instead of calling git\-rev\-list\&.
-
+Use revs from revs\-file instead of calling git\-rev\-list.
.TP
\-h, \-\-help
-Show help message\&.
-
+Show help message.
.SH "SEE ALSO"
-
-
\fBgit\-blame\fR(1)
-
+.sp
.SH "AUTHOR"
-
-
-Written by Ryan Anderson <ryan@michonline\&.com>\&.
-
+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" "09/18/2006" "" ""
+.TH "GIT\-APPLY" "1" "10/03/2006" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-APPLYMBOX" 1 "" "" ""
-.SH NAME
-git-applymbox \- Apply a series of patches in a mailbox
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-applymbox \- Apply a series of patches in a mailbox
.SH "SYNOPSIS"
-
-
-\fIgit\-applymbox\fR [\-u] [\-k] [\-q] [\-m] ( \-c \&.dotest/<num> | <mbox> ) [ <signoff> ]
-
+\fIgit\-applymbox\fR [\-u] [\-k] [\-q] [\-m] ( \-c .dotest/<num> | <mbox> ) [ <signoff> ]
+.sp
.SH "DESCRIPTION"
-
-
-Splits mail messages in a mailbox into commit log message, authorship information and patches, and applies them to the current branch\&.
-
+Splits mail messages in a mailbox into commit log message, authorship information and patches, and applies them to the current branch.
+.sp
.SH "OPTIONS"
-
.TP
\-q
-Apply patches interactively\&. The user will be given opportunity to edit the log message and the patch before attempting to apply it\&.
-
+Apply patches interactively. The user will be given opportunity to edit the log message and the patch before attempting to apply it.
.TP
\-k
-Usually the program \fIcleans up\fR the Subject: header line to extract the title line for the commit log message, among which (1) remove \fIRe:\fR or \fIre:\fR, (2) leading whitespaces, (3) \fI[\fR up to \fI]\fR, typically \fI[PATCH]\fR, and then prepends "[PATCH] "\&. This flag forbids this munging, and is most useful when used to read back \fIgit format\-patch \-\-mbox\fR output\&.
-
+Usually the program
+\fIcleans up\fR
+the Subject: header line to extract the title line for the commit log message, among which (1) remove
+\fIRe:\fR
+or
+\fIre:\fR, (2) leading whitespaces, (3)
+\fI[\fR
+up to
+\fI]\fR, typically
+\fI[PATCH]\fR, and then prepends "[PATCH] ". This flag forbids this munging, and is most useful when used to read back
+\fIgit format\-patch \-\-mbox\fR
+output.
.TP
\-m
-Patches are applied with git\-apply command, and unless it cleanly applies without fuzz, the processing fails\&. With this flag, if a tree that the patch applies cleanly is found in a repository, the patch is applied to the tree and then a 3\-way merge between the resulting tree and the current tree\&.
-
+Patches are applied with
+git\-apply
+command, and unless it cleanly applies without fuzz, the processing fails. With this flag, if a tree that the patch applies cleanly is found in a repository, the patch is applied to the tree and then a 3\-way merge between the resulting tree and the current tree.
.TP
\-u
-By default, the commit log message, author name and author email are taken from the e\-mail without any charset conversion, after minimally decoding MIME transfer encoding\&. This flag causes the resulting commit to be encoded in utf\-8 by transliterating them\&. Note that the patch is always used as is without charset conversion, even with this flag\&.
-
+By default, the commit log message, author name and author email are taken from the e\-mail without any charset conversion, after minimally decoding MIME transfer encoding. This flag causes the resulting commit to be encoded in utf\-8 by transliterating them. Note that the patch is always used as is without charset conversion, even with this flag.
.TP
-\-c \&.dotest/<num>
-When the patch contained in an e\-mail does not cleanly apply, the command exits with an error message\&. The patch and extracted message are found in \&.dotest/, and you could re\-run \fIgit applymbox\fR with \fI\-c \&.dotest/<num>\fR flag to restart the process after inspecting and fixing them\&.
-
+\-c .dotest/<num>
+When the patch contained in an e\-mail does not cleanly apply, the command exits with an error message. The patch and extracted message are found in .dotest/, and you could re\-run
+\fIgit applymbox\fR
+with
+\fI\-c .dotest/<num>\fR
+flag to restart the process after inspecting and fixing them.
.TP
<mbox>
-The name of the file that contains the e\-mail messages with patches\&. This file should be in the UNIX mailbox format\&. See \fISubmittingPatches\fR document to learn about the formatting convention for e\-mail submission\&.
-
+The name of the file that contains the e\-mail messages with patches. This file should be in the UNIX mailbox format. See
+\fISubmittingPatches\fR
+document to learn about the formatting convention for e\-mail submission.
.TP
<signoff>
-The name of the file that contains your "Signed\-off\-by" line\&. See \fISubmittingPatches\fR document to learn what "Signed\-off\-by" line means\&. You can also just say \fIyes\fR, \fItrue\fR, \fIme\fR, or \fIplease\fR to use an automatically generated "Signed\-off\-by" line based on your committer identity\&.
-
+The name of the file that contains your "Signed\-off\-by" line. See
+\fISubmittingPatches\fR
+document to learn what "Signed\-off\-by" line means. You can also just say
+\fIyes\fR,
+\fItrue\fR,
+\fIme\fR, or
+\fIplease\fR
+to use an automatically generated "Signed\-off\-by" line based on your committer identity.
.SH "SEE ALSO"
-
-
-\fBgit\-am\fR(1), \fBgit\-applypatch\fR(1)\&.
-
+\fBgit\-am\fR(1), \fBgit\-applypatch\fR(1).
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+Written by Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-APPLYPATCH" 1 "" "" ""
-.SH NAME
-git-applypatch \- Apply one patch extracted from an e-mail
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-applypatch \- Apply one patch extracted from an e\-mail
.SH "SYNOPSIS"
-
-
\fIgit\-applypatch\fR <msg> <patch> <info> [<signoff>]
-
+.sp
.SH "DESCRIPTION"
-
-
-Takes three files <msg>, <patch>, and <info> prepared from an e\-mail message by \fIgit\-mailinfo\fR, and creates a commit\&. It is usually not necessary to use this command directly\&.
-
-
-This command can run applypatch\-msg, pre\-applypatch, and post\-applypatch hooks\&. See hooks: \fIhooks.html\fR for more information\&.
-
+Takes three files <msg>, <patch>, and <info> prepared from an e\-mail message by \fIgit\-mailinfo\fR, and creates a commit. It is usually not necessary to use this command directly.
+.sp
+This command can run applypatch\-msg, pre\-applypatch, and post\-applypatch hooks. See [1]\&\fIhooks\fR for more information.
+.sp
.SH "OPTIONS"
-
.TP
<msg>
-Commit log message (sans the first line, which comes from e\-mail Subject stored in <info>)\&.
-
+Commit log message (sans the first line, which comes from e\-mail Subject stored in <info>).
.TP
<patch>
-The patch to apply\&.
-
+The patch to apply.
.TP
<info>
-Author and subject information extracted from e\-mail, used on "author" line and as the first line of the commit log message\&.
-
+Author and subject information extracted from e\-mail, used on "author" line and as the first line of the commit log message.
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+Written by Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
+.SH "REFERENCES"
+.TP 3
+1.\ hooks
+\%hooks.html
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-ARCHIMPORT" 1 "" "" ""
-.SH NAME
-git-archimport \- Import an Arch repository into git
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-archimport \- Import an Arch repository into git
.SH "SYNOPSIS"
-
+.sp
.nf
\fIgit\-archimport\fR [\-h] [\-v] [\-o] [\-a] [\-f] [\-T] [\-D depth] [\-t tempdir]
<archive/branch> [ <archive/branch> ]
.fi
-
.SH "DESCRIPTION"
-
-
-Imports a project from one or more Arch repositories\&. It will follow branches and repositories within the namespaces defined by the <archive/branch> parameters supplied\&. If it cannot find the remote branch a merge comes from it will just import it as a regular commit\&. If it can find it, it will mark it as a merge whenever possible (see discussion below)\&.
-
-
-The script expects you to provide the key roots where it can start the import from an \fIinitial import\fR or \fItag\fR type of Arch commit\&. It will follow and import new branches within the provided roots\&.
-
-
-It expects to be dealing with one project only\&. If it sees branches that have different roots, it will refuse to run\&. In that case, edit your <archive/branch> parameters to define clearly the scope of the import\&.
-
-
-git\-archimport uses tla extensively in the background to access the Arch repository\&. Make sure you have a recent version of tla available in the path\&. tla must know about the repositories you pass to git\-archimport\&.
-
-
-For the initial import git\-archimport expects to find itself in an empty directory\&. To follow the development of a project that uses Arch, rerun git\-archimport with the same parameters as the initial import to perform incremental imports\&.
-
+Imports a project from one or more Arch repositories. It will follow branches and repositories within the namespaces defined by the <archive/branch> parameters supplied. If it cannot find the remote branch a merge comes from it will just import it as a regular commit. If it can find it, it will mark it as a merge whenever possible (see discussion below).
+.sp
+The script expects you to provide the key roots where it can start the import from an \fIinitial import\fR or \fItag\fR type of Arch commit. It will follow and import new branches within the provided roots.
+.sp
+It expects to be dealing with one project only. If it sees branches that have different roots, it will refuse to run. In that case, edit your <archive/branch> parameters to define clearly the scope of the import.
+.sp
+git\-archimport uses tla extensively in the background to access the Arch repository. Make sure you have a recent version of tla available in the path. tla must know about the repositories you pass to git\-archimport.
+.sp
+For the initial import git\-archimport expects to find itself in an empty directory. To follow the development of a project that uses Arch, rerun git\-archimport with the same parameters as the initial import to perform incremental imports.
+.sp
.SH "MERGES"
-
-
-Patch merge data from Arch is used to mark merges in git as well\&. git does not care much about tracking patches, and only considers a merge when a branch incorporates all the commits since the point they forked\&. The end result is that git will have a good idea of how far branches have diverged\&. So the import process does lose some patch\-trading metadata\&.
-
-
-Fortunately, when you try and merge branches imported from Arch, git will find a good merge base, and it has a good chance of identifying patches that have been traded out\-of\-sequence between the branches\&.
-
+Patch merge data from Arch is used to mark merges in git as well. git does not care much about tracking patches, and only considers a merge when a branch incorporates all the commits since the point they forked. The end result is that git will have a good idea of how far branches have diverged. So the import process does lose some patch\-trading metadata.
+.sp
+Fortunately, when you try and merge branches imported from Arch, git will find a good merge base, and it has a good chance of identifying patches that have been traded out\-of\-sequence between the branches.
+.sp
.SH "OPTIONS"
-
.TP
\-h
-Display usage\&.
-
+Display usage.
.TP
\-v
-Verbose output\&.
-
+Verbose output.
.TP
\-T
-Many tags\&. Will create a tag for every commit, reflecting the commit name in the Arch repository\&.
-
+Many tags. Will create a tag for every commit, reflecting the commit name in the Arch repository.
.TP
\-f
-Use the fast patchset import strategy\&. This can be significantly faster for large trees, but cannot handle directory renames or permissions changes\&. The default strategy is slow and safe\&.
-
+Use the fast patchset import strategy. This can be significantly faster for large trees, but cannot handle directory renames or permissions changes. The default strategy is slow and safe.
.TP
\-o
-Use this for compatibility with old\-style branch names used by earlier versions of git\-archimport\&. Old\-style branch names were category\-\-branch, whereas new\-style branch names are archive,category\-\-branch\-\-version\&.
-
+Use this for compatibility with old\-style branch names used by earlier versions of git\-archimport. Old\-style branch names were category\-\-branch, whereas new\-style branch names are archive,category\-\-branch\-\-version.
.TP
\-D <depth>
-Follow merge ancestry and attempt to import trees that have been merged from\&. Specify a depth greater than 1 if patch logs have been pruned\&.
-
+Follow merge ancestry and attempt to import trees that have been merged from. Specify a depth greater than 1 if patch logs have been pruned.
.TP
\-a
-Attempt to auto\-register archives at http://mirrors\&.sourcecontrol\&.net This is particularly useful with the \-D option\&.
-
+Attempt to auto\-register archives at http://mirrors.sourcecontrol.net This is particularly useful with the \-D option.
.TP
\-t <tmpdir>
-Override the default tempdir\&.
-
+Override the default tempdir.
.TP
<archive/branch>
-Archive/branch identifier in a format that tla log understands\&.
-
+Archive/branch identifier in a format that
+tla log
+understands.
.SH "AUTHOR"
-
-
-Written by Martin Langhoff <martin@catalyst\&.net\&.nz>\&.
-
+Written by Martin Langhoff <martin@catalyst.net.nz>.
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano, Martin Langhoff and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano, Martin Langhoff 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\-ARCHIVE" "1" "09/26/2006" "" ""
+.TH "GIT\-ARCHIVE" "1" "10/03/2006" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-BISECT" 1 "" "" ""
-.SH NAME
-git-bisect \- Find the change that introduced a bug
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-bisect \- Find the change that introduced a bug
.SH "SYNOPSIS"
-
-
\fIgit bisect\fR <subcommand> <options>
-
+.sp
.SH "DESCRIPTION"
-
-
The command takes various subcommands, and different options depending on the subcommand:
-
+.sp
+.sp
.nf
-git bisect start [<paths>\&.\&.\&.]
+git bisect start [<paths>...]
git bisect bad <rev>
git bisect good <rev>
git bisect reset [<branch>]
git bisect replay <logfile>
git bisect log
.fi
-
-
-This command uses \fIgit\-rev\-list \-\-bisect\fR option to help drive the binary search process to find which change introduced a bug, given an old "good" commit object name and a later "bad" commit object name\&.
-
-
+This command uses \fIgit\-rev\-list \-\-bisect\fR option to help drive the binary search process to find which change introduced a bug, given an old "good" commit object name and a later "bad" commit object name.
+.sp
The way you use it is:
-
+.sp
+.sp
.nf
$ git bisect start
$ git bisect bad # Current version is bad
-$ git bisect good v2\&.6\&.13\-rc2 # v2\&.6\&.13\-rc2 was the last version
+$ git bisect good v2.6.13\-rc2 # v2.6.13\-rc2 was the last version
# tested that was good
.fi
-
-
When you give at least one bad and one good versions, it will bisect the revision tree and say something like:
-
+.sp
+.sp
.nf
Bisecting: 675 revisions left to test after this
.fi
-
-
-and check out the state in the middle\&. Now, compile that kernel, and boot it\&. Now, let's say that this booted kernel works fine, then just do
-
+and check out the state in the middle. Now, compile that kernel, and boot it. Now, let's say that this booted kernel works fine, then just do
+.sp
+.sp
.nf
$ git bisect good # this one is good
.fi
-
-
which will now say
-
+.sp
+.sp
.nf
Bisecting: 337 revisions left to test after this
.fi
-
-
-and you continue along, compiling that one, testing it, and depending on whether it is good or bad, you say "git bisect good" or "git bisect bad", and ask for the next bisection\&.
-
-
-Until you have no more left, and you'll have been left with the first bad kernel rev in "refs/bisect/bad"\&.
-
-
+and you continue along, compiling that one, testing it, and depending on whether it is good or bad, you say "git bisect good" or "git bisect bad", and ask for the next bisection.
+.sp
+Until you have no more left, and you'll have been left with the first bad kernel rev in "refs/bisect/bad".
+.sp
Oh, and then after you want to reset to the original head, do a
-
+.sp
+.sp
.nf
$ git bisect reset
.fi
-
-
-to get back to the master branch, instead of being in one of the bisection branches ("git bisect start" will do that for you too, actually: it will reset the bisection state, and before it does that it checks that you're not using some old bisection branch)\&.
-
-
+to get back to the master branch, instead of being in one of the bisection branches ("git bisect start" will do that for you too, actually: it will reset the bisection state, and before it does that it checks that you're not using some old bisection branch).
+.sp
During the bisection process, you can say
-
+.sp
+.sp
.nf
$ git bisect visualize
.fi
-
-
-to see the currently remaining suspects in gitk\&.
-
-
-The good/bad input is logged, and git bisect log shows what you have done so far\&. You can truncate its output somewhere and save it in a file, and run
-
+to see the currently remaining suspects in gitk.
+.sp
+The good/bad input is logged, and git bisect log shows what you have done so far. You can truncate its output somewhere and save it in a file, and run
+.sp
+.sp
.nf
$ git bisect replay that\-file
.fi
-
-
-if you find later you made a mistake telling good/bad about a revision\&.
-
-
-If in a middle of bisect session, you know what the bisect suggested to try next is not a good one to test (e\&.g\&. the change the commit introduces is known not to work in your environment and you know it does not have anything to do with the bug you are chasing), you may want to find a near\-by commit and try that instead\&. It goes something like this:
-
+if you find later you made a mistake telling good/bad about a revision.
+.sp
+If in a middle of bisect session, you know what the bisect suggested to try next is not a good one to test (e.g. the change the commit introduces is known not to work in your environment and you know it does not have anything to do with the bug you are chasing), you may want to find a near\-by commit and try that instead. It goes something like this:
+.sp
+.sp
.nf
-$ git bisect good/bad # previous round was good/bad\&.
+$ git bisect good/bad # previous round was good/bad.
Bisecting: 337 revisions left to test after this
-$ git bisect visualize # oops, that is uninteresting\&.
+$ git bisect visualize # oops, that is uninteresting.
$ git reset \-\-hard HEAD~3 # try 3 revs before what
# was suggested
.fi
-
-
-Then compile and test the one you chose to try\&. After that, tell bisect what the result was as usual\&.
-
-
+Then compile and test the one you chose to try. After that, tell bisect what the result was as usual.
+.sp
You can further cut down the number of trials if you know what part of the tree is involved in the problem you are tracking down, by giving paths parameters when you say bisect start, like this:
-
+.sp
+.sp
.nf
$ git bisect start arch/i386 include/asm\-i386
.fi
-
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+Written by Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-BLAME" 1 "" "" ""
-.SH NAME
-git-blame \- Show what revision and author last modified each line of a file
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-blame \- Show what revision and author last modified each line of a file
.SH "SYNOPSIS"
-
-
\fIgit\-blame\fR [\-c] [\-l] [\-t] [\-S <revs\-file>] [\-\-] <file> [<rev>]
-
+.sp
.SH "DESCRIPTION"
-
-
-Annotates each line in the given file with information from the revision which last modified the line\&. Optionally, start annotating from the given revision\&.
-
-
-This report doesn't tell you anything about lines which have been deleted or replaced; you need to use a tool such as \fBgit\-diff\fR(1) or the "pickaxe" interface briefly mentioned in the following paragraph\&.
-
-
-Apart from supporting file annotation, git also supports searching the development history for when a code snippet occured in a change\&. This makes it possible to track when a code snippet was added to a file, moved or copied between files, and eventually deleted or replaced\&. It works by searching for a text string in the diff\&. A small example:
-
+Annotates each line in the given file with information from the revision which last modified the line. Optionally, start annotating from the given revision.
+.sp
+This report doesn't tell you anything about lines which have been deleted or replaced; you need to use a tool such as \fBgit\-diff\fR(1) or the "pickaxe" interface briefly mentioned in the following paragraph.
+.sp
+Apart from supporting file annotation, git also supports searching the development history for when a code snippet occured in a change. This makes it possible to track when a code snippet was added to a file, moved or copied between files, and eventually deleted or replaced. It works by searching for a text string in the diff. A small example:
+.sp
+.sp
.nf
$ git log \-\-pretty=oneline \-S'blame_usage'
5040f17eba15504bad66b14a645bddd9b015ebb7 blame \-S <ancestry\-file>
ea4c7f9bf69e781dd0cd88d2bccb2bf5cc15c9a7 git\-blame: Make the output
.fi
-
.SH "OPTIONS"
-
.TP
\-c, \-\-compatibility
-Use the same output mode as \fBgit\-annotate\fR(1) (Default: off)\&.
-
+Use the same output mode as
+\fBgit\-annotate\fR(1)
+(Default: off).
.TP
\-l, \-\-long
-Show long rev (Default: off)\&.
-
+Show long rev (Default: off).
.TP
\-t, \-\-time
-Show raw timestamp (Default: off)\&.
-
+Show raw timestamp (Default: off).
.TP
\-S, \-\-rev\-file <revs\-file>
-Use revs from revs\-file instead of calling \fBgit\-rev\-list\fR(1)\&.
-
+Use revs from revs\-file instead of calling
+\fBgit\-rev\-list\fR(1).
.TP
\-h, \-\-help
-Show help message\&.
-
+Show help message.
.SH "SEE ALSO"
-
-
\fBgit\-annotate\fR(1)
-
+.sp
.SH "AUTHOR"
-
-
-Written by Fredrik Kuivinen <freku045@student\&.liu\&.se>\&.
-
+Written by Fredrik Kuivinen <freku045@student.liu.se>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-BRANCH" 1 "" "" ""
-.SH NAME
-git-branch \- List, create, or delete branches.
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-branch \- List, create, or delete branches.
.SH "SYNOPSIS"
-
+.sp
.nf
\fIgit\-branch\fR [\-r]
\fIgit\-branch\fR [\-l] [\-f] <branchname> [<start\-point>]
-\fIgit\-branch\fR (\-d | \-D) <branchname>...
+\fIgit\-branch\fR (\-d | \-D) <branchname>\&...
.fi
-
.SH "DESCRIPTION"
-
-
-With no arguments given (or just \-r) a list of available branches will be shown, the current branch will be highlighted with an asterisk\&.
-
-
-In its second form, a new branch named <branchname> will be created\&. It will start out with a head equal to the one given as <start\-point>\&. If no <start\-point> is given, the branch will be created with a head equal to that of the currently checked out branch\&.
-
-
-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 no arguments given (or just \-r) a list of available branches will be shown, the current branch will be highlighted with an asterisk.
+.sp
+In its second form, a new branch named <branchname> will be created. It will start out with a head equal to the one given as <start\-point>. If no <start\-point> is given, the branch will be created with a head equal to that of the currently checked out branch.
+.sp
+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.
+.sp
.SH "OPTIONS"
-
.TP
\-d
-Delete a branch\&. The branch must be fully merged\&.
-
+Delete a branch. The branch must be fully merged.
.TP
\-D
-Delete a branch irrespective of its index status\&.
-
+Delete a branch irrespective of its index status.
.TP
\-l
-Create the branch's ref log\&. This activates recording of all changes to made the branch ref, enabling use of date
-
+Create the branch's ref log. This activates recording of all changes to made the branch ref, enabling use of date
.TP
\-f
-Force the creation of a new branch even if it means deleting a branch that already exists with the same name\&.
-
+Force the creation of a new branch even if it means deleting a branch that already exists with the same name.
.TP
\-r
-List only the "remote" branches\&.
-
+List only the "remote" branches.
.TP
<branchname>
-The name of the branch to create or delete\&. The new branch name must pass all checks defined by \fBgit\-check\-ref\-format\fR(1)\&. Some of these checks may restrict the characters allowed in a branch name\&.
-
+The name of the branch to create or delete. The new branch name must pass all checks defined by
+\fBgit\-check\-ref\-format\fR(1). Some of these checks may restrict the characters allowed in a branch name.
.TP
<start\-point>
-The new branch will be created with a HEAD equal to this\&. It may be given as a branch name, a commit\-id, or a tag\&. If this option is omitted, the current branch is assumed\&.
-
+The new branch will be created with a HEAD equal to this. It may be given as a branch name, a commit\-id, or a tag. If this option is omitted, the current branch is assumed.
.SH "EXAMPLES"
-
.TP
Start development off of a known tag
-
+.sp
.nf
-$ git clone git://git\&.kernel\&.org/pub/scm/\&.\&.\&./linux\-2\&.6 my2\&.6
-$ cd my2\&.6
-$ git branch my2\&.6\&.14 v2\&.6\&.14 \fB(1)\fR
-$ git checkout my2\&.6\&.14
+$ git clone git://git.kernel.org/pub/scm/.../linux\-2.6 my2.6
+$ cd my2.6
+$ git branch my2.6.14 v2.6.14 \fB(1)\fR
+$ git checkout my2.6.14
.fi
.sp
-\fB1. \fRThis step and the next one could be combined into a single step with "checkout \-b my2\&.6\&.14 v2\&.6\&.14"\&.
+\fB1. \fRThis step and the next one could be combined into a single step with "checkout \-b my2.6.14 v2.6.14".
.br
-
-
.TP
Delete unneeded branch
-
+.sp
.nf
-$ git clone git://git\&.kernel\&.org/\&.\&.\&./git\&.git my\&.git
-$ cd my\&.git
+$ git clone git://git.kernel.org/.../git.git my.git
+$ cd my.git
$ git branch \-D todo \fB(1)\fR
.fi
.sp
-\fB1. \fRdelete todo branch even if the "master" branch does not have all commits from todo branch\&.
+\fB1. \fRdelete todo 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\&.
-
+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.
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org> and Junio C Hamano <junkio@cox\&.net>
-
+Written by Linus Torvalds <torvalds@osdl.org> and Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-CAT-FILE" 1 "" "" ""
-.SH NAME
-git-cat-file \- Provide content or type information for repository objects
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-cat\-file \- Provide content or type information for repository objects
.SH "SYNOPSIS"
-
-
\fIgit\-cat\-file\fR [\-t | \-s | \-e | \-p | <type>] <object>
-
+.sp
.SH "DESCRIPTION"
-
-
-Provides content or type of objects in the repository\&. The type is required unless \fI\-t\fR or \fI\-p\fR is used to find the object type, or \fI\-s\fR is used to find the object size\&.
-
+Provides content or type of objects in the repository. The type is required unless \fI\-t\fR or \fI\-p\fR is used to find the object type, or \fI\-s\fR is used to find the object size.
+.sp
.SH "OPTIONS"
-
.TP
<object>
-The sha1 identifier of the object\&.
-
+The sha1 identifier of the object.
.TP
\-t
-Instead of the content, show the object type identified by <object>\&.
-
+Instead of the content, show the object type identified by <object>.
.TP
\-s
-Instead of the content, show the object size identified by <object>\&.
-
+Instead of the content, show the object size identified by <object>.
.TP
\-e
-Suppress all output; instead exit with zero status if <object> exists and is a valid object\&.
-
+Suppress all output; instead exit with zero status if <object> exists and is a valid object.
.TP
\-p
-Pretty\-print the contents of <object> based on its type\&.
-
+Pretty\-print the contents of <object> based on its type.
.TP
<type>
-Typically this matches the real type of <object> but asking for a type that can trivially be dereferenced from the given <object> is also permitted\&. An example is to ask for a "tree" with <object> being a commit object that contains it, or to ask for a "blob" with <object> being a tag object that points at it\&.
-
+Typically this matches the real type of <object> but asking for a type that can trivially be dereferenced from the given <object> is also permitted. An example is to ask for a "tree" with <object> being a commit object that contains it, or to ask for a "blob" with <object> being a tag object that points at it.
.SH "OUTPUT"
-
-
-If \fI\-t\fR is specified, one of the <type>\&.
-
-
-If \fI\-s\fR is specified, the size of the <object> in bytes\&.
-
-
-If \fI\-e\fR is specified, no output\&.
-
-
-If \fI\-p\fR is specified, the contents of <object> are pretty\-printed\&.
-
-
-Otherwise the raw (though uncompressed) contents of the <object> will be returned\&.
-
+If \fI\-t\fR is specified, one of the <type>.
+.sp
+If \fI\-s\fR is specified, the size of the <object> in bytes.
+.sp
+If \fI\-e\fR is specified, no output.
+.sp
+If \fI\-p\fR is specified, the contents of <object> are pretty\-printed.
+.sp
+Otherwise the raw (though uncompressed) contents of the <object> will be returned.
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+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>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-CHECK-REF-FORM" 1 "" "" ""
-.SH NAME
-git-check-ref-format \- Make sure ref name is well formed
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+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\&.
-
-
-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:
-
+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 /\&.
-.LP
-
-
-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:
-
+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"\&.
-.LP
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-CHECKOUT-INDEX" 1 "" "" ""
-.SH NAME
-git-checkout-index \- Copy files from the index to the working directory
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-checkout\-index \- Copy files from the index to the working directory
.SH "SYNOPSIS"
-
+.sp
.nf
\fIgit\-checkout\-index\fR [\-u] [\-q] [\-a] [\-f] [\-n] [\-\-prefix=<string>]
[\-\-stage=<number>|all]
[\-z] [\-\-stdin]
[\-\-] [<file>]*
.fi
-
.SH "DESCRIPTION"
-
-
-Will copy all files listed from the index to the working directory (not overwriting existing files)\&.
-
+Will copy all files listed from the index to the working directory (not overwriting existing files).
+.sp
.SH "OPTIONS"
-
.TP
\-u|\-\-index
-update stat information for the checked out entries in the index file\&.
-
+update stat information for the checked out entries in the index file.
.TP
\-q|\-\-quiet
be quiet if files exist or are not in the index
-
.TP
\-f|\-\-force
forces overwrite of existing files
-
.TP
\-a|\-\-all
-checks out all files in the index\&. Cannot be used together with explicit filenames\&.
-
+checks out all files in the index. Cannot be used together with explicit filenames.
.TP
\-n|\-\-no\-create
-Don't checkout new files, only refresh files already checked out\&.
-
+Don't checkout new files, only refresh files already checked out.
.TP
\-\-prefix=<string>
When creating files, prepend <string> (usually a directory including a trailing /)
-
.TP
\-\-stage=<number>|all
-Instead of checking out unmerged entries, copy out the files from named stage\&. <number> must be between 1 and 3\&. Note: \-\-stage=all automatically implies \-\-temp\&.
-
+Instead of checking out unmerged entries, copy out the files from named stage. <number> must be between 1 and 3. Note: \-\-stage=all automatically implies \-\-temp.
.TP
\-\-temp
-Instead of copying the files to the working directory write the content to temporary files\&. The temporary name associations will be written to stdout\&.
-
+Instead of copying the files to the working directory write the content to temporary files. The temporary name associations will be written to stdout.
.TP
\-\-stdin
-Instead of taking list of paths from the command line, read list of paths from the standard input\&. Paths are separated by LF (i\&.e\&. one path per line) by default\&.
-
+Instead of taking list of paths from the command line, read list of paths from the standard input. Paths are separated by LF (i.e. one path per line) by default.
.TP
\-z
-Only meaningful with \-\-stdin; paths are separated with NUL character instead of LF\&.
-
+Only meaningful with
+\-\-stdin; paths are separated with NUL character instead of LF.
.TP
\-\-
-Do not interpret any more arguments as options\&.
-
-
-The order of the flags used to matter, but not anymore\&.
-
-
-Just doing git\-checkout\-index does nothing\&. You probably meant git\-checkout\-index \-a\&. And if you want to force it, you want git\-checkout\-index \-f \-a\&.
-
-
-Intuitiveness is not the goal here\&. Repeatability is\&. The reason for the "no arguments means no work" behavior is that from scripts you are supposed to be able to do:
-
+Do not interpret any more arguments as options.
+The order of the flags used to matter, but not anymore.
+.sp
+Just doing git\-checkout\-index does nothing. You probably meant git\-checkout\-index \-a. And if you want to force it, you want git\-checkout\-index \-f \-a.
+.sp
+Intuitiveness is not the goal here. Repeatability is. The reason for the "no arguments means no work" behavior is that from scripts you are supposed to be able to do:
+.sp
+.sp
.nf
-$ find \&. \-name '*\&.h' \-print0 | xargs \-0 git\-checkout\-index \-f \-\-
+$ find . \-name '*.h' \-print0 | xargs \-0 git\-checkout\-index \-f \-\-
.fi
-
-
-which will force all existing *\&.h files to be replaced with their cached copies\&. If an empty command line implied "all", then this would force\-refresh everything in the index, which was not the point\&. But since git\-checkout\-index accepts \-\-stdin it would be faster to use:
-
+which will force all existing *.h files to be replaced with their cached copies. If an empty command line implied "all", then this would force\-refresh everything in the index, which was not the point. But since git\-checkout\-index accepts \-\-stdin it would be faster to use:
+.sp
+.sp
.nf
-$ find \&. \-name '*\&.h' \-print0 | git\-checkout\-index \-f \-z \-\-stdin
+$ find . \-name '*.h' \-print0 | git\-checkout\-index \-f \-z \-\-stdin
.fi
-
-
-The \-\- is just a good idea when you know the rest will be filenames; it will prevent problems with a filename of, for example, \-a\&. Using \-\- is probably a good policy in scripts\&.
-
-.SH "USING --TEMP OR --STAGE=ALL"
-
-
-When \-\-temp is used (or implied by \-\-stage=all) git\-checkout\-index will create a temporary file for each index entry being checked out\&. The index will not be updated with stat information\&. These options can be useful if the caller needs all stages of all unmerged entries so that the unmerged files can be processed by an external merge tool\&.
-
-
-A listing will be written to stdout providing the association of temporary file names to tracked path names\&. The listing format has two variations:
-
+The \-\- is just a good idea when you know the rest will be filenames; it will prevent problems with a filename of, for example, \-a. Using \-\- is probably a good policy in scripts.
+.sp
+.SH "USING \-\-TEMP OR \-\-STAGE=ALL"
+When \-\-temp is used (or implied by \-\-stage=all) git\-checkout\-index will create a temporary file for each index entry being checked out. The index will not be updated with stat information. These options can be useful if the caller needs all stages of all unmerged entries so that the unmerged files can be processed by an external merge tool.
+.sp
+A listing will be written to stdout providing the association of temporary file names to tracked path names. The listing format has two variations:
+.sp
.TP 3
1.
tempname TAB path RS
-
-The first format is what gets used when \-\-stage is omitted or is not \-\-stage=all\&. The field tempname is the temporary file name holding the file content and path is the tracked path name in the index\&. Only the requested entries are output\&.
+.sp
+The first format is what gets used when
+\-\-stage
+is omitted or is not
+\-\-stage=all. The field tempname is the temporary file name holding the file content and path is the tracked path name in the index. Only the requested entries are output.
.TP
2.
stage1temp SP stage2temp SP stage3tmp TAB path RS
-
-The second format is what gets used when \-\-stage=all\&. The three stage temporary fields (stage1temp, stage2temp, stage3temp) list the name of the temporary file if there is a stage entry in the index or \&. if there is no stage entry\&. Paths which only have a stage 0 entry will always be omitted from the output\&.
-.LP
-
-
-In both formats RS (the record separator) is newline by default but will be the null byte if \-z was passed on the command line\&. The temporary file names are always safe strings; they will never contain directory separators or whitespace characters\&. The path field is always relative to the current directory and the temporary file names are always relative to the top level directory\&.
-
-
-If the object being copied out to a temporary file is a symbolic link the content of the link will be written to a normal file\&. It is up to the end\-user or the Porcelain to make use of this information\&.
-
+.sp
+The second format is what gets used when
+\-\-stage=all. The three stage temporary fields (stage1temp, stage2temp, stage3temp) list the name of the temporary file if there is a stage entry in the index or
+.
+if there is no stage entry. Paths which only have a stage 0 entry will always be omitted from the output.
+In both formats RS (the record separator) is newline by default but will be the null byte if \-z was passed on the command line. The temporary file names are always safe strings; they will never contain directory separators or whitespace characters. The path field is always relative to the current directory and the temporary file names are always relative to the top level directory.
+.sp
+If the object being copied out to a temporary file is a symbolic link the content of the link will be written to a normal file. It is up to the end\-user or the Porcelain to make use of this information.
+.sp
.SH "EXAMPLES"
-
.TP
To update and refresh only the files already checked out
-
+.sp
.nf
$ git\-checkout\-index \-n \-f \-a && git\-update\-index \-\-ignore\-missing \-\-refresh
.fi
-
.TP
Using git\-checkout\-index to "export an entire tree"
-The prefix ability basically makes it trivial to use git\-checkout\-index as an "export as tree" function\&. Just read the desired tree into the index, and do:
-
-
+The prefix ability basically makes it trivial to use
+git\-checkout\-index
+as an "export as tree" function. Just read the desired tree into the index, and do:
+.sp
.nf
$ git\-checkout\-index \-\-prefix=git\-export\-dir/ \-a
.fi
-git\-checkout\-index will "export" the index into the specified directory\&.
-
-The final "/" is important\&. The exported name is literally just prefixed with the specified string\&. Contrast this with the following example\&.
-
+git\-checkout\-index
+will "export" the index into the specified directory.
+.sp
+The final "/" is important. The exported name is literally just prefixed with the specified string. Contrast this with the following example.
.TP
Export files with a prefix
-
+.sp
.nf
-$ git\-checkout\-index \-\-prefix=\&.merged\- Makefile
+$ git\-checkout\-index \-\-prefix=.merged\- Makefile
.fi
-This will check out the currently cached copy of Makefile into the file \&.merged\-Makefile\&.
-
+This will check out the currently cached copy of
+Makefile
+into the file
+.merged\-Makefile.
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+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>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-CHECKOUT" 1 "" "" ""
-.SH NAME
-git-checkout \- Checkout and switch to a branch
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-checkout \- Checkout and switch to a branch
.SH "SYNOPSIS"
-
+.sp
.nf
\fIgit\-checkout\fR [\-f] [\-b <new_branch> [\-l]] [\-m] [<branch>]
-\fIgit\-checkout\fR [\-m] [<branch>] <paths>...
+\fIgit\-checkout\fR [\-m] [<branch>] <paths>\&...
.fi
-
.SH "DESCRIPTION"
-
-
-When <paths> are not given, this command switches branches by updating the index and working tree to reflect the specified branch, <branch>, and updating HEAD to be <branch> or, if specified, <new_branch>\&. Using \-b will cause <new_branch> to be created\&.
-
-
-When <paths> are given, this command does \fInot\fR switch branches\&. It updates the named paths in the working tree from the index file (i\&.e\&. it runs git\-checkout\-index \-f \-u)\&. In this case, \-f and \-b options are meaningless and giving either of them results in an error\&. <branch> argument can be used to specify a specific tree\-ish to update the index for the given paths before updating the working tree\&.
-
+When <paths> are not given, this command switches branches by updating the index and working tree to reflect the specified branch, <branch>, and updating HEAD to be <branch> or, if specified, <new_branch>. Using \-b will cause <new_branch> to be created.
+.sp
+When <paths> are given, this command does \fBnot\fR switch branches. It updates the named paths in the working tree from the index file (i.e. it runs git\-checkout\-index \-f \-u). In this case, \-f and \-b options are meaningless and giving either of them results in an error. <branch> argument can be used to specify a specific tree\-ish to update the index for the given paths before updating the working tree.
+.sp
.SH "OPTIONS"
-
.TP
\-f
-Force a re\-read of everything\&.
-
+Force a re\-read of everything.
.TP
\-b
-Create a new branch named <new_branch> and start it at <branch>\&. The new branch name must pass all checks defined by \fBgit\-check\-ref\-format\fR(1)\&. Some of these checks may restrict the characters allowed in a branch name\&.
-
+Create a new branch named <new_branch> and start it at <branch>. The new branch name must pass all checks defined by
+\fBgit\-check\-ref\-format\fR(1). Some of these checks may restrict the characters allowed in a branch name.
.TP
\-l
-Create the new branch's ref log\&. This activates recording of all changes to made the branch ref, enabling use of date
-
+Create the new branch's ref log. This activates recording of all changes to made the branch ref, enabling use of date
.TP
\-m
-If you have local modifications to one or more files that are different between the current branch and the branch to which you are switching, the command refuses to switch branches in order to preserve your modifications in context\&. However, with this option, a three\-way merge between the current branch, your working tree contents, and the new branch is done, and you will be on the new branch\&.
-
-When a merge conflict happens, the index entries for conflicting paths are left unmerged, and you need to resolve the conflicts and mark the resolved paths with git update\-index\&.
-
+If you have local modifications to one or more files that are different between the current branch and the branch to which you are switching, the command refuses to switch branches in order to preserve your modifications in context. However, with this option, a three\-way merge between the current branch, your working tree contents, and the new branch is done, and you will be on the new branch.
+.sp
+When a merge conflict happens, the index entries for conflicting paths are left unmerged, and you need to resolve the conflicts and mark the resolved paths with
+git update\-index.
.TP
<new_branch>
-Name for the new branch\&.
-
+Name for the new branch.
.TP
<branch>
-Branch to checkout; may be any object ID that resolves to a commit\&. Defaults to HEAD\&.
-
+Branch to checkout; may be any object ID that resolves to a commit. Defaults to HEAD.
.SH "EXAMPLES"
-
.TP 3
1.
-The following sequence checks out the master branch, reverts the Makefile to two revisions back, deletes hello\&.c by mistake, and gets it back from the index\&.
-
+The following sequence checks out the
+master
+branch, reverts the
+Makefile
+to two revisions back, deletes hello.c by mistake, and gets it back from the index.
+.sp
.nf
$ git checkout master \fB(1)\fR
$ git checkout master~2 Makefile \fB(2)\fR
-$ rm \-f hello\&.c
-$ git checkout hello\&.c \fB(3)\fR
+$ rm \-f hello.c
+$ git checkout hello.c \fB(3)\fR
.fi
.sp
\fB1. \fRswitch branch
.br
\fB2. \fRtake out a file out of other commit
.br
-\fB3. \fRrestore hello\&.c from HEAD of current branch
-
-If you have an unfortunate branch that is named hello\&.c, this step would be confused as an instruction to switch to that branch\&. You should instead write:
-
+\fB3. \fRrestore hello.c from HEAD of current branch
+.sp
+If you have an unfortunate branch that is named
+hello.c, this step would be confused as an instruction to switch to that branch. You should instead write:
+.sp
.nf
-$ git checkout \-\- hello\&.c
+$ git checkout \-\- hello.c
.fi
.br
-
.TP
2.
After working in a wrong branch, switching to the correct branch would be done using:
-
-
+.sp
.nf
$ git checkout mytopic
.fi
However, your "wrong" branch and correct "mytopic" branch may differ in files that you have locally modified, in which case, the above checkout would fail like this:
-
-
+.sp
.nf
$ git checkout mytopic
-fatal: Entry 'frotz' not uptodate\&. Cannot merge\&.
+fatal: Entry 'frotz' not uptodate. Cannot merge.
.fi
-You can give the \-m flag to the command, which would try a three\-way merge:
-
-
+You can give the
+\-m
+flag to the command, which would try a three\-way merge:
+.sp
.nf
$ git checkout \-m mytopic
Auto\-merging frotz
.fi
-After this three\-way merge, the local modifications are _not_ registered in your index file, so git diff would show you what changes you made since the tip of the new branch\&.
+After this three\-way merge, the local modifications are _not_ registered in your index file, so
+git diff
+would show you what changes you made since the tip of the new branch.
.TP
3.
-When a merge conflict happens during switching branches with the \-m option, you would see something like this:
-
-
+When a merge conflict happens during switching branches with the
+\-m
+option, you would see something like this:
+.sp
.nf
$ git checkout \-m mytopic
Auto\-merging frotz
ERROR: Merge conflict in frotz
fatal: merge program failed
.fi
-At this point, git diff shows the changes cleanly merged as in the previous example, as well as the changes in the conflicted files\&. Edit and resolve the conflict and mark it resolved with git update\-index as usual:
-
+At this point,
+git diff
+shows the changes cleanly merged as in the previous example, as well as the changes in the conflicted files. Edit and resolve the conflict and mark it resolved with
+git update\-index
+as usual:
+.sp
.nf
$ edit frotz
$ git update\-index frotz
.fi
-.LP
-
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+Written by Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-CHERRY-PICK" 1 "" "" ""
-.SH NAME
-git-cherry-pick \- Apply the change introduced by an existing commit
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-cherry\-pick \- Apply the change introduced by an existing commit
.SH "SYNOPSIS"
-
-
\fIgit\-cherry\-pick\fR [\-\-edit] [\-n] [\-r] <commit>
-
+.sp
.SH "DESCRIPTION"
-
-
-Given one existing commit, apply the change the patch introduces, and record a new commit that records it\&. This requires your working tree to be clean (no modifications from the HEAD commit)\&.
-
+Given one existing commit, apply the change the patch introduces, and record a new commit that records it. This requires your working tree to be clean (no modifications from the HEAD commit).
+.sp
.SH "OPTIONS"
-
.TP
<commit>
-Commit to cherry\-pick\&.
-
+Commit to cherry\-pick.
.TP
\-e|\-\-edit
-With this option, git\-cherry\-pick will let you edit the commit message prior committing\&.
-
+With this option,
+git\-cherry\-pick
+will let you edit the commit message prior committing.
.TP
\-r|\-\-replay
-Usually the command appends which commit was cherry\-picked after the original commit message when making a commit\&. This option, \fI\-\-replay\fR, causes it to use the original commit message intact\&. This is useful when you are reordering the patches in your private tree before publishing\&.
-
+Usually the command appends which commit was cherry\-picked after the original commit message when making a commit. This option,
+\fI\-\-replay\fR, causes it to use the original commit message intact. This is useful when you are reordering the patches in your private tree before publishing.
.TP
\-n|\-\-no\-commit
-Usually the command automatically creates a commit with a commit log message stating which commit was cherry\-picked\&. This flag applies the change necessary to cherry\-pick the named commit to your working tree, but does not make the commit\&. In addition, when this option is used, your working tree does not have to match the HEAD commit\&. The cherry\-pick is done against the beginning state of your working tree\&.
-
-This is useful when cherry\-picking more than one commits' effect to your working tree in a row\&.
-
+Usually the command automatically creates a commit with a commit log message stating which commit was cherry\-picked. This flag applies the change necessary to cherry\-pick the named commit to your working tree, but does not make the commit. In addition, when this option is used, your working tree does not have to match the HEAD commit. The cherry\-pick is done against the beginning state of your working tree.
+.sp
+This is useful when cherry\-picking more than one commits' effect to your working tree in a row.
.SH "AUTHOR"
-
-
-Written by Junio C Hamano <junkio@cox\&.net>
-
+Written by Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-CHERRY" 1 "" "" ""
-.SH NAME
-git-cherry \- Find commits not merged upstream
+.\" ** You probably do not want to edit this file directly **
+.\" 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/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-cherry \- Find commits not merged upstream
.SH "SYNOPSIS"
-
-
\fIgit\-cherry\fR [\-v] <upstream> [<head>]
-
+.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>\&.
-
-
-Every commit with a changeset that doesn't exist in the other branch has its id (sha1) reported, prefixed by a symbol\&. Those existing only 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\&.
-
-
-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\&.
-
+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 with a changeset that doesn't exist in the other branch has its id (sha1) reported, prefixed by a symbol. Those existing only 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
+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
-Verbose\&.
-
+Verbose.
.TP
<upstream>
-Upstream branch to compare against\&.
-
+Upstream branch to compare against.
.TP
<head>
-Working branch; defaults to HEAD\&.
-
+Working branch; defaults to HEAD.
.SH "AUTHOR"
-
-
-Written by Junio C Hamano <junkio@cox\&.net>
-
+Written by Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-CLEAN" 1 "" "" ""
-.SH NAME
-git-clean \- Remove untracked files from the working tree
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-clean \- Remove untracked files from the working tree
.SH "SYNOPSIS"
-
+.sp
.nf
-\fIgit\-clean\fR [\-d] [\-n] [\-q] [\-x | \-X] [\-\-] <paths>...
+\fIgit\-clean\fR [\-d] [\-n] [\-q] [\-x | \-X] [\-\-] <paths>\&...
.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\&.
-
+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
-Remove untracked directories in addition to untracked files\&.
-
+Remove untracked directories in addition to untracked files.
.TP
\-n
-Don't actually remove anything, just show what would be done\&.
-
+Don't actually remove anything, just show what would be done.
.TP
\-q
-Be quiet, only report errors, but not the files that are successfully removed\&.
-
+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\&.
-
+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>
-
+Written by Pavel Roskin <proski@gnu.org>
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-CLONE" 1 "" "" ""
-.SH NAME
-git-clone \- Clones a repository
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-clone \- Clones a repository
.SH "SYNOPSIS"
-
+.sp
.nf
\fIgit\-clone\fR [\-\-template=<template_directory>] [\-l [\-s]] [\-q] [\-n] [\-\-bare]
[\-o <name>] [\-u <upload\-pack>] [\-\-reference <repository>]
[\-\-use\-separate\-remote] <repository> [<directory>]
.fi
-
.SH "DESCRIPTION"
-
-
-Clones a repository into a newly created directory\&. All remote branch heads are copied under $GIT_DIR/refs/heads/, except that the remote master is also copied to origin branch\&.
-
-
+Clones a repository into a newly created directory. All remote branch heads are copied under $GIT_DIR/refs/heads/, except that the remote master is also copied to origin branch.
+.sp
In addition, $GIT_DIR/remotes/origin file is set up to have this line:
-
+.sp
+.sp
.nf
Pull: master:origin
.fi
-
-
-This is to help the typical workflow of working off of the remote master branch\&. Every time git pull without argument is run, the progress on the remote master branch is tracked by copying it into the local origin branch, and merged into the branch you are currently working on\&. Remote branches other than master are also added there to be tracked\&.
-
+This is to help the typical workflow of working off of the remote master branch. Every time git pull without argument is run, the progress on the remote master branch is tracked by copying it into the local origin branch, and merged into the branch you are currently working on. Remote branches other than master are also added there to be tracked.
+.sp
.SH "OPTIONS"
-
.TP
-\-\-local, \-l
-When the repository to clone from is on a local machine, this flag bypasses normal "git aware" transport mechanism and clones the repository by making a copy of HEAD and everything under objects and refs directories\&. The files under \&.git/objects/ directory are hardlinked to save space when possible\&.
-
+\-\-local , \-l
+When the repository to clone from is on a local machine, this flag bypasses normal "git aware" transport mechanism and clones the repository by making a copy of HEAD and everything under objects and refs directories. The files under .git/objects/ directory are hardlinked to save space when possible.
.TP
-\-\-shared, \-s
-When the repository to clone is on the local machine, instead of using hard links, automatically setup \&.git/objects/info/alternates to share the objects with the source repository\&. The resulting repository starts out without any object of its own\&.
-
+\-\-shared , \-s
+When the repository to clone is on the local machine, instead of using hard links, automatically setup .git/objects/info/alternates to share the objects with the source repository. The resulting repository starts out without any object of its own.
.TP
\-\-reference <repository>
-If the reference repository is on the local machine automatically setup \&.git/objects/info/alternates to obtain objects from the reference repository\&. Using an already existing repository as an alternate will require less objects to be copied from the repository being cloned, reducing network and local storage costs\&.
-
+If the reference repository is on the local machine automatically setup .git/objects/info/alternates to obtain objects from the reference repository. Using an already existing repository as an alternate will require less objects to be copied from the repository being cloned, reducing network and local storage costs.
.TP
-\-\-quiet, \-q
-Operate quietly\&. This flag is passed to "rsync" and "git\-fetch\-pack" commands when given\&.
-
+\-\-quiet , \-q
+Operate quietly. This flag is passed to "rsync" and "git\-fetch\-pack" commands when given.
.TP
\-n
-No checkout of HEAD is performed after the clone is complete\&.
-
+No checkout of HEAD is performed after the clone is complete.
.TP
\-\-bare
-Make a \fIbare\fR GIT repository\&. That is, instead of creating <directory> and placing the administrative files in <directory>/\&.git, make the <directory> itself the $GIT_DIR\&. This implies \-n option\&. When this option is used, neither the origin branch nor the default remotes/origin file is created\&.
-
+Make a
+\fIbare\fR
+GIT repository. That is, instead of creating
+<directory>
+and placing the administrative files in
+<directory>/.git, make the
+<directory>
+itself the
+$GIT_DIR. This implies
+\-n
+option. When this option is used, neither the
+origin
+branch nor the default
+remotes/origin
+file is created.
.TP
\-o <name>
-Instead of using the branch name \fIorigin\fR to keep track of the upstream repository, use <name> instead\&. Note that the shorthand name stored in remotes/origin is not affected, but the local branch name to pull the remote master branch into is\&.
-
-.TP
-\-\-upload\-pack <upload\-pack>, \-u <upload\-pack>
-When given, and the repository to clone from is handled by \fIgit\-fetch\-pack\fR, \fI\-\-exec=<upload\-pack>\fR is passed to the command to specify non\-default path for the command run on the other end\&.
-
+Instead of using the branch name
+\fIorigin\fR
+to keep track of the upstream repository, use <name> instead. Note that the shorthand name stored in
+remotes/origin
+is not affected, but the local branch name to pull the remote
+master
+branch into is.
+.TP
+\-\-upload\-pack <upload\-pack> , \-u <upload\-pack>
+When given, and the repository to clone from is handled by
+\fIgit\-fetch\-pack\fR,
+\fI\-\-exec=<upload\-pack>\fR
+is passed to the command to specify non\-default path for the command run on the other end.
.TP
\-\-template=<template_directory>
-Specify the directory from which templates will be used; if unset the templates are taken from the installation defined default, typically /usr/share/git\-core/templates\&.
-
+Specify the directory from which templates will be used; if unset the templates are taken from the installation defined default, typically
+/usr/share/git\-core/templates.
.TP
\-\-use\-separate\-remote
-Save remotes heads under $GIT_DIR/remotes/origin/ instead of $GIT_DIR/refs/heads/\&. Only the master branch is saved in the latter\&.
-
+Save remotes heads under
+$GIT_DIR/remotes/origin/
+instead of
+$GIT_DIR/refs/heads/. Only the master branch is saved in the latter.
.TP
<repository>
-The (possibly remote) repository to clone from\&. It can be any URL git\-fetch supports\&.
-
+The (possibly remote) repository to clone from. It can be any URL git\-fetch supports.
.TP
<directory>
-The name of a new directory to clone into\&. The "humanish" part of the source repository is used if no directory is explicitly given ("repo" for "/path/to/repo\&.git" and "foo" for "host\&.xz:foo/\&.git")\&. Cloning into an existing directory is not allowed\&.
-
+The name of a new directory to clone into. The "humanish" part of the source repository is used if no directory is explicitly given ("repo" for "/path/to/repo.git" and "foo" for "host.xz:foo/.git"). Cloning into an existing directory is not allowed.
.SH "EXAMPLES"
-
.TP
Clone from upstream
-
+.sp
.nf
-$ git clone git://git\&.kernel\&.org/pub/scm/\&.\&.\&./linux\-2\&.6 my2\&.6
-$ cd my2\&.6
+$ git clone git://git.kernel.org/pub/scm/.../linux\-2.6 my2.6
+$ cd my2.6
$ make
.fi
-
.TP
Make a local clone that borrows from the current directory, without checking things out
-
+.sp
.nf
-$ git clone \-l \-s \-n \&. \&.\&./copy
+$ git clone \-l \-s \-n . ../copy
$ cd copy
$ git show\-branch
.fi
-
.TP
Clone from upstream while borrowing from an existing local directory
-
+.sp
.nf
-$ git clone \-\-reference my2\&.6 \\
- git://git\&.kernel\&.org/pub/scm/\&.\&.\&./linux\-2\&.7 \\
- my2\&.7
-$ cd my2\&.7
+$ git clone \-\-reference my2.6 \\
+ git://git.kernel.org/pub/scm/.../linux\-2.7 \\
+ my2.7
+$ cd my2.7
.fi
-
.TP
Create a bare repository to publish your changes to the public
-
+.sp
.nf
-$ git clone \-\-bare \-l /home/proj/\&.git /pub/scm/proj\&.git
+$ git clone \-\-bare \-l /home/proj/.git /pub/scm/proj.git
.fi
-
.TP
-Create a repository on the kernel\&.org machine that borrows from Linus
-
+Create a repository on the kernel.org machine that borrows from Linus
+.sp
.nf
-$ git clone \-\-bare \-l \-s /pub/scm/\&.\&.\&./torvalds/linux\-2\&.6\&.git \\
- /pub/scm/\&.\&.\&./me/subsys\-2\&.6\&.git
+$ git clone \-\-bare \-l \-s /pub/scm/.../torvalds/linux\-2.6.git \\
+ /pub/scm/.../me/subsys\-2.6.git
.fi
-
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+Written by Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-COMMIT-TREE" 1 "" "" ""
-.SH NAME
-git-commit-tree \- Creates a new commit object
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-commit\-tree \- Creates a new commit object
.SH "SYNOPSIS"
-
-
\fIgit\-commit\-tree\fR <tree> [\-p <parent commit>]* < changelog
-
+.sp
.SH "DESCRIPTION"
-
-
-Creates a new commit object based on the provided tree object and emits the new commit object id on stdout\&. If no parent is given then it is considered to be an initial tree\&.
-
-
-A commit object usually has 1 parent (a commit after a change) or up to 16 parents\&. More than one parent represents a merge of branches that led to them\&.
-
-
-While a tree represents a particular directory state of a working directory, a commit represents that state in "time", and explains how to get there\&.
-
-
-Normally a commit would identify a new "HEAD" state, and while git doesn't care where you save the note about that state, in practice we tend to just write the result to the file that is pointed at by \&.git/HEAD, so that we can always see what the last committed state was\&.
-
+Creates a new commit object based on the provided tree object and emits the new commit object id on stdout. If no parent is given then it is considered to be an initial tree.
+.sp
+A commit object usually has 1 parent (a commit after a change) or up to 16 parents. More than one parent represents a merge of branches that led to them.
+.sp
+While a tree represents a particular directory state of a working directory, a commit represents that state in "time", and explains how to get there.
+.sp
+Normally a commit would identify a new "HEAD" state, and while git doesn't care where you save the note about that state, in practice we tend to just write the result to the file that is pointed at by .git/HEAD, so that we can always see what the last committed state was.
+.sp
.SH "OPTIONS"
-
.TP
<tree>
An existing tree object
-
.TP
\-p <parent commit>
-Each \fI\-p\fR indicates the id of a parent commit object\&.
-
+Each
+\fI\-p\fR
+indicates the id of a parent commit object.
.SH "COMMIT INFORMATION"
-
-
A commit encapsulates:
-
+.sp
.TP 3
\(bu
all parent object ids
author name, email and date
.TP
\(bu
-committer name and email and the commit time\&.
-.LP
-
-
-If not provided, "git\-commit\-tree" uses your name, hostname and domain to provide author and committer info\&. This can be overridden by either \&.git/config file, or using the following environment variables\&.
-
+committer name and email and the commit time.
+If not provided, "git\-commit\-tree" uses your name, hostname and domain to provide author and committer info. This can be overridden by either .git/config file, or using the following environment variables.
+.sp
+.sp
.nf
GIT_AUTHOR_NAME
GIT_AUTHOR_EMAIL
GIT_COMMITTER_NAME
GIT_COMMITTER_EMAIL
.fi
-
-
(nb "<", ">" and "\\n"s are stripped)
-
-
-In \&.git/config file, the following items are used for GIT_AUTHOR_NAME and GIT_AUTHOR_EMAIL:
-
+.sp
+In .git/config file, the following items are used for GIT_AUTHOR_NAME and GIT_AUTHOR_EMAIL:
+.sp
+.sp
.nf
[user]
name = "Your Name"
- email = "your@email\&.address\&.xz"
+ email = "your@email.address.xz"
.fi
-
-
-A commit comment is read from stdin (max 999 chars)\&. If a changelog entry is not provided via "<" redirection, "git\-commit\-tree" will just wait for one to be entered and terminated with ^D\&.
-
+A commit comment is read from stdin (max 999 chars). If a changelog entry is not provided via "<" redirection, "git\-commit\-tree" will just wait for one to be entered and terminated with ^D.
+.sp
.SH "DIAGNOSTICS"
-
.TP
-You don't exist\&. Go away!
+You don't exist. Go away!
The passwd(5) gecos field couldn't be read
-
.TP
Your parents must have hated you!
-The password(5) gecos field is longer than a giant static buffer\&.
-
+The password(5) gecos field is longer than a giant static buffer.
.TP
Your sysadmin must hate you!
-The password(5) name field is longer than a giant static buffer\&.
-
+The password(5) name field is longer than a giant static buffer.
.SH "SEE ALSO"
-
-
\fBgit\-write\-tree\fR(1)
-
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+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>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-COMMIT" 1 "" "" ""
-.SH NAME
-git-commit \- Record your changes
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-commit \- Record your changes
.SH "SYNOPSIS"
-
+.sp
.nf
\fIgit\-commit\fR [\-a] [\-s] [\-v] [(\-c | \-C) <commit> | \-F <file> | \-m <msg>]
[\-\-no\-verify] [\-\-amend] [\-e] [\-\-author <author>]
- [\-\-] [[\-i | \-o ]<file>...]
+ [\-\-] [[\-i | \-o ]<file>\&...]
.fi
-
.SH "DESCRIPTION"
-
-
-Updates the index file for given paths, or all modified files if \fI\-a\fR is specified, and makes a commit object\&. The command specified by either the VISUAL or EDITOR environment variables are used to edit the commit log message\&.
-
-
-Several environment variable are used during commits\&. They are documented in \fBgit\-commit\-tree\fR(1)\&.
-
-
-This command can run commit\-msg, pre\-commit, and post\-commit hooks\&. See hooks: \fIhooks.html\fR for more information\&.
-
+Updates the index file for given paths, or all modified files if \fI\-a\fR is specified, and makes a commit object. The command specified by either the VISUAL or EDITOR environment variables are used to edit the commit log message.
+.sp
+Several environment variable are used during commits. They are documented in \fBgit\-commit\-tree\fR(1).
+.sp
+This command can run commit\-msg, pre\-commit, and post\-commit hooks. See [1]\&\fIhooks\fR for more information.
+.sp
.SH "OPTIONS"
-
.TP
\-a|\-\-all
-Update all paths in the index file\&. This flag notices files that have been modified and deleted, but new files you have not told git about are not affected\&.
-
+Update all paths in the index file. This flag notices files that have been modified and deleted, but new files you have not told git about are not affected.
.TP
\-c or \-C <commit>
-Take existing commit object, and reuse the log message and the authorship information (including the timestamp) when creating the commit\&. With \fI\-C\fR, the editor is not invoked; with \fI\-c\fR the user can further edit the commit message\&.
-
+Take existing commit object, and reuse the log message and the authorship information (including the timestamp) when creating the commit. With
+\fI\-C\fR, the editor is not invoked; with
+\fI\-c\fR
+the user can further edit the commit message.
.TP
\-F <file>
-Take the commit message from the given file\&. Use \fI\-\fR to read the message from the standard input\&.
-
+Take the commit message from the given file. Use
+\fI\-\fR
+to read the message from the standard input.
.TP
\-\-author <author>
-Override the author name used in the commit\&. Use A U Thor <author@example\&.com> format\&.
-
+Override the author name used in the commit. Use
+A U Thor <author@example.com>
+format.
.TP
\-m <msg>
-Use the given <msg> as the commit message\&.
-
+Use the given <msg> as the commit message.
.TP
\-s|\-\-signoff
-Add Signed\-off\-by line at the end of the commit message\&.
-
+Add Signed\-off\-by line at the end of the commit message.
.TP
\-v|\-\-verify
-Look for suspicious lines the commit introduces, and abort committing if there is one\&. The definition of \fIsuspicious lines\fR is currently the lines that has trailing whitespaces, and the lines whose indentation has a SP character immediately followed by a TAB character\&. This is the default\&.
-
+Look for suspicious lines the commit introduces, and abort committing if there is one. The definition of
+\fIsuspicious lines\fR
+is currently the lines that has trailing whitespaces, and the lines whose indentation has a SP character immediately followed by a TAB character. This is the default.
.TP
\-n|\-\-no\-verify
-The opposite of \-\-verify\&.
-
+The opposite of
+\-\-verify.
.TP
\-e|\-\-edit
-The message taken from file with \-F, command line with \-m, and from file with \-C are usually used as the commit log message unmodified\&. This option lets you further edit the message taken from these sources\&.
-
+The message taken from file with
+\-F, command line with
+\-m, and from file with
+\-C
+are usually used as the commit log message unmodified. This option lets you further edit the message taken from these sources.
.TP
\-\-amend
-Used to amend the tip of the current branch\&. Prepare the tree object you would want to replace the latest commit as usual (this includes the usual \-i/\-o and explicit paths), and the commit log editor is seeded with the commit message from the tip of the current branch\&. The commit you create replaces the current tip -- if it was a merge, it will have the parents of the current tip as parents -- so the current top commit is discarded\&.
-
+Used to amend the tip of the current branch. Prepare the tree object you would want to replace the latest commit as usual (this includes the usual \-i/\-o and explicit paths), and the commit log editor is seeded with the commit message from the tip of the current branch. The commit you create replaces the current tip \(em if it was a merge, it will have the parents of the current tip as parents \(em so the current top commit is discarded.
+.sp
It is a rough equivalent for:
-
-
+.sp
.nf
$ git reset \-\-soft HEAD^
- $ \&.\&.\&. do something else to come up with the right tree \&.\&.\&.
+ $ ... do something else to come up with the right tree ...
$ git commit \-c ORIG_HEAD
-
.fi
-but can be used to amend a merge commit\&.
-
+but can be used to amend a merge commit.
.TP
\-i|\-\-include
-Instead of committing only the files specified on the command line, update them in the index file and then commit the whole index\&. This is the traditional behavior\&.
-
+Instead of committing only the files specified on the command line, update them in the index file and then commit the whole index. This is the traditional behavior.
.TP
\-o|\-\-only
-Commit only the files specified on the command line\&. This format cannot be used during a merge, nor when the index and the latest commit does not match on the specified paths to avoid confusion\&.
-
+Commit only the files specified on the command line. This format cannot be used during a merge, nor when the index and the latest commit does not match on the specified paths to avoid confusion.
.TP
\-\-
-Do not interpret any more arguments as options\&.
-
-.TP
-<file>...
-Files to be committed\&. The meaning of these is different between \-\-include and \-\-only\&. Without either, it defaults \-\-only semantics\&.
-
-
-If you make a commit and then found a mistake immediately after that, you can recover from it with \fBgit\-reset\fR(1)\&.
-
+Do not interpret any more arguments as options.
+.TP
+<file>\&...
+Files to be committed. The meaning of these is different between
+\-\-include
+and
+\-\-only. Without either, it defaults
+\-\-only
+semantics.
+If you make a commit and then found a mistake immediately after that, you can recover from it with \fBgit\-reset\fR(1).
+.sp
.SH "DISCUSSION"
-
-
-git commit without _any_ parameter commits the tree structure recorded by the current index file\&. This is a whole\-tree commit even the command is invoked from a subdirectory\&.
-
-
-git commit \-\-include paths... is equivalent to
-
+git commit without _any_ parameter commits the tree structure recorded by the current index file. This is a whole\-tree commit even the command is invoked from a subdirectory.
+.sp
+git commit \-\-include paths\&... is equivalent to
+.sp
+.sp
.nf
-git update\-index \-\-remove paths\&.\&.\&.
+git update\-index \-\-remove paths...
git commit
.fi
-
-
-That is, update the specified paths to the index and then commit the whole tree\&.
-
-
-git commit paths... largely bypasses the index file and commits only the changes made to the specified paths\&. It has however several safety valves to prevent confusion\&.
-
+That is, update the specified paths to the index and then commit the whole tree.
+.sp
+git commit paths\&... largely bypasses the index file and commits only the changes made to the specified paths. It has however several safety valves to prevent confusion.
+.sp
.TP 3
1.
-It refuses to run during a merge (i\&.e\&. when $GIT_DIR/MERGE_HEAD exists), and reminds trained git users that the traditional semantics now needs \-i flag\&.
+It refuses to run during a merge (i.e. when
+$GIT_DIR/MERGE_HEAD
+exists), and reminds trained git users that the traditional semantics now needs \-i flag.
.TP
2.
-It refuses to run if named paths... are different in HEAD and the index (ditto about reminding)\&. Added paths are OK\&. This is because an earlier git diff (not git diff HEAD) would have shown the differences since the last git update\-index paths... to the user, and an inexperienced user may mistakenly think that the changes between the index and the HEAD (i\&.e\&. earlier changes made before the last git update\-index paths... was done) are not being committed\&.
+It refuses to run if named
+paths\&...
+are different in HEAD and the index (ditto about reminding). Added paths are OK. This is because an earlier
+git diff
+(not
+git diff HEAD) would have shown the differences since the last
+git update\-index paths\&...
+to the user, and an inexperienced user may mistakenly think that the changes between the index and the HEAD (i.e. earlier changes made before the last
+git update\-index paths\&...
+was done) are not being committed.
.TP
3.
-It reads HEAD commit into a temporary index file, updates the specified paths... and makes a commit\&. At the same time, the real index file is also updated with the same paths...\&.
-.LP
-
-
-git commit \-\-all updates the index file with _all_ changes to the working tree, and makes a whole\-tree commit, regardless of which subdirectory the command is invoked in\&.
-
+It reads HEAD commit into a temporary index file, updates the specified
+paths\&...
+and makes a commit. At the same time, the real index file is also updated with the same
+paths\&....
+git commit \-\-all updates the index file with _all_ changes to the working tree, and makes a whole\-tree commit, regardless of which subdirectory the command is invoked in.
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org> and Junio C Hamano <junkio@cox\&.net>
-
+Written by Linus Torvalds <torvalds@osdl.org> and Junio C Hamano <junkio@cox.net>
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
+.SH "REFERENCES"
+.TP 3
+1.\ hooks
+\%hooks.html
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-CONVERT-OBJECTS" 1 "" "" ""
-.SH NAME
-git-convert-objects \- Converts old-style git repository
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+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>
-
+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>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-COUNT-OBJECTS" 1 "" "" ""
-.SH NAME
-git-count-objects \- Reports on unpacked objects
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-count\-objects \- Reports on unpacked objects
.SH "SYNOPSIS"
-
-
\fIgit\-count\-objects\fR [\-v]
-
+.sp
.SH "DESCRIPTION"
-
-
-This counts the number of unpacked object files and disk space consumed by them, to help you decide when it is a good time to repack\&.
-
+This counts the number of unpacked object files and disk space consumed by them, to help you decide when it is a good time to repack.
+.sp
.SH "OPTIONS"
-
.TP
\-v
-In addition to the number of loose objects and disk space consumed, it reports the number of in\-pack objects, and number of objects that can be removed by running git\-prune\-packed\&.
-
+In addition to the number of loose objects and disk space consumed, it reports the number of in\-pack objects, and number of objects that can be removed by running
+git\-prune\-packed.
.SH "AUTHOR"
-
-
-Written by Junio C Hamano <junkio@cox\&.net>
-
+Written by Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-CVSEXPORTCOMMIT" 1 "" "" ""
-.SH NAME
-git-cvsexportcommit \- Export a commit to a CVS checkout
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-cvsexportcommit \- Export a commit to a CVS checkout
.SH "SYNOPSIS"
-
-
\fIgit\-cvsexportcommit\fR [\-h] [\-v] [\-c] [\-p] [\-a] [\-f] [\-m msgprefix] [PARENTCOMMIT] COMMITID
-
+.sp
.SH "DESCRIPTION"
-
-
-Exports a commit from GIT to a CVS checkout, making it easier to merge patches from a git repository into a CVS repository\&.
-
-
-Execute it from the root of the CVS working copy\&. GIT_DIR must be defined\&. See examples below\&.
-
-
-It does its best to do the safe thing, it will check that the files are unchanged and up to date in the CVS checkout, and it will not autocommit by default\&.
-
-
-Supports file additions, removals, and commits that affect binary files\&.
-
-
-If the commit is a merge commit, you must tell git\-cvsapplycommit what parent should the changeset be done against\&.
-
+Exports a commit from GIT to a CVS checkout, making it easier to merge patches from a git repository into a CVS repository.
+.sp
+Execute it from the root of the CVS working copy. GIT_DIR must be defined. See examples below.
+.sp
+It does its best to do the safe thing, it will check that the files are unchanged and up to date in the CVS checkout, and it will not autocommit by default.
+.sp
+Supports file additions, removals, and commits that affect binary files.
+.sp
+If the commit is a merge commit, you must tell git\-cvsapplycommit what parent should the changeset be done against.
+.sp
.SH "OPTIONS"
-
.TP
\-c
-Commit automatically if the patch applied cleanly\&. It will not commit if any hunks fail to apply or there were other problems\&.
-
+Commit automatically if the patch applied cleanly. It will not commit if any hunks fail to apply or there were other problems.
.TP
\-p
-Be pedantic (paranoid) when applying patches\&. Invokes patch with \-\-fuzz=0
-
+Be pedantic (paranoid) when applying patches. Invokes patch with \-\-fuzz=0
.TP
\-a
-Add authorship information\&. Adds Author line, and Committer (if different from Author) to the message\&.
-
+Add authorship information. Adds Author line, and Committer (if different from Author) to the message.
.TP
\-f
-Force the merge even if the files are not up to date\&.
-
+Force the merge even if the files are not up to date.
.TP
\-m
-Prepend the commit message with the provided prefix\&. Useful for patch series and the like\&.
-
+Prepend the commit message with the provided prefix. Useful for patch series and the like.
.TP
\-v
-Verbose\&.
-
+Verbose.
.SH "EXAMPLES"
-
.TP
Merge one patch into CVS
-
+.sp
.nf
-$ export GIT_DIR=~/project/\&.git
+$ export GIT_DIR=~/project/.git
$ cd ~/project_cvs_checkout
$ git\-cvsexportcommit \-v <commit\-sha1>
-$ cvs commit \-F \&.mgs <files>
+$ cvs commit \-F .mgs <files>
.fi
-
.TP
-Merge pending patches into CVS automatically -- only if you really know what you are doing
-
+Merge pending patches into CVS automatically \(em only if you really know what you are doing
+.sp
.nf
-$ export GIT_DIR=~/project/\&.git
+$ export GIT_DIR=~/project/.git
$ cd ~/project_cvs_checkout
$ git\-cherry cvshead myhead | sed \-n 's/^+ //p' | xargs \-l1 git\-cvsexportcommit \-c \-p \-v
.fi
-
.SH "AUTHOR"
-
-
-Written by Martin Langhoff <martin@catalyst\&.net\&.nz>
-
+Written by Martin Langhoff <martin@catalyst.net.nz>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Martin Langhoff <martin@catalyst\&.net\&.nz>
-
+Documentation by Martin Langhoff <martin@catalyst.net.nz>
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-CVSIMPORT" 1 "" "" ""
-.SH NAME
-git-cvsimport \- Import a CVS repository into git
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-cvsimport \- Import a CVS repository into git
.SH "SYNOPSIS"
-
+.sp
.nf
\fIgit\-cvsimport\fR [\-o <branch\-for\-HEAD>] [\-h] [\-v] [\-d <CVSROOT>] [\-s <subst>]
[\-p <options\-for\-cvsps>] [\-C <git_repository>] [\-i] [\-P <file>]
[\-m] [\-M regex] [<CVS_module>]
.fi
-
.SH "DESCRIPTION"
-
-
-Imports a CVS repository into git\&. It will either create a new repository, or incrementally import into an existing one\&.
-
-
-Splitting the CVS log into patch sets is done by \fIcvsps\fR\&. At least version 2\&.1 is required\&.
-
-
-You should \fInever\fR do any work of your own on the branches that are created by git\-cvsimport\&. The initial import will create and populate a "master" branch from the CVS repository's main branch which you're free to work with; after that, you need to \fIgit merge\fR incremental imports, or any CVS branches, yourself\&.
-
+Imports a CVS repository into git. It will either create a new repository, or incrementally import into an existing one.
+.sp
+Splitting the CVS log into patch sets is done by \fIcvsps\fR. At least version 2.1 is required.
+.sp
+You should \fBnever\fR do any work of your own on the branches that are created by git\-cvsimport. The initial import will create and populate a "master" branch from the CVS repository's main branch which you're free to work with; after that, you need to \fIgit merge\fR incremental imports, or any CVS branches, yourself.
+.sp
.SH "OPTIONS"
-
.TP
\-d <CVSROOT>
-The root of the CVS archive\&. May be local (a simple path) or remote; currently, only the :local:, :ext: and :pserver: access methods are supported\&.
-
+The root of the CVS archive. May be local (a simple path) or remote; currently, only the :local:, :ext: and :pserver: access methods are supported.
.TP
\-C <target\-dir>
-The git repository to import to\&. If the directory doesn't exist, it will be created\&. Default is the current directory\&.
-
+The git repository to import to. If the directory doesn't exist, it will be created. Default is the current directory.
.TP
\-i
-Import\-only: don't perform a checkout after importing\&. This option ensures the working directory and index remain untouched and will not create them if they do not exist\&.
-
+Import\-only: don't perform a checkout after importing. This option ensures the working directory and index remain untouched and will not create them if they do not exist.
.TP
\-k
-Kill keywords: will extract files with \-kk from the CVS archive to avoid noisy changesets\&. Highly recommended, but off by default to preserve compatibility with early imported trees\&.
-
+Kill keywords: will extract files with \-kk from the CVS archive to avoid noisy changesets. Highly recommended, but off by default to preserve compatibility with early imported trees.
.TP
\-u
-Convert underscores in tag and branch names to dots\&.
-
+Convert underscores in tag and branch names to dots.
.TP
\-o <branch\-for\-HEAD>
-The \fIHEAD\fR branch from CVS is imported to the \fIorigin\fR branch within the git repository, as \fIHEAD\fR already has a special meaning for git\&. Use this option if you want to import into a different branch\&.
-
-Use \fI\-o master\fR for continuing an import that was initially done by the old cvs2git tool\&.
-
+The
+\fIHEAD\fR
+branch from CVS is imported to the
+\fIorigin\fR
+branch within the git repository, as
+\fIHEAD\fR
+already has a special meaning for git. Use this option if you want to import into a different branch.
+.sp
+Use
+\fI\-o master\fR
+for continuing an import that was initially done by the old cvs2git tool.
.TP
\-p <options\-for\-cvsps>
-Additional options for cvsps\&. The options \fI\-u\fR and \fI\-A\fR are implicit and should not be used here\&.
-
-If you need to pass multiple options, separate them with a comma\&.
-
+Additional options for cvsps. The options
+\fI\-u\fR
+and
+\fI\-A\fR
+are implicit and should not be used here.
+.sp
+If you need to pass multiple options, separate them with a comma.
.TP
\-P <cvsps\-output\-file>
-Instead of calling cvsps, read the provided cvsps output file\&. Useful for debugging or when cvsps is being handled outside cvsimport\&.
-
+Instead of calling cvsps, read the provided cvsps output file. Useful for debugging or when cvsps is being handled outside cvsimport.
.TP
\-m
-Attempt to detect merges based on the commit message\&. This option will enable default regexes that try to capture the name source branch name from the commit message\&.
-
+Attempt to detect merges based on the commit message. This option will enable default regexes that try to capture the name source branch name from the commit message.
.TP
\-M <regex>
-Attempt to detect merges based on the commit message with a custom regex\&. It can be used with \-m to also see the default regexes\&. You must escape forward slashes\&.
-
+Attempt to detect merges based on the commit message with a custom regex. It can be used with \-m to also see the default regexes. You must escape forward slashes.
.TP
\-v
-Verbosity: let \fIcvsimport\fR report what it is doing\&.
-
+Verbosity: let
+\fIcvsimport\fR
+report what it is doing.
.TP
<CVS_module>
-The CVS module you want to import\&. Relative to <CVSROOT>\&.
-
+The CVS module you want to import. Relative to <CVSROOT>.
.TP
\-h
-Print a short usage message and exit\&.
-
+Print a short usage message and exit.
.TP
\-z <fuzz>
-Pass the timestamp fuzz factor to cvsps\&.
-
+Pass the timestamp fuzz factor to cvsps.
.TP
\-s <subst>
Substitute the character "/" in branch names with <subst>
-
.TP
\-A <author\-conv\-file>
-CVS by default uses the unix username when writing its commit logs\&. Using this option and an author\-conv\-file in this format
-
-
+CVS by default uses the unix username when writing its commit logs. Using this option and an author\-conv\-file in this format
+.sp
.nf
- exon=Andreas Ericsson <ae@op5\&.se>
- spawn=Simon Pawn <spawn@frog\-pond\&.org>
-
+ exon=Andreas Ericsson <ae@op5.se>
+ spawn=Simon Pawn <spawn@frog\-pond.org>
.fi
-git\-cvsimport will make it appear as those authors had their GIT_AUTHOR_NAME and GIT_AUTHOR_EMAIL set properly all along\&.
-
-For convenience, this data is saved to $GIT_DIR/cvs\-authors each time the \-A option is provided and read from that same file each time git\-cvsimport is run\&.
-
-It is not recommended to use this feature if you intend to export changes back to CVS again later with \fBgit\-cvsexportcommit\fR(1)\&.
-
+git\-cvsimport will make it appear as those authors had their GIT_AUTHOR_NAME and GIT_AUTHOR_EMAIL set properly all along.
+.sp
+For convenience, this data is saved to $GIT_DIR/cvs\-authors each time the \-A option is provided and read from that same file each time git\-cvsimport is run.
+.sp
+It is not recommended to use this feature if you intend to export changes back to CVS again later with
+\fBgit\-cvsexportcommit\fR(1).
.SH "OUTPUT"
-
-
-If \fI\-v\fR is specified, the script reports what it is doing\&.
-
-
-Otherwise, success is indicated the Unix way, i\&.e\&. by simply exiting with a zero exit status\&.
-
+If \fI\-v\fR is specified, the script reports what it is doing.
+.sp
+Otherwise, success is indicated the Unix way, i.e. by simply exiting with a zero exit status.
+.sp
.SH "AUTHOR"
-
-
-Written by Matthias Urlichs <smurf@smurf\&.noris\&.de>, with help from various participants of the git\-list <git@vger\&.kernel\&.org>\&.
-
+Written by Matthias Urlichs <smurf@smurf.noris.de>, with help from various participants of the git\-list <git@vger.kernel.org>.
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Matthias Urlichs <smurf@smurf\&.noris\&.de>\&.
-
+Documentation by Matthias Urlichs <smurf@smurf.noris.de>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-CVSSERVER" 1 "" "" ""
-.SH NAME
-git-cvsserver \- A CVS server emulator for git
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-cvsserver \- A CVS server emulator for git
.SH "SYNOPSIS"
-
+.sp
.nf
export CVS_SERVER=git\-cvsserver
-\fIcvs\fR \-d :ext:user@server/path/repo\&.git co <HEAD_name>
+\fIcvs\fR \-d :ext:user@server/path/repo.git co <HEAD_name>
.fi
-
.SH "DESCRIPTION"
-
-
-This application is a CVS emulation layer for git\&.
-
-
-It is highly functional\&. However, not all methods are implemented, and for those methods that are implemented, not all switches are implemented\&.
-
-
-Testing has been done using both the CLI CVS client, and the Eclipse CVS plugin\&. Most functionality works fine with both of these clients\&.
-
+This application is a CVS emulation layer for git.
+.sp
+It is highly functional. However, not all methods are implemented, and for those methods that are implemented, not all switches are implemented.
+.sp
+Testing has been done using both the CLI CVS client, and the Eclipse CVS plugin. Most functionality works fine with both of these clients.
+.sp
.SH "LIMITATIONS"
-
-
-Currently cvsserver works over SSH connections for read/write clients, and over pserver for anonymous CVS access\&.
-
-
-CVS clients cannot tag, branch or perform GIT merges\&.
-
+Currently cvsserver works over SSH connections for read/write clients, and over pserver for anonymous CVS access.
+.sp
+CVS clients cannot tag, branch or perform GIT merges.
+.sp
.SH "INSTALLATION"
-
.TP 3
1.
-If you are going to offer anonymous CVS access via pserver, add a line in /etc/inetd\&.conf like
-
-
+If you are going to offer anonymous CVS access via pserver, add a line in /etc/inetd.conf like
+.sp
.nf
cvspserver stream tcp nowait nobody git\-cvsserver pserver
-
.fi
-Note: In some cases, you need to pass the \fIpserver\fR argument twice for git\-cvsserver to see it\&. So the line would look like
-
-
+Note: In some cases, you need to pass the
+\fIpserver\fR
+argument twice for git\-cvsserver to see it. So the line would look like
+.sp
.nf
cvspserver stream tcp nowait nobody git\-cvsserver pserver pserver
-
.fi
-No special setup is needed for SSH access, other than having GIT tools in the PATH\&. If you have clients that do not accept the CVS_SERVER env variable, you can rename git\-cvsserver to cvs\&.
+No special setup is needed for SSH access, other than having GIT tools in the PATH. If you have clients that do not accept the CVS_SERVER env variable, you can rename git\-cvsserver to cvs.
.TP
2.
-For each repo that you want accessible from CVS you need to edit config in the repo and add the following section\&.
-
-
+For each repo that you want accessible from CVS you need to edit config in the repo and add the following section.
+.sp
.nf
[gitcvs]
enabled=1
# optional for debugging
logfile=/path/to/logfile
-
.fi
-Note: you need to ensure each user that is going to invoke git\-cvsserver has write access to the log file and to the git repository\&. When offering anon access via pserver, this means that the nobody user should have write access to at least the sqlite database at the root of the repository\&.
+Note: you need to ensure each user that is going to invoke git\-cvsserver has write access to the log file and to the git repository. When offering anon access via pserver, this means that the nobody user should have write access to at least the sqlite database at the root of the repository.
.TP
3.
-On the client machine you need to set the following variables\&. CVSROOT should be set as per normal, but the directory should point at the appropriate git repo\&. For example:
-
+On the client machine you need to set the following variables. CVSROOT should be set as per normal, but the directory should point at the appropriate git repo. For example:
+.sp
For SSH access, CVS_SERVER should be set to git\-cvsserver
-
+.sp
Example:
-
+.sp
.nf
- export CVSROOT=:ext:user@server:/var/git/project\&.git
+ export CVSROOT=:ext:user@server:/var/git/project.git
export CVS_SERVER=git\-cvsserver
.fi
.TP
4.
-For SSH clients that will make commits, make sure their \&.bashrc file sets the GIT_AUTHOR and GIT_COMMITTER variables\&.
+For SSH clients that will make commits, make sure their .bashrc file sets the GIT_AUTHOR and GIT_COMMITTER variables.
.TP
5.
-Clients should now be able to check out the project\&. Use the CVS \fImodule\fR name to indicate what GIT \fIhead\fR you want to check out\&. Example:
-
+Clients should now be able to check out the project. Use the CVS
+\fImodule\fR
+name to indicate what GIT
+\fIhead\fR
+you want to check out. Example:
+.sp
.nf
cvs co \-d project\-master master
.fi
-.LP
-
.SH "ECLIPSE CVS CLIENT NOTES"
-
-
To get a checkout with the Eclipse CVS client:
-
+.sp
.TP 3
1.
Select "Create a new project \-> From CVS checkout"
.TP
2.
-Create a new location\&. See the notes below for details on how to choose the right protocol\&.
+Create a new location. See the notes below for details on how to choose the right protocol.
.TP
3.
-Browse the \fImodules\fR available\&. It will give you a list of the heads in the repository\&. You will not be able to browse the tree from there\&. Only the heads\&.
+Browse the
+\fImodules\fR
+available. It will give you a list of the heads in the repository. You will not be able to browse the tree from there. Only the heads.
.TP
4.
-Pick \fIHEAD\fR when it asks what branch/tag to check out\&. Untick the "launch commit wizard" to avoid committing the \&.project file\&.
-.LP
-
-
-Protocol notes: If you are using anonymous access via pserver, just select that\&. Those using SSH access should choose the \fIext\fR protocol, and configure \fIext\fR access on the Preferences\->Team\->CVS\->ExtConnection pane\&. Set CVS_SERVER to \fIgit\-cvsserver\fR\&. Not that password support is not good when using \fIext\fR, you will definitely want to have SSH keys setup\&.
-
-
-Alternatively, you can just use the non\-standard extssh protocol that Eclipse offer\&. In that case CVS_SERVER is ignored, and you will have to replace the cvs utility on the server with git\-cvsserver or manipulate your \&.bashrc so that calling \fIcvs\fR effectively calls git\-cvsserver\&.
-
+Pick
+\fIHEAD\fR
+when it asks what branch/tag to check out. Untick the "launch commit wizard" to avoid committing the .project file.
+Protocol notes: If you are using anonymous access via pserver, just select that. Those using SSH access should choose the \fIext\fR protocol, and configure \fIext\fR access on the Preferences\->Team\->CVS\->ExtConnection pane. Set CVS_SERVER to \fIgit\-cvsserver\fR. Not that password support is not good when using \fIext\fR, you will definitely want to have SSH keys setup.
+.sp
+Alternatively, you can just use the non\-standard extssh protocol that Eclipse offer. In that case CVS_SERVER is ignored, and you will have to replace the cvs utility on the server with git\-cvsserver or manipulate your .bashrc so that calling \fIcvs\fR effectively calls git\-cvsserver.
+.sp
.SH "CLIENTS KNOWN TO WORK"
-
-
-CVS 1\&.12\&.9 on Debian CVS 1\&.11\&.17 on MacOSX (from Fink package) Eclipse 3\&.0, 3\&.1\&.2 on MacOSX (see Eclipse CVS Client Notes) TortoiseCVS
-
+CVS 1.12.9 on Debian CVS 1.11.17 on MacOSX (from Fink package) Eclipse 3.0, 3.1.2 on MacOSX (see Eclipse CVS Client Notes) TortoiseCVS
+.sp
.SH "OPERATIONS SUPPORTED"
-
-
-All the operations required for normal use are supported, including checkout, diff, status, update, log, add, remove, commit\&. Legacy monitoring operations are not supported (edit, watch and related)\&. Exports and tagging (tags and branches) are not supported at this stage\&.
-
-
-The server will set the \-k mode to binary when relevant\&. In proper GIT tradition, the contents of the files are always respected\&. No keyword expansion or newline munging is supported\&.
-
+All the operations required for normal use are supported, including checkout, diff, status, update, log, add, remove, commit. Legacy monitoring operations are not supported (edit, watch and related). Exports and tagging (tags and branches) are not supported at this stage.
+.sp
+The server will set the \-k mode to binary when relevant. In proper GIT tradition, the contents of the files are always respected. No keyword expansion or newline munging is supported.
+.sp
.SH "DEPENDENCIES"
-
-
-git\-cvsserver depends on DBD::SQLite\&.
-
+git\-cvsserver depends on DBD::SQLite.
+.sp
.SH "COPYRIGHT AND AUTHORS"
-
-
-This program is copyright The Open University UK \- 2006\&.
-
-
-Authors: Martyn Smith <martyn@catalyst\&.net\&.nz> Martin Langhoff <martin@catalyst\&.net\&.nz> with ideas and patches from participants of the git\-list <git@vger\&.kernel\&.org>\&.
-
+This program is copyright The Open University UK \- 2006.
+.sp
+Authors: Martyn Smith <martyn@catalyst.net.nz> Martin Langhoff <martin@catalyst.net.nz> with ideas and patches from participants of the git\-list <git@vger.kernel.org>.
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Martyn Smith <martyn@catalyst\&.net\&.nz> and Martin Langhoff <martin@catalyst\&.net\&.nz> Matthias Urlichs <smurf@smurf\&.noris\&.de>\&.
-
+Documentation by Martyn Smith <martyn@catalyst.net.nz> and Martin Langhoff <martin@catalyst.net.nz> Matthias Urlichs <smurf@smurf.noris.de>.
+.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\-DAEMON" "1" "09/28/2006" "" ""
+.TH "GIT\-DAEMON" "1" "10/03/2006" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-DESCRIBE" 1 "" "" ""
-.SH NAME
-git-describe \- Show the most recent tag that is reachable from a commit
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-describe \- Show the most recent tag that is reachable from a commit
.SH "SYNOPSIS"
-
-
-\fIgit\-describe\fR [\-\-all] [\-\-tags] [\-\-abbrev=<n>] <committish>...
-
+\fIgit\-describe\fR [\-\-all] [\-\-tags] [\-\-abbrev=<n>] <committish>\&...
+.sp
.SH "DESCRIPTION"
-
-
-The command finds the most recent tag that is reachable from a commit, and if the commit itself is pointed at by the tag, shows the tag\&. Otherwise, it suffixes the tag name with abbreviated object name of the commit\&.
-
+The command finds the most recent tag that is reachable from a commit, and if the commit itself is pointed at by the tag, shows the tag. Otherwise, it suffixes the tag name with abbreviated object name of the commit.
+.sp
.SH "OPTIONS"
-
.TP
<committish>
-The object name of the committish\&.
-
+The object name of the committish.
.TP
\-\-all
-Instead of using only the annotated tags, use any ref found in \&.git/refs/\&.
-
+Instead of using only the annotated tags, use any ref found in
+.git/refs/.
.TP
\-\-tags
-Instead of using only the annotated tags, use any tag found in \&.git/refs/tags\&.
-
+Instead of using only the annotated tags, use any tag found in
+.git/refs/tags.
.TP
\-\-abbrev=<n>
-Instead of using the default 8 hexadecimal digits as the abbreviated object name, use <n> digits\&.
-
+Instead of using the default 8 hexadecimal digits as the abbreviated object name, use <n> digits.
.SH "EXAMPLES"
-
-
-With something like git\&.git current tree, I get:
-
+With something like git.git current tree, I get:
+.sp
+.sp
.nf
[torvalds@g5 git]$ git\-describe parent
-v1\&.0\&.4\-g2414721b
+v1.0.4\-g2414721b
.fi
-
-
-i\&.e\&. the current head of my "parent" branch is based on v1\&.0\&.4, but since it has a few commits on top of that, it has added the git hash of the thing to the end: "\-g" + 8\-char shorthand for the commit 2414721b194453f058079d897d13c4e377f92dc6\&.
-
-
+i.e. the current head of my "parent" branch is based on v1.0.4, but since it has a few commits on top of that, it has added the git hash of the thing to the end: "\-g" + 8\-char shorthand for the commit 2414721b194453f058079d897d13c4e377f92dc6.
+.sp
Doing a "git\-describe" on a tag\-name will just show the tag name:
-
+.sp
+.sp
.nf
-[torvalds@g5 git]$ git\-describe v1\&.0\&.4
-v1\&.0\&.4
+[torvalds@g5 git]$ git\-describe v1.0.4
+v1.0.4
.fi
-
-
With \-\-all, the command can use branch heads as references, so the output shows the reference path as well:
-
+.sp
+.sp
.nf
-[torvalds@g5 git]$ git describe \-\-all \-\-abbrev=4 v1\&.0\&.5^2
-tags/v1\&.0\&.0\-g975b
+[torvalds@g5 git]$ git describe \-\-all \-\-abbrev=4 v1.0.5^2
+tags/v1.0.0\-g975b
.fi
-
+.sp
.nf
[torvalds@g5 git]$ git describe \-\-all HEAD^
heads/lt/describe\-g975b
.fi
-
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>, but somewhat butchered by Junio C Hamano <junkio@cox\&.net>
-
+Written by Linus Torvalds <torvalds@osdl.org>, but somewhat butchered by Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+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\-DIFF\-FILES" "1" "10/01/2006" "" ""
+.TH "GIT\-DIFF\-FILES" "1" "10/03/2006" "" ""
.\" 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" "10/01/2006" "" ""
+.TH "GIT\-DIFF\-INDEX" "1" "10/03/2006" "" ""
.\" 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\-STAGES" "1" "10/01/2006" "" ""
+.TH "GIT\-DIFF\-STAGES" "1" "10/03/2006" "" ""
.\" 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" "10/01/2006" "" ""
+.TH "GIT\-DIFF\-TREE" "1" "10/03/2006" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-DIFF" 1 "" "" ""
-.SH NAME
-git-diff \- Show changes between commits, commit and working tree, etc
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-diff \- Show changes between commits, commit and working tree, etc
.SH "SYNOPSIS"
-
-
-\fIgit\-diff\fR [ \-\-diff\-options ] <tree\-ish>{0,2} [<path>...]
-
+\fIgit\-diff\fR [ \-\-diff\-options ] <tree\-ish>{0,2} [<path>\&...]
+.sp
.SH "DESCRIPTION"
-
-
-Show changes between two trees, a tree and the working tree, a tree and the index file, or the index file and the working tree\&. The combination of what is compared with what is determined by the number of trees given to the command\&.
-
+Show changes between two trees, a tree and the working tree, a tree and the index file, or the index file and the working tree. The combination of what is compared with what is determined by the number of trees given to the command.
+.sp
.TP 3
\(bu
-When no <tree\-ish> is given, the working tree and the index file are compared, using git\-diff\-files\&.
+When no <tree\-ish> is given, the working tree and the index file are compared, using
+git\-diff\-files.
.TP
\(bu
-When one <tree\-ish> is given, the working tree and the named tree are compared, using git\-diff\-index\&. The option \-\-cached can be given to compare the index file and the named tree\&.
+When one <tree\-ish> is given, the working tree and the named tree are compared, using
+git\-diff\-index. The option
+\-\-cached
+can be given to compare the index file and the named tree.
.TP
\(bu
-When two <tree\-ish>s are given, these two trees are compared using git\-diff\-tree\&.
-.LP
-
+When two <tree\-ish>s are given, these two trees are compared using
+git\-diff\-tree.
.SH "OPTIONS"
-
.TP
\-\-diff\-options
- \fI\-\-diff\-options\fR are passed to the git\-diff\-files, git\-diff\-index, and git\-diff\-tree commands\&. See the documentation for these commands for description\&.
-
+\fI\-\-diff\-options\fR
+are passed to the
+git\-diff\-files,
+git\-diff\-index, and
+git\-diff\-tree
+commands. See the documentation for these commands for description.
.TP
-<path>...
-The <path> arguments are also passed to git\-diff\-* commands\&.
-
+<path>\&...
+The <path> arguments are also passed to
+git\-diff\-*
+commands.
.SH "EXAMPLES"
-
.TP
Various ways to check your working tree
-
+.sp
.nf
$ git diff \fB(1)\fR
$ git diff \-\-cached \fB(2)\fR
$ git diff HEAD \fB(3)\fR
.fi
.sp
-\fB1. \fRchanges in the working tree since your last git\-update\-index\&.
+\fB1. \fRchanges in the working tree since your last git\-update\-index.
.br
-\fB2. \fRchanges between the index and your last commit; what you would be committing if you run "git commit" without "\-a" option\&.
+\fB2. \fRchanges between the index and your last commit; what you would be committing if you run "git commit" without "\-a" option.
.br
\fB3. \fRchanges in the working tree since your last commit; what you would be committing if you run "git commit \-a"
.br
-
-
.TP
Comparing with arbitrary commits
-
+.sp
.nf
$ git diff test \fB(1)\fR
-$ git diff HEAD \-\- \&./test \fB(2)\fR
+$ git diff HEAD \-\- ./test \fB(2)\fR
$ git diff HEAD^ HEAD \fB(3)\fR
.fi
.sp
-\fB1. \fRinstead of using the tip of the current branch, compare with the tip of "test" branch\&.
+\fB1. \fRinstead of using the tip of the current branch, compare with the tip of "test" branch.
.br
-\fB2. \fRinstead of comparing with the tip of "test" branch, compare with the tip of the current branch, but limit the comparison to the file "test"\&.
+\fB2. \fRinstead of comparing with the tip of "test" branch, compare with the tip of the current branch, but limit the comparison to the file "test".
.br
-\fB3. \fRcompare the version before the last commit and the last commit\&.
+\fB3. \fRcompare the version before the last commit and the last commit.
.br
-
-
.TP
Limiting the diff output
-
+.sp
.nf
$ git diff \-\-diff\-filter=MRC \fB(1)\fR
$ git diff \-\-name\-status \-r \fB(2)\fR
$ git diff arch/i386 include/asm\-i386 \fB(3)\fR
.fi
.sp
-\fB1. \fRshow only modification, rename and copy, but not addition nor deletion\&.
+\fB1. \fRshow only modification, rename and copy, but not addition nor deletion.
.br
-\fB2. \fRshow only names and the nature of change, but not actual diff output\&. \-\-name\-status disables usual patch generation which in turn also disables recursive behavior, so without \-r you would only see the directory name if there is a change in a file in a subdirectory\&.
+\fB2. \fRshow only names and the nature of change, but not actual diff output. \-\-name\-status disables usual patch generation which in turn also disables recursive behavior, so without \-r you would only see the directory name if there is a change in a file in a subdirectory.
.br
-\fB3. \fRlimit diff output to named subtrees\&.
+\fB3. \fRlimit diff output to named subtrees.
.br
-
-
.TP
Munging the diff output
-
+.sp
.nf
$ git diff \-\-find\-copies\-harder \-B \-C \fB(1)\fR
$ git diff \-R \fB(2)\fR
.fi
.sp
-\fB1. \fRspend extra cycles to find renames, copies and complete rewrites (very expensive)\&.
+\fB1. \fRspend extra cycles to find renames, copies and complete rewrites (very expensive).
.br
-\fB2. \fRoutput diff in reverse\&.
+\fB2. \fRoutput diff in reverse.
.br
-
-
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+Written by Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-FETCH-PACK" 1 "" "" ""
-.SH NAME
-git-fetch-pack \- Receive missing objects from another repository
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-fetch\-pack \- Receive missing objects from another repository
.SH "SYNOPSIS"
-
-
-\fIgit\-fetch\-pack\fR [\-q] [\-k] [\-\-exec=<git\-upload\-pack>] [<host>:]<directory> [<refs>...]
-
+\fIgit\-fetch\-pack\fR [\-q] [\-k] [\-\-exec=<git\-upload\-pack>] [<host>:]<directory> [<refs>\&...]
+.sp
.SH "DESCRIPTION"
-
-
-Invokes \fIgit\-upload\-pack\fR on a potentially remote repository, and asks it to send objects missing from this repository, to update the named heads\&. The list of commits available locally is found out by scanning local $GIT_DIR/refs/ and sent to \fIgit\-upload\-pack\fR running on the other end\&.
-
-
-This command degenerates to download everything to complete the asked refs from the remote side when the local side does not have a common ancestor commit\&.
-
+Invokes \fIgit\-upload\-pack\fR on a potentially remote repository, and asks it to send objects missing from this repository, to update the named heads. The list of commits available locally is found out by scanning local $GIT_DIR/refs/ and sent to \fIgit\-upload\-pack\fR running on the other end.
+.sp
+This command degenerates to download everything to complete the asked refs from the remote side when the local side does not have a common ancestor commit.
+.sp
.SH "OPTIONS"
-
.TP
\-q
-Pass \fI\-q\fR flag to \fIgit\-unpack\-objects\fR; this makes the cloning process less verbose\&.
-
+Pass
+\fI\-q\fR
+flag to
+\fIgit\-unpack\-objects\fR; this makes the cloning process less verbose.
.TP
\-k
-Do not invoke \fIgit\-unpack\-objects\fR on received data, but create a single packfile out of it instead, and store it in the object database\&.
-
+Do not invoke
+\fIgit\-unpack\-objects\fR
+on received data, but create a single packfile out of it instead, and store it in the object database.
.TP
\-\-exec=<git\-upload\-pack>
-Use this to specify the path to \fIgit\-upload\-pack\fR on the remote side, if is not found on your $PATH\&. Installations of sshd ignores the user's environment setup scripts for login shells (e\&.g\&. \&.bash_profile) and your privately installed git may not be found on the system default $PATH\&. Another workaround suggested is to set up your $PATH in "\&.bashrc", but this flag is for people who do not want to pay the overhead for non\-interactive shells by having a lean \&.bashrc file (they set most of the things up in \&.bash_profile)\&.
-
+Use this to specify the path to
+\fIgit\-upload\-pack\fR
+on the remote side, if is not found on your $PATH. Installations of sshd ignores the user's environment setup scripts for login shells (e.g. .bash_profile) and your privately installed git may not be found on the system default $PATH. Another workaround suggested is to set up your $PATH in ".bashrc", but this flag is for people who do not want to pay the overhead for non\-interactive shells by having a lean .bashrc file (they set most of the things up in .bash_profile).
.TP
<host>
-A remote host that houses the repository\&. When this part is specified, \fIgit\-upload\-pack\fR is invoked via ssh\&.
-
+A remote host that houses the repository. When this part is specified,
+\fIgit\-upload\-pack\fR
+is invoked via ssh.
.TP
<directory>
-The repository to sync from\&.
-
+The repository to sync from.
.TP
-<refs>...
-The remote heads to update from\&. This is relative to $GIT_DIR (e\&.g\&. "HEAD", "refs/heads/master")\&. When unspecified, update from all heads the remote side has\&.
-
+<refs>\&...
+The remote heads to update from. This is relative to $GIT_DIR (e.g. "HEAD", "refs/heads/master"). When unspecified, update from all heads the remote side has.
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+Written by Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano\&.
-
+Documentation by Junio C Hamano.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-FETCH" 1 "" "" ""
-.SH NAME
-git-fetch \- Download objects and a head from another repository
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-fetch \- Download objects and a head from another repository
.SH "SYNOPSIS"
-
-
-\fIgit\-fetch\fR <options> <repository> <refspec>...
-
+\fIgit\-fetch\fR <options> <repository> <refspec>\&...
+.sp
.SH "DESCRIPTION"
-
-
-Fetches named heads or tags from another repository, along with the objects necessary to complete them\&.
-
-
-The ref names and their object names of fetched refs are stored in \&.git/FETCH_HEAD\&. This information is left for a later merge operation done by "git merge"\&.
-
+Fetches named heads or tags from another repository, along with the objects necessary to complete them.
+.sp
+The ref names and their object names of fetched refs are stored in .git/FETCH_HEAD. This information is left for a later merge operation done by "git merge".
+.sp
.SH "OPTIONS"
-
.TP
\-a, \-\-append
-Append ref names and object names of fetched refs to the existing contents of \&.git/FETCH_HEAD\&. Without this option old data in \&.git/FETCH_HEAD will be overwritten\&.
-
+Append ref names and object names of fetched refs to the existing contents of
+.git/FETCH_HEAD. Without this option old data in
+.git/FETCH_HEAD
+will be overwritten.
.TP
\-\-upload\-pack <upload\-pack>
-When given, and the repository to fetch from is handled by \fIgit\-fetch\-pack\fR, \fI\-\-exec=<upload\-pack>\fR is passed to the command to specify non\-default path for the command run on the other end\&.
-
+When given, and the repository to fetch from is handled by
+\fIgit\-fetch\-pack\fR,
+\fI\-\-exec=<upload\-pack>\fR
+is passed to the command to specify non\-default path for the command run on the other end.
.TP
\-f, \-\-force
-When git\-fetch is used with <rbranch>:<lbranch> refspec, it refuses to update the local branch <lbranch> unless the remote branch <rbranch> it fetches is a descendant of <lbranch>\&. This option overrides that check\&.
-
+When
+git\-fetch
+is used with
+<rbranch>:<lbranch>
+refspec, it refuses to update the local branch
+<lbranch>
+unless the remote branch
+<rbranch>
+it fetches is a descendant of
+<lbranch>. This option overrides that check.
.TP
\-\-no\-tags
-By default, git\-fetch fetches tags that point at objects that are downloaded from the remote repository and stores them locally\&. This option disables this automatic tag following\&.
-
+By default,
+git\-fetch
+fetches tags that point at objects that are downloaded from the remote repository and stores them locally. This option disables this automatic tag following.
.TP
\-t, \-\-tags
-Most of the tags are fetched automatically as branch heads are downloaded, but tags that do not point at objects reachable from the branch heads that are being tracked will not be fetched by this mechanism\&. This flag lets all tags and their associated objects be downloaded\&.
-
+Most of the tags are fetched automatically as branch heads are downloaded, but tags that do not point at objects reachable from the branch heads that are being tracked will not be fetched by this mechanism. This flag lets all tags and their associated objects be downloaded.
.TP
\-k, \-\-keep
-Keep downloaded pack\&.
-
+Keep downloaded pack.
.TP
\-u, \-\-update\-head\-ok
-By default git\-fetch refuses to update the head which corresponds to the current branch\&. This flag disables the check\&. Note that fetching into the current branch will not update the index and working directory, so use it with care\&.
-
+By default
+git\-fetch
+refuses to update the head which corresponds to the current branch. This flag disables the check. Note that fetching into the current branch will not update the index and working directory, so use it with care.
.TP
<repository>
-The "remote" repository that is the source of a fetch or pull operation\&. See the section GIT URLS below\&.
-
+The "remote" repository that is the source of a fetch or pull operation. See the section
+GIT URLS
+below.
.TP
<refspec>
-The canonical format of a <refspec> parameter is +?<src>:<dst>; that is, an optional plus +, followed by the source ref, followed by a colon :, followed by the destination ref\&.
-
-The remote ref that matches <src> is fetched, and if <dst> is not empty string, the local ref that matches it is fast forwarded using <src>\&. Again, if the optional plus + is used, the local ref is updated even if it does not result in a fast forward update\&.
-
-
-.RS
-.Sh "Note"
-If the remote branch from which you want to pull is modified in non\-linear ways such as being rewound and rebased frequently, then a pull will attempt a merge with an older version of itself, likely conflict, and fail\&. It is under these conditions that you would want to use the + sign to indicate non\-fast\-forward updates will be needed\&. There is currently no easy way to determine or declare that a branch will be made available in a repository with this behavior; the pulling user simply must know this is the expected usage pattern for a branch\&.
-
-.RE
-
-.RS
-.Sh "Note"
-You never do your own development on branches that appear on the right hand side of a <refspec> colon on Pull: lines; they are to be updated by git\-fetch\&. If you intend to do development derived from a remote branch B, have a Pull: line to track it (i\&.e\&. Pull: B:remote\-B), and have a separate branch my\-B to do your development on top of it\&. The latter is created by git branch my\-B remote\-B (or its equivalent git checkout \-b my\-B remote\-B)\&. Run git fetch to keep track of the progress of the remote side, and when you see something new on the remote branch, merge it into your development branch with git pull \&. remote\-B, while you are on my\-B branch\&. The common Pull: master:origin mapping of a remote master branch to a local origin branch, which is then merged to a local development branch, again typically named master, is made when you run git clone for you to follow this pattern\&.
-
-.RE
-
-.RS
-.Sh "Note"
-There is a difference between listing multiple <refspec> directly on git\-pull command line and having multiple Pull: <refspec> lines for a <repository> and running git\-pull command without any explicit <refspec> parameters\&. <refspec> listed explicitly on the command line are always merged into the current branch after fetching\&. In other words, if you list more than one remote refs, you would be making an Octopus\&. While git\-pull run without any explicit <refspec> parameter takes default <refspec>s from Pull: lines, it merges only the first <refspec> found into the current branch, after fetching all the remote refs\&. This is because making an Octopus from remote refs is rarely done, while keeping track of multiple remote heads in one\-go by fetching more than one is often useful\&.
-
-.RE
-Some short\-cut notations are also supported\&.
-
+The canonical format of a <refspec> parameter is
++?<src>:<dst>; that is, an optional plus
++, followed by the source ref, followed by a colon
+:, followed by the destination ref.
+.sp
+The remote ref that matches <src> is fetched, and if <dst> is not empty string, the local ref that matches it is fast forwarded using <src>. Again, if the optional plus
++
+is used, the local ref is updated even if it does not result in a fast forward update.
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+\fBNote\fR
+If the remote branch from which you want to pull is modified in non\-linear ways such as being rewound and rebased frequently, then a pull will attempt a merge with an older version of itself, likely conflict, and fail. It is under these conditions that you would want to use the
++
+sign to indicate non\-fast\-forward updates will be needed. There is currently no easy way to determine or declare that a branch will be made available in a repository with this behavior; the pulling user simply must know this is the expected usage pattern for a branch.
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+\fBNote\fR
+You never do your own development on branches that appear on the right hand side of a <refspec> colon on
+Pull:
+lines; they are to be updated by
+git\-fetch. If you intend to do development derived from a remote branch
+B, have a
+Pull:
+line to track it (i.e.
+Pull: B:remote\-B), and have a separate branch
+my\-B
+to do your development on top of it. The latter is created by
+git branch my\-B remote\-B
+(or its equivalent
+git checkout \-b my\-B remote\-B). Run
+git fetch
+to keep track of the progress of the remote side, and when you see something new on the remote branch, merge it into your development branch with
+git pull . remote\-B, while you are on
+my\-B
+branch. The common
+Pull: master:origin
+mapping of a remote
+master
+branch to a local
+origin
+branch, which is then merged to a local development branch, again typically named
+master, is made when you run
+git clone
+for you to follow this pattern.
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+\fBNote\fR
+There is a difference between listing multiple <refspec> directly on
+git\-pull
+command line and having multiple
+Pull:
+<refspec> lines for a <repository> and running
+git\-pull
+command without any explicit <refspec> parameters. <refspec> listed explicitly on the command line are always merged into the current branch after fetching. In other words, if you list more than one remote refs, you would be making an Octopus. While
+git\-pull
+run without any explicit <refspec> parameter takes default <refspec>s from
+Pull:
+lines, it merges only the first <refspec> found into the current branch, after fetching all the remote refs. This is because making an Octopus from remote refs is rarely done, while keeping track of multiple remote heads in one\-go by fetching more than one is often useful.
+Some short\-cut notations are also supported.
.RS
.TP 3
\(bu
- tag <tag> means the same as refs/tags/<tag>:refs/tags/<tag>; it requests fetching everything up to the given tag\&.
+tag <tag>
+means the same as
+refs/tags/<tag>:refs/tags/<tag>; it requests fetching everything up to the given tag.
.TP
\(bu
A parameter <ref> without a colon is equivalent to <ref>: when pulling/fetching, so it merges <ref> into the current branch without storing the remote branch anywhere locally
-.LP
.RE
-.IP
-
.SH "GIT URLS"
-
-
One of the following notations can be used to name the remote repository:
-
+.sp
.IP
-
.TP 3
\(bu
-rsync://host\&.xz/path/to/repo\&.git/
+rsync://host.xz/path/to/repo.git/
.TP
\(bu
-http://host\&.xz/path/to/repo\&.git/
+http://host.xz/path/to/repo.git/
.TP
\(bu
-https://host\&.xz/path/to/repo\&.git/
+https://host.xz/path/to/repo.git/
.TP
\(bu
-git://host\&.xz/path/to/repo\&.git/
+git://host.xz/path/to/repo.git/
.TP
\(bu
-git://host\&.xz/~user/path/to/repo\&.git/
+git://host.xz/~user/path/to/repo.git/
.TP
\(bu
-ssh://[user@]host\&.xz/path/to/repo\&.git/
+ssh://[user@]host.xz/path/to/repo.git/
.TP
\(bu
-ssh://[user@]host\&.xz/~user/path/to/repo\&.git/
+ssh://[user@]host.xz/~user/path/to/repo.git/
.TP
\(bu
-ssh://[user@]host\&.xz/~/path/to/repo\&.git
-.LP
-
-
-SSH is the default transport protocol\&. You can optionally specify which user to log\-in as, and an alternate, scp\-like syntax is also supported\&. Both syntaxes support username expansion, as does the native git protocol\&. The following three are identical to the last three above, respectively:
-
+ssh://[user@]host.xz/~/path/to/repo.git
+SSH is the default transport protocol. You can optionally specify which user to log\-in as, and an alternate, scp\-like syntax is also supported. Both syntaxes support username expansion, as does the native git protocol. The following three are identical to the last three above, respectively:
+.sp
.IP
-
.TP 3
\(bu
-[user@]host\&.xz:/path/to/repo\&.git/
+[user@]host.xz:/path/to/repo.git/
.TP
\(bu
-[user@]host\&.xz:~user/path/to/repo\&.git/
+[user@]host.xz:~user/path/to/repo.git/
.TP
\(bu
-[user@]host\&.xz:path/to/repo\&.git
-.LP
-
-
+[user@]host.xz:path/to/repo.git
To sync with a local directory, use:
-
+.sp
.IP
-
.TP 3
\(bu
-/path/to/repo\&.git/
-.LP
-
+/path/to/repo.git/
.SH "REMOTES"
-
-
In addition to the above, as a short\-hand, the name of a file in $GIT_DIR/remotes directory can be given; the named file should be in the following format:
-
+.sp
+.sp
.nf
URL: one of the above URL format
Push: <refspec>
Pull: <refspec>
.fi
-
-
-Then such a short\-hand is specified in place of <repository> without <refspec> parameters on the command line, <refspec> specified on Push: lines or Pull: lines are used for git\-push and git\-fetch/git\-pull, respectively\&. Multiple Push: and Pull: lines may be specified for additional branch mappings\&.
-
-
-The name of a file in $GIT_DIR/branches directory can be specified as an older notation short\-hand; the named file should contain a single line, a URL in one of the above formats, optionally followed by a hash # and the name of remote head (URL fragment notation)\&. $GIT_DIR/branches/<remote> file that stores a <url> without the fragment is equivalent to have this in the corresponding file in the $GIT_DIR/remotes/ directory\&.
-
+Then such a short\-hand is specified in place of <repository> without <refspec> parameters on the command line, <refspec> specified on Push: lines or Pull: lines are used for git\-push and git\-fetch/git\-pull, respectively. Multiple Push: and Pull: lines may be specified for additional branch mappings.
+.sp
+The name of a file in $GIT_DIR/branches directory can be specified as an older notation short\-hand; the named file should contain a single line, a URL in one of the above formats, optionally followed by a hash # and the name of remote head (URL fragment notation). $GIT_DIR/branches/<remote> file that stores a <url> without the fragment is equivalent to have this in the corresponding file in the $GIT_DIR/remotes/ directory.
+.sp
+.sp
.nf
URL: <url>
Pull: refs/heads/master:<remote>
.fi
-
-
while having <url>#<head> is equivalent to
-
+.sp
+.sp
.nf
URL: <url>
Pull: refs/heads/<head>:<remote>
.fi
-
.SH "SEE ALSO"
-
-
\fBgit\-pull\fR(1)
-
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org> and Junio C Hamano <junkio@cox\&.net>
-
+Written by Linus Torvalds <torvalds@osdl.org> and Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-FMT-MERGE-MSG" 1 "" "" ""
-.SH NAME
-git-fmt-merge-msg \- Produce a merge commit message
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+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\&.
-
-
-This script is intended mostly for internal use by scripts automatically invoking git\-merge\&.
-
+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>
-
+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>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-FORMAT-PATCH" 1 "" "" ""
-.SH NAME
-git-format-patch \- Prepare patches for e-mail submission
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-format\-patch \- Prepare patches for e\-mail submission
.SH "SYNOPSIS"
-
+.sp
.nf
\fIgit\-format\-patch\fR [\-n | \-k] [\-o <dir> | \-\-stdout] [\-\-attach] [\-\-thread]
[\-s | \-\-signoff] [\-\-diff\-options] [\-\-start\-number <n>]
[\-\-in\-reply\-to=Message\-Id]
- <since>[\&.\&.<until>]
+ <since>[..<until>]
.fi
-
.SH "DESCRIPTION"
-
-
-Prepare each commit between <since> and <until> with its patch in one file per commit, formatted to resemble UNIX mailbox format\&. If \&.\&.<until> is not specified, the head of the current working tree is implied\&.
-
-
-The output of this command is convenient for e\-mail submission or for use with \fBgit\-am\fR(1)\&.
-
-
-Each output file is numbered sequentially from 1, and uses the first line of the commit message (massaged for pathname safety) as the filename\&. The names of the output files are printed to standard output, unless the \-\-stdout option is specified\&.
-
-
-If \-o is specified, output files are created in <dir>\&. Otherwise they are created in the current working directory\&.
-
-
-If \-n is specified, instead of "[PATCH] Subject", the first line is formatted as "[PATCH n/m] Subject"\&.
-
-
-If given \-\-thread, git\-format\-patch will generate In\-Reply\-To and References headers to make the second and subsequent patch mails appear as replies to the first mail; this also generates a Message\-Id header to reference\&.
-
+Prepare each commit between <since> and <until> with its patch in one file per commit, formatted to resemble UNIX mailbox format. If ..<until> is not specified, the head of the current working tree is implied.
+.sp
+The output of this command is convenient for e\-mail submission or for use with \fBgit\-am\fR(1).
+.sp
+Each output file is numbered sequentially from 1, and uses the first line of the commit message (massaged for pathname safety) as the filename. The names of the output files are printed to standard output, unless the \-\-stdout option is specified.
+.sp
+If \-o is specified, output files are created in <dir>. Otherwise they are created in the current working directory.
+.sp
+If \-n is specified, instead of "[PATCH] Subject", the first line is formatted as "[PATCH n/m] Subject".
+.sp
+If given \-\-thread, git\-format\-patch will generate In\-Reply\-To and References headers to make the second and subsequent patch mails appear as replies to the first mail; this also generates a Message\-Id header to reference.
+.sp
.SH "OPTIONS"
-
.TP
\-o|\-\-output\-directory <dir>
-Use <dir> to store the resulting files, instead of the current working directory\&.
-
+Use <dir> to store the resulting files, instead of the current working directory.
.TP
\-n|\-\-numbered
-Name output in \fI[PATCH n/m]\fR format\&.
-
+Name output in
+\fI[PATCH n/m]\fR
+format.
.TP
\-\-start\-number <n>
-Start numbering the patches at <n> instead of 1\&.
-
+Start numbering the patches at <n> instead of 1.
.TP
\-k|\-\-keep\-subject
-Do not strip/add \fI[PATCH]\fR from the first line of the commit log message\&.
-
+Do not strip/add
+\fI[PATCH]\fR
+from the first line of the commit log message.
.TP
\-s|\-\-signoff
-Add Signed\-off\-by: line to the commit message, using the committer identity of yourself\&.
-
+Add
+Signed\-off\-by:
+line to the commit message, using the committer identity of yourself.
.TP
\-\-stdout
-Print all commits to the standard output in mbox format, instead of creating a file for each one\&.
-
+Print all commits to the standard output in mbox format, instead of creating a file for each one.
.TP
\-\-attach
-Create attachments instead of inlining patches\&.
-
+Create attachments instead of inlining patches.
.TP
\-\-thread
-Add In\-Reply\-To and References headers to make the second and subsequent mails appear as replies to the first\&. Also generates the Message\-Id header to reference\&.
-
+Add In\-Reply\-To and References headers to make the second and subsequent mails appear as replies to the first. Also generates the Message\-Id header to reference.
.TP
\-\-in\-reply\-to=Message\-Id
-Make the first mail (or all the mails with \-\-no\-thread) appear as a reply to the given Message\-Id, which avoids breaking threads to provide a new patch series\&.
-
+Make the first mail (or all the mails with \-\-no\-thread) appear as a reply to the given Message\-Id, which avoids breaking threads to provide a new patch series.
.SH "CONFIGURATION"
-
-
You can specify extra mail header lines to be added to each message in the repository configuration as follows:
-
+.sp
+.sp
.nf
headers = "Organization: git\-foo\\n"
.fi
-
.SH "EXAMPLES"
-
.TP
-git\-format\-patch \-k \-\-stdout R1\&.\&.R2 | git\-am \-3 \-k
-Extract commits between revisions R1 and R2, and apply them on top of the current branch using git\-am to cherry\-pick them\&.
-
+git\-format\-patch \-k \-\-stdout R1..R2 | git\-am \-3 \-k
+Extract commits between revisions R1 and R2, and apply them on top of the current branch using
+git\-am
+to cherry\-pick them.
.TP
git\-format\-patch origin
-Extract all commits which are in the current branch but not in the origin branch\&. For each commit a separate file is created in the current directory\&.
-
+Extract all commits which are in the current branch but not in the origin branch. For each commit a separate file is created in the current directory.
.TP
git\-format\-patch \-M \-B origin
-The same as the previous one\&. Additionally, it detects and handles renames and complete rewrites intelligently to produce a renaming patch\&. A renaming patch reduces the amount of text output, and generally makes it easier to review it\&. Note that the "patch" program does not understand renaming patches, so use it only when you know the recipient uses git to apply your patch\&.
-
+The same as the previous one. Additionally, it detects and handles renames and complete rewrites intelligently to produce a renaming patch. A renaming patch reduces the amount of text output, and generally makes it easier to review it. Note that the "patch" program does not understand renaming patches, so use it only when you know the recipient uses git to apply your patch.
.SH "SEE ALSO"
-
-
\fBgit\-am\fR(1), \fBgit\-send\-email\fR(1)
-
+.sp
.SH "AUTHOR"
-
-
-Written by Junio C Hamano <junkio@cox\&.net>
-
+Written by Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-FSCK-OBJECTS" 1 "" "" ""
-.SH NAME
-git-fsck-objects \- Verifies the connectivity and validity of the objects in the database
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-fsck\-objects \- Verifies the connectivity and validity of the objects in the database
.SH "SYNOPSIS"
-
+.sp
.nf
\fIgit\-fsck\-objects\fR [\-\-tags] [\-\-root] [\-\-unreachable] [\-\-cache]
[\-\-full] [\-\-strict] [<object>*]
.fi
-
.SH "DESCRIPTION"
-
-
-Verifies the connectivity and validity of the objects in the database\&.
-
+Verifies the connectivity and validity of the objects in the database.
+.sp
.SH "OPTIONS"
-
.TP
<object>
-An object to treat as the head of an unreachability trace\&.
-
-If no objects are given, git\-fsck\-objects defaults to using the index file and all SHA1 references in \&.git/refs/* as heads\&.
-
+An object to treat as the head of an unreachability trace.
+.sp
+If no objects are given, git\-fsck\-objects defaults to using the index file and all SHA1 references in .git/refs/* as heads.
.TP
\-\-unreachable
-Print out objects that exist but that aren't readable from any of the reference nodes\&.
-
+Print out objects that exist but that aren't readable from any of the reference nodes.
.TP
\-\-root
-Report root nodes\&.
-
+Report root nodes.
.TP
\-\-tags
-Report tags\&.
-
+Report tags.
.TP
\-\-cache
-Consider any object recorded in the index also as a head node for an unreachability trace\&.
-
+Consider any object recorded in the index also as a head node for an unreachability trace.
.TP
\-\-full
-Check not just objects in GIT_OBJECT_DIRECTORY ($GIT_DIR/objects), but also the ones found in alternate object pools listed in GIT_ALTERNATE_OBJECT_DIRECTORIES or $GIT_DIR/objects/info/alternates, and in packed git archives found in $GIT_DIR/objects/pack and corresponding pack subdirectories in alternate object pools\&.
-
+Check not just objects in GIT_OBJECT_DIRECTORY ($GIT_DIR/objects), but also the ones found in alternate object pools listed in GIT_ALTERNATE_OBJECT_DIRECTORIES or $GIT_DIR/objects/info/alternates, and in packed git archives found in $GIT_DIR/objects/pack and corresponding pack subdirectories in alternate object pools.
.TP
\-\-strict
-Enable more strict checking, namely to catch a file mode recorded with g+w bit set, which was created by older versions of git\&. Existing repositories, including the Linux kernel, git itself, and sparse repository have old objects that triggers this check, but it is recommended to check new projects with this flag\&.
-
-
-It tests SHA1 and general object sanity, and it does full tracking of the resulting reachability and everything else\&. It prints out any corruption it finds (missing or bad objects), and if you use the \fI\-\-unreachable\fR flag it will also print out objects that exist but that aren't readable from any of the specified head nodes\&.
-
-
+Enable more strict checking, namely to catch a file mode recorded with g+w bit set, which was created by older versions of git. Existing repositories, including the Linux kernel, git itself, and sparse repository have old objects that triggers this check, but it is recommended to check new projects with this flag.
+It tests SHA1 and general object sanity, and it does full tracking of the resulting reachability and everything else. It prints out any corruption it finds (missing or bad objects), and if you use the \fI\-\-unreachable\fR flag it will also print out objects that exist but that aren't readable from any of the specified head nodes.
+.sp
So for example
-
+.sp
+.sp
.nf
-git\-fsck\-objects \-\-unreachable HEAD $(cat \&.git/refs/heads/*)
+git\-fsck\-objects \-\-unreachable HEAD $(cat .git/refs/heads/*)
.fi
-
-
-will do quite a _lot_ of verification on the tree\&. There are a few extra validity tests to be added (make sure that tree objects are sorted properly etc), but on the whole if "git\-fsck\-objects" is happy, you do have a valid tree\&.
-
-
-Any corrupt objects you will have to find in backups or other archives (i\&.e\&., you can just remove them and do an "rsync" with some other site in the hopes that somebody else has the object you have corrupted)\&.
-
-
-Of course, "valid tree" doesn't mean that it wasn't generated by some evil person, and the end result might be crap\&. git is a revision tracking system, not a quality assurance system ;)
-
+will do quite a _lot_ of verification on the tree. There are a few extra validity tests to be added (make sure that tree objects are sorted properly etc), but on the whole if "git\-fsck\-objects" is happy, you do have a valid tree.
+.sp
+Any corrupt objects you will have to find in backups or other archives (i.e., you can just remove them and do an "rsync" with some other site in the hopes that somebody else has the object you have corrupted).
+.sp
+Of course, "valid tree" doesn't mean that it wasn't generated by some evil person, and the end result might be crap. git is a revision tracking system, not a quality assurance system ;)
+.sp
.SH "EXTRACTED DIAGNOSTICS"
-
.TP
expect dangling commits \- potential heads \- due to lack of head information
-You haven't specified any nodes as heads so it won't be possible to differentiate between un\-parented commits and root nodes\&.
-
+You haven't specified any nodes as heads so it won't be possible to differentiate between un\-parented commits and root nodes.
.TP
missing sha1 directory \fI<dir>\fR
-The directory holding the sha1 objects is missing\&.
-
+The directory holding the sha1 objects is missing.
.TP
unreachable <type> <object>
-The <type> object <object>, isn't actually referred to directly or indirectly in any of the trees or commits seen\&. This can mean that there's another root node that you're not specifying or that the tree is corrupt\&. If you haven't missed a root node then you might as well delete unreachable nodes since they can't be used\&.
-
+The <type> object <object>, isn't actually referred to directly or indirectly in any of the trees or commits seen. This can mean that there's another root node that you're not specifying or that the tree is corrupt. If you haven't missed a root node then you might as well delete unreachable nodes since they can't be used.
.TP
missing <type> <object>
-The <type> object <object>, is referred to but isn't present in the database\&.
-
+The <type> object <object>, is referred to but isn't present in the database.
.TP
dangling <type> <object>
-The <type> object <object>, is present in the database but never \fIdirectly\fR used\&. A dangling commit could be a root node\&.
-
+The <type> object <object>, is present in the database but never
+\fIdirectly\fR
+used. A dangling commit could be a root node.
.TP
warning: git\-fsck\-objects: tree <tree> has full pathnames in it
-And it shouldn't...
-
+And it shouldn't\&...
.TP
sha1 mismatch <object>
-The database has an object who's sha1 doesn't match the database value\&. This indicates a serious data integrity problem\&.
-
+The database has an object who's sha1 doesn't match the database value. This indicates a serious data integrity problem.
.SH "ENVIRONMENT VARIABLES"
-
.TP
GIT_OBJECT_DIRECTORY
used to specify the object database root (usually $GIT_DIR/objects)
-
.TP
GIT_INDEX_FILE
used to specify the index file of the index
-
.TP
GIT_ALTERNATE_OBJECT_DIRECTORIES
used to specify additional object database roots (usually unset)
-
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+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>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-GET-TAR-COMMIT" 1 "" "" ""
-.SH NAME
-git-get-tar-commit-id \- Extract commit ID from an archive created using git-tar-tree
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+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\&.
-
-
-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\&.
-
+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>
-
+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>\&.
-
+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" "09/16/2006" "" ""
+.TH "GIT\-GREP" "1" "10/03/2006" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-HASH-OBJECT" 1 "" "" ""
-.SH NAME
-git-hash-object \- Computes object ID and optionally creates a blob from a file
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-hash\-object \- Computes object ID and optionally creates a blob from a file
.SH "SYNOPSIS"
-
-
-\fIgit\-hash\-object\fR [\-t <type>] [\-w] [\-\-stdin] [\-\-] <file>...
-
+\fIgit\-hash\-object\fR [\-t <type>] [\-w] [\-\-stdin] [\-\-] <file>\&...
+.sp
.SH "DESCRIPTION"
-
-
-Computes the object ID value for an object with specified type with the contents of the named file (which can be outside of the work tree), and optionally writes the resulting object into the object database\&. Reports its object ID to its standard output\&. This is used by "git\-cvsimport" to update the index without modifying files in the work tree\&. When <type> is not specified, it defaults to "blob"\&.
-
+Computes the object ID value for an object with specified type with the contents of the named file (which can be outside of the work tree), and optionally writes the resulting object into the object database. Reports its object ID to its standard output. This is used by "git\-cvsimport" to update the index without modifying files in the work tree. When <type> is not specified, it defaults to "blob".
+.sp
.SH "OPTIONS"
-
.TP
\-t <type>
-Specify the type (default: "blob")\&.
-
+Specify the type (default: "blob").
.TP
\-w
-Actually write the object into the object database\&.
-
+Actually write the object into the object database.
.TP
\-\-stdin
-Read the object from standard input instead of from a file\&.
-
+Read the object from standard input instead of from a file.
.SH "AUTHOR"
-
-
-Written by Junio C Hamano <junkio@cox\&.net>
-
+Written by Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-HTTP-FETCH" 1 "" "" ""
-.SH NAME
-git-http-fetch \- downloads a remote git repository via HTTP
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-http\-fetch \- downloads a remote git repository via HTTP
.SH "SYNOPSIS"
-
-
\fIgit\-http\-fetch\fR [\-c] [\-t] [\-a] [\-d] [\-v] [\-w filename] [\-\-recover] [\-\-stdin] <commit> <url>
-
+.sp
.SH "DESCRIPTION"
-
-
-Downloads a remote git repository via HTTP\&.
-
+Downloads a remote git repository via HTTP.
+.sp
.SH "OPTIONS"
-
.TP
commit\-id
-Either the hash or the filename under [URL]/refs/ to pull\&.
-
+Either the hash or the filename under [URL]/refs/ to pull.
.TP
\-c
-Get the commit objects\&.
-
+Get the commit objects.
.TP
\-t
-Get trees associated with the commit objects\&.
-
+Get trees associated with the commit objects.
.TP
\-a
-Get all the objects\&.
-
+Get all the objects.
.TP
\-v
-Report what is downloaded\&.
-
+Report what is downloaded.
.TP
\-w <filename>
-Writes the commit\-id into the filename under $GIT_DIR/refs/<filename> on the local end after the transfer is complete\&.
-
+Writes the commit\-id into the filename under $GIT_DIR/refs/<filename> on the local end after the transfer is complete.
.TP
\-\-stdin
-Instead of a commit id on the commandline (which is not expected in this case), \fIgit\-http\-fetch\fR expects lines on stdin in the format
-
+Instead of a commit id on the commandline (which is not expected in this case),
+\fIgit\-http\-fetch\fR
+expects lines on stdin in the format
+.sp
.nf
<commit\-id>['\\t'<filename\-as\-in\-\-w>]
.fi
-
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+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>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-HTTP-PUSH" 1 "" "" ""
-.SH NAME
-git-http-push \- Push missing objects using HTTP/DAV
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-http\-push \- Push missing objects using HTTP/DAV
.SH "SYNOPSIS"
-
-
-\fIgit\-http\-push\fR [\-\-complete] [\-\-force] [\-\-verbose] <url> <ref> [<ref>...]
-
+\fIgit\-http\-push\fR [\-\-complete] [\-\-force] [\-\-verbose] <url> <ref> [<ref>\&...]
+.sp
.SH "DESCRIPTION"
-
-
-Sends missing objects to remote repository, and updates the remote branch\&.
-
+Sends missing objects to remote repository, and updates the remote branch.
+.sp
.SH "OPTIONS"
-
.TP
\-\-complete
-Do not assume that the remote repository is complete in its current state, and verify all objects in the entire local ref's history exist in the remote repository\&.
-
+Do not assume that the remote repository is complete in its current state, and verify all objects in the entire local ref's history exist in the remote repository.
.TP
\-\-force
-Usually, the command refuses to update a remote ref that is not an ancestor of the local ref used to overwrite it\&. This flag disables the check\&. What this means is that the remote repository can lose commits; use it with care\&.
-
+Usually, the command refuses to update a remote ref that is not an ancestor of the local ref used to overwrite it. This flag disables the check. What this means is that the remote repository can lose commits; use it with care.
.TP
\-\-verbose
-Report the list of objects being walked locally and the list of objects successfully sent to the remote repository\&.
-
-
-<ref>...: The remote refs to update\&.
-
+Report the list of objects being walked locally and the list of objects successfully sent to the remote repository.
+<ref>\&...: The remote refs to update.
+.sp
.SH "SPECIFYING THE REFS"
-
-
-A \fI<ref>\fR specification can be either a single pattern, or a pair of such patterns separated by a colon ":" (this means that a ref name cannot have a colon in it)\&. A single pattern \fI<name>\fR is just a shorthand for \fI<name>:<name>\fR\&.
-
-
-Each pattern pair consists of the source side (before the colon) and the destination side (after the colon)\&. The ref to be pushed is determined by finding a match that matches the source side, and where it is pushed is determined by using the destination side\&.
-
+A \fI<ref>\fR specification can be either a single pattern, or a pair of such patterns separated by a colon ":" (this means that a ref name cannot have a colon in it). A single pattern \fI<name>\fR is just a shorthand for \fI<name>:<name>\fR.
+.sp
+Each pattern pair consists of the source side (before the colon) and the destination side (after the colon). The ref to be pushed is determined by finding a match that matches the source side, and where it is pushed is determined by using the destination side.
+.sp
.TP 3
\(bu
-It is an error if <src> does not match exactly one of the local refs\&.
+It is an error if <src> does not match exactly one of the local refs.
.TP
\(bu
If <dst> does not match any remote ref, either
-
.RS
.TP 3
\(bu
-it has to start with "refs/"; <dst> is used as the destination literally in this case\&.
+it has to start with "refs/"; <dst> is used as the destination literally in this case.
.TP
\(bu
-<src> == <dst> and the ref that matched the <src> must not exist in the set of remote refs; the ref matched <src> locally is used as the name of the destination\&.
-.LP
+<src> == <dst> and the ref that matched the <src> must not exist in the set of remote refs; the ref matched <src> locally is used as the name of the destination.
.RE
-.IP
-.LP
-
-
-Without \fI\-\-force\fR, the <src> ref is stored at the remote only if <dst> does not exist, or <dst> is a proper subset (i\&.e\&. an ancestor) of <src>\&. This check, known as "fast forward check", is performed in order to avoid accidentally overwriting the remote ref and lose other peoples' commits from there\&.
-
-
-With \fI\-\-force\fR, the fast forward check is disabled for all refs\&.
-
-
-Optionally, a <ref> parameter can be prefixed with a plus \fI+\fR sign to disable the fast\-forward check only on that ref\&.
-
+Without \fI\-\-force\fR, the <src> ref is stored at the remote only if <dst> does not exist, or <dst> is a proper subset (i.e. an ancestor) of <src>. This check, known as "fast forward check", is performed in order to avoid accidentally overwriting the remote ref and lose other peoples' commits from there.
+.sp
+With \fI\-\-force\fR, the fast forward check is disabled for all refs.
+.sp
+Optionally, a <ref> parameter can be prefixed with a plus \fI+\fR sign to disable the fast\-forward check only on that ref.
+.sp
.SH "AUTHOR"
-
-
-Written by Nick Hengeveld <nickh@reactrix\&.com>
-
+Written by Nick Hengeveld <nickh@reactrix.com>
+.sp
.SH "DOCUMENTATION"
-
-
Documentation by Nick Hengeveld
-
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-IMAP-SEND" 1 "" "" ""
-.SH NAME
-git-imap-send \- Dump a mailbox from stdin into an imap folder
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+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\&.
-
-
+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"
+ Folder = "INBOX.Drafts"
[imap]
- Tunnel = "ssh \-q user@server\&.com /usr/bin/imapd \&./Maildir 2> /dev/null"
+ Tunnel = "ssh \-q user@server.com /usr/bin/imapd ./Maildir 2> /dev/null"
[imap]
- Host = imap\&.server\&.com
+ Host = imap.server.com
User = bob
Pass = pwd
Port = 143
.fi
-
.SH "BUGS"
-
-
-Doesn't handle lines starting with "From " in the message body\&.
-
+Doesn't handle lines starting with "From " in the message body.
+.sp
.SH "AUTHOR"
-
-
-Derived from isync 1\&.0\&.1 by Mike McCormack\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-INDEX-PACK" 1 "" "" ""
-.SH NAME
-git-index-pack \- Build pack index file for an existing packed archive
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-index\-pack \- Build pack index file for an existing packed archive
.SH "SYNOPSIS"
-
-
\fIgit\-index\-pack\fR [\-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\&.
-
+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
\-o <index\-file>
-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)\&.
-
+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).
.SH "AUTHOR"
-
-
-Written by Sergey Vlasov <vsu@altlinux\&.ru>
-
+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" "09/21/2006" "" ""
+.TH "GIT\-INIT\-DB" "1" "10/03/2006" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-INSTAWEB" 1 "" "" ""
-.SH NAME
-git-instaweb \- instantly browse your working repository in gitweb
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-instaweb \- instantly browse your working repository in gitweb
.SH "SYNOPSIS"
-
-
\fIgit\-instaweb\fR [\-\-local] [\-\-httpd=<httpd>] [\-\-port=<port>] [\-\-browser=<browser>]
-
-
+.sp
\fIgit\-instaweb\fR [\-\-start] [\-\-stop] [\-\-restart]
-
+.sp
.SH "DESCRIPTION"
-
-
-A simple script to setup gitweb and a web server for browsing the local repository\&.
-
+A simple script to setup gitweb and a web server for browsing the local repository.
+.sp
.SH "OPTIONS"
-
.TP
\-l|\-\-local
-Only bind the web server to the local IP (127\&.0\&.0\&.1)\&.
-
+Only bind the web server to the local IP (127.0.0.1).
.TP
\-d|\-\-httpd
-The HTTP daemon command\-line that will be executed\&. Command\-line options may be specified here, and the configuration file will be added at the end of the command\-line\&. Currently, lighttpd and apache2 are the only supported servers\&. (Default: lighttpd)
-
+The HTTP daemon command\-line that will be executed. Command\-line options may be specified here, and the configuration file will be added at the end of the command\-line. Currently, lighttpd and apache2 are the only supported servers. (Default: lighttpd)
.TP
\-m|\-\-module\-path
-The module path (only needed if httpd is Apache)\&. (Default: /usr/lib/apache2/modules)
-
+The module path (only needed if httpd is Apache). (Default: /usr/lib/apache2/modules)
.TP
\-p|\-\-port
-The port number to bind the httpd to\&. (Default: 1234)
-
+The port number to bind the httpd to. (Default: 1234)
.TP
\-b|\-\-browser
-The web browser command\-line to execute to view the gitweb page\&. If blank, the URL of the gitweb instance will be printed to stdout\&. (Default: \fIfirefox\fR)
-
+The web browser command\-line to execute to view the gitweb page. If blank, the URL of the gitweb instance will be printed to stdout. (Default:
+\fIfirefox\fR)
.TP
\-\-start
-Start the httpd instance and exit\&. This does not generate any of the configuration files for spawning a new instance\&.
-
+Start the httpd instance and exit. This does not generate any of the configuration files for spawning a new instance.
.TP
\-\-stop
-Stop the httpd instance and exit\&. This does not generate any of the configuration files for spawning a new instance, nor does it close the browser\&.
-
+Stop the httpd instance and exit. This does not generate any of the configuration files for spawning a new instance, nor does it close the browser.
.TP
\-\-restart
-Restart the httpd instance and exit\&. This does not generate any of the configuration files for spawning a new instance\&.
-
+Restart the httpd instance and exit. This does not generate any of the configuration files for spawning a new instance.
.SH "CONFIGURATION"
-
-
-You may specify configuration in your \&.git/config
-
+You may specify configuration in your .git/config
+.sp
+.sp
.nf
[instaweb]
local = true
port = 4321
browser = konqueror
modulepath = /usr/lib/apache2/modules
-
.fi
-
.SH "AUTHOR"
-
-
-Written by Eric Wong <normalperson@yhbt\&.net>
-
+Written by Eric Wong <normalperson@yhbt.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Eric Wong <normalperson@yhbt\&.net>\&.
-
+Documentation by Eric Wong <normalperson@yhbt.net>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-LOCAL-FETCH" 1 "" "" ""
-.SH NAME
-git-local-fetch \- Duplicates another git repository on a local system
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-local\-fetch \- Duplicates another git repository on a local system
.SH "SYNOPSIS"
-
-
\fIgit\-local\-fetch\fR [\-c] [\-t] [\-a] [\-d] [\-v] [\-w filename] [\-\-recover] [\-l] [\-s] [\-n] commit\-id path
-
+.sp
.SH "DESCRIPTION"
-
-
-Duplicates another git repository on a local system\&.
-
+Duplicates another git repository on a local system.
+.sp
.SH "OPTIONS"
-
.TP
\-c
-Get the commit objects\&.
-
+Get the commit objects.
.TP
\-t
-Get trees associated with the commit objects\&.
-
+Get trees associated with the commit objects.
.TP
\-a
-Get all the objects\&.
-
+Get all the objects.
.TP
\-v
-Report what is downloaded\&.
-
+Report what is downloaded.
.TP
\-w <filename>
-Writes the commit\-id into the filename under $GIT_DIR/refs/<filename> on the local end after the transfer is complete\&.
-
+Writes the commit\-id into the filename under $GIT_DIR/refs/<filename> on the local end after the transfer is complete.
.TP
\-\-stdin
-Instead of a commit id on the commandline (which is not expected in this case), \fIgit\-local\-fetch\fR expects lines on stdin in the format
-
+Instead of a commit id on the commandline (which is not expected in this case),
+\fIgit\-local\-fetch\fR
+expects lines on stdin in the format
+.sp
.nf
<commit\-id>['\\t'<filename\-as\-in\-\-w>]
.fi
-
.SH "AUTHOR"
-
-
-Written by Junio C Hamano <junkio@cox\&.net>
-
+Written by Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-LOG" 1 "" "" ""
-.SH NAME
-git-log \- Show commit logs
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-log \- Show commit logs
.SH "SYNOPSIS"
-
-
-\fIgit\-log\fR <option>...
-
+\fIgit\-log\fR <option>\&...
+.sp
.SH "DESCRIPTION"
-
-
-Shows the commit logs\&.
-
-
-The command takes options applicable to the \fBgit\-rev\-list\fR(1) command to control what is shown and how, and options applicable to the \fBgit\-diff\-tree\fR(1) commands to control how the change each commit introduces are shown\&.
-
-
-This manual page describes only the most frequently used options\&.
-
+Shows the commit logs.
+.sp
+The command takes options applicable to the \fBgit\-rev\-list\fR(1) command to control what is shown and how, and options applicable to the \fBgit\-diff\-tree\fR(1) commands to control how the change each commit introduces are shown.
+.sp
+This manual page describes only the most frequently used options.
+.sp
.SH "OPTIONS"
-
.TP
\-\-pretty=<format>
-Controls the way the commit log is formatted\&.
-
+Controls the way the commit log is formatted.
.TP
\-\-max\-count=<n>
-Limits the number of commits to show\&.
-
+Limits the number of commits to show.
.TP
-<since>\&.\&.<until>
-Show only commits between the named two commits\&.
-
+<since>..<until>
+Show only commits between the named two commits.
.TP
\-p
-Show the change the commit introduces in a patch form\&.
-
+Show the change the commit introduces in a patch form.
.TP
-<paths>...
-Show only commits that affect the specified paths\&.
-
+<paths>\&...
+Show only commits that affect the specified paths.
.SH "EXAMPLES"
-
.TP
git log \-\-no\-merges
Show the whole commit history, but skip any merges
-
.TP
-git log v2\&.6\&.12\&.\&. include/scsi drivers/scsi
-Show all commits since version \fIv2\&.6\&.12\fR that changed any file in the include/scsi or drivers/scsi subdirectories
-
+git log v2.6.12.. include/scsi drivers/scsi
+Show all commits since version
+\fIv2.6.12\fR
+that changed any file in the include/scsi or drivers/scsi subdirectories
.TP
git log \-\-since="2 weeks ago" \-\- gitk
-Show the changes during the last two weeks to the file \fIgitk\fR\&. The "\-\-" is necessary to avoid confusion with the \fIbranch\fR named \fIgitk\fR
-
+Show the changes during the last two weeks to the file
+\fIgitk\fR. The "\-\-" is necessary to avoid confusion with the
+\fBbranch\fR
+named
+\fIgitk\fR
.TP
-git log \-r \-\-name\-status release\&.\&.test
-Show the commits that are in the "test" branch but not yet in the "release" branch, along with the list of paths each commit modifies\&.
-
+git log \-r \-\-name\-status release..test
+Show the commits that are in the "test" branch but not yet in the "release" branch, along with the list of paths each commit modifies.
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+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>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-LOST-FOUND" 1 "" "" ""
-.SH NAME
-git-lost-found \- Recover lost refs that luckily have not yet been pruned
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+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\&.
-
+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\&.
-
+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\&.
-
+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
-\&.\&.\&.
+[1ef2b196d909eed523d4f3c9bf54b78cdd6843c6] GIT 0.99.9c
+...
.fi
-
-
-Also you can use gitk to browse how they relate to each other and existing (probably old) tags\&.
-
+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 ??*)
+$ 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\&.
-
+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
$ git cat\-file tag 1ef2b196
object fa41bbce8e38c67a218415de6cfa510c7e50032a
type commit
-tag v0\&.99\&.9c
-tagger Junio C Hamano <junkio@cox\&.net> 1131059594 \-0800
+tag v0.99.9c
+tagger Junio C Hamano <junkio@cox.net> 1131059594 \-0800
-GIT 0\&.99\&.9c
+GIT 0.99.9c
This contains the following changes from the "master" branch, since
-\&.\&.\&.
+...
$ git update\-ref refs/tags/not\-lost\-anymore 1ef2b196
$ git rev\-parse not\-lost\-anymore
1ef2b196d909eed523d4f3c9bf54b78cdd6843c6
.fi
-
.SH "AUTHOR"
-
-
-Written by Junio C Hamano 濱野 純 <junkio@cox\&.net>
-
+Written by Junio C Hamano 濱野 純 <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-LS-FILES" 1 "" "" ""
-.SH NAME
-git-ls-files \- Information about files in the index/working directory
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-ls\-files \- Information about files in the index/working directory
.SH "SYNOPSIS"
-
+.sp
.nf
\fIgit\-ls\-files\fR [\-z] [\-t] [\-v]
(\-\-[cached|deleted|others|ignored|stage|unmerged|killed|modified])*
[\-\-error\-unmatch]
[\-\-full\-name] [\-\-abbrev] [\-\-] [<file>]*
.fi
-
.SH "DESCRIPTION"
-
-
-This merges the file listing in the directory cache index with the actual working directory list, and shows different combinations of the two\&.
-
-
+This merges the file listing in the directory cache index with the actual working directory list, and shows different combinations of the two.
+.sp
One or more of the options below may be used to determine the files shown:
-
+.sp
.SH "OPTIONS"
-
.TP
\-c|\-\-cached
Show cached files in the output (default)
-
.TP
\-d|\-\-deleted
Show deleted files in the output
-
.TP
\-m|\-\-modified
Show modified files in the output
-
.TP
\-o|\-\-others
Show other files in the output
-
.TP
\-i|\-\-ignored
-Show ignored files in the output Note the this also reverses any exclude list present\&.
-
+Show ignored files in the output Note the this also reverses any exclude list present.
.TP
\-s|\-\-stage
Show stage files in the output
-
.TP
\-\-directory
-If a whole directory is classified as "other", show just its name (with a trailing slash) and not its whole contents\&.
-
+If a whole directory is classified as "other", show just its name (with a trailing slash) and not its whole contents.
.TP
\-\-no\-empty\-directory
-Do not list empty directories\&. Has no effect without \-\-directory\&.
-
+Do not list empty directories. Has no effect without \-\-directory.
.TP
\-u|\-\-unmerged
Show unmerged files in the output (forces \-\-stage)
-
.TP
\-k|\-\-killed
-Show files on the filesystem that need to be removed due to file/directory conflicts for checkout\-index to succeed\&.
-
+Show files on the filesystem that need to be removed due to file/directory conflicts for checkout\-index to succeed.
.TP
\-z
-\\0 line termination on output\&.
-
+\\0 line termination on output.
.TP
\-x|\-\-exclude=<pattern>
-Skips files matching pattern\&. Note that pattern is a shell wildcard pattern\&.
-
+Skips files matching pattern. Note that pattern is a shell wildcard pattern.
.TP
\-X|\-\-exclude\-from=<file>
-exclude patterns are read from <file>; 1 per line\&.
-
+exclude patterns are read from <file>; 1 per line.
.TP
\-\-exclude\-per\-directory=<file>
-read additional exclude patterns that apply only to the directory and its subdirectories in <file>\&.
-
+read additional exclude patterns that apply only to the directory and its subdirectories in <file>.
.TP
\-\-error\-unmatch
-If any <file> does not appear in the index, treat this as an error (return 1)\&.
-
+If any <file> does not appear in the index, treat this as an error (return 1).
.TP
\-t
Identify the file status with the following tags (followed by a space) at the start of each line:
?
other
-
-
.TP
\-v
-Similar to \-t, but use lowercase letters for files that are marked as \fIalways matching index\fR\&.
-
+Similar to
+\-t, but use lowercase letters for files that are marked as
+\fIalways matching index\fR.
.TP
\-\-full\-name
-When run from a subdirectory, the command usually outputs paths relative to the current directory\&. This option forces paths to be output relative to the project top directory\&.
-
+When run from a subdirectory, the command usually outputs paths relative to the current directory. This option forces paths to be output relative to the project top directory.
.TP
\-\-abbrev[=<n>]
-Instead of showing the full 40\-byte hexadecimal object lines, show only handful hexdigits prefix\&. Non default number of digits can be specified with \-\-abbrev=<n>\&.
-
+Instead of showing the full 40\-byte hexadecimal object lines, show only handful hexdigits prefix. Non default number of digits can be specified with \-\-abbrev=<n>.
.TP
\-\-
-Do not interpret any more arguments as options\&.
-
+Do not interpret any more arguments as options.
.TP
<file>
-Files to show\&. If no files are given all files which match the other specified criteria are shown\&.
-
+Files to show. If no files are given all files which match the other specified criteria are shown.
.SH "OUTPUT"
-
-
show files just outputs the filename unless \fI\-\-stage\fR is specified in which case it outputs:
-
+.sp
+.sp
.nf
[<tag> ]<mode> <object> <stage> <file>
.fi
-
-
-"git\-ls\-files \-\-unmerged" and "git\-ls\-files \-\-stage" can be used to examine detailed information on unmerged paths\&.
-
-
-For an unmerged path, instead of recording a single mode/SHA1 pair, the dircache records up to three such pairs; one from tree O in stage 1, A in stage 2, and B in stage 3\&. This information can be used by the user (or the porcelain) to see what should eventually be recorded at the path\&. (see git\-read\-tree for more information on state)
-
-
-When \-z option is not used, TAB, LF, and backslash characters in pathnames are represented as \\t, \\n, and \\\\, respectively\&.
-
+"git\-ls\-files \-\-unmerged" and "git\-ls\-files \-\-stage" can be used to examine detailed information on unmerged paths.
+.sp
+For an unmerged path, instead of recording a single mode/SHA1 pair, the dircache records up to three such pairs; one from tree O in stage 1, A in stage 2, and B in stage 3. This information can be used by the user (or the porcelain) to see what should eventually be recorded at the path. (see git\-read\-tree for more information on state)
+.sp
+When \-z option is not used, TAB, LF, and backslash characters in pathnames are represented as \\t, \\n, and \\\\, respectively.
+.sp
.SH "EXCLUDE PATTERNS"
-
-
-\fIgit\-ls\-files\fR can use a list of "exclude patterns" when traversing the directory tree and finding files to show when the flags \-\-others or \-\-ignored are specified\&.
-
-
+\fIgit\-ls\-files\fR can use a list of "exclude patterns" when traversing the directory tree and finding files to show when the flags \-\-others or \-\-ignored are specified.
+.sp
These exclude patterns come from these places:
-
+.sp
.TP 3
1.
-command line flag \-\-exclude=<pattern> specifies a single pattern\&.
+command line flag \-\-exclude=<pattern> specifies a single pattern.
.TP
2.
-command line flag \-\-exclude\-from=<file> specifies a list of patterns stored in a file\&.
+command line flag \-\-exclude\-from=<file> specifies a list of patterns stored in a file.
.TP
3.
-command line flag \-\-exclude\-per\-directory=<name> specifies a name of the file in each directory \fIgit\-ls\-files\fR examines, and if exists, its contents are used as an additional list of patterns\&.
-.LP
-
-
-An exclude pattern file used by (2) and (3) contains one pattern per line\&. A line that starts with a \fI#\fR can be used as comment for readability\&.
-
-
-There are three lists of patterns that are in effect at a given time\&. They are built and ordered in the following way:
-
+command line flag \-\-exclude\-per\-directory=<name> specifies a name of the file in each directory
+\fIgit\-ls\-files\fR
+examines, and if exists, its contents are used as an additional list of patterns.
+An exclude pattern file used by (2) and (3) contains one pattern per line. A line that starts with a \fI#\fR can be used as comment for readability.
+.sp
+There are three lists of patterns that are in effect at a given time. They are built and ordered in the following way:
+.sp
.TP 3
\(bu
-\-\-exclude=<pattern> from the command line; patterns are ordered in the same order as they appear on the command line\&.
+\-\-exclude=<pattern> from the command line; patterns are ordered in the same order as they appear on the command line.
.TP
\(bu
-lines read from \-\-exclude\-from=<file>; patterns are ordered in the same order as they appear in the file\&.
+lines read from \-\-exclude\-from=<file>; patterns are ordered in the same order as they appear in the file.
.TP
\(bu
-When \-\-exclude\-per\-directory=<name> is specified, upon entering a directory that has such a file, its contents are appended at the end of the current "list of patterns"\&. They are popped off when leaving the directory\&.
-.LP
-
-
-Each pattern in the pattern list specifies "a match pattern" and optionally the fate; either a file that matches the pattern is considered excluded or included\&. A filename is matched against the patterns in the three lists; the \-\-exclude\-from list is checked first, then the \-\-exclude\-per\-directory list, and then finally the \-\-exclude list\&. The last match determines its fate\&. If there is no match in the three lists, the fate is "included"\&.
-
-
-A pattern specified on the command line with \-\-exclude or read from the file specified with \-\-exclude\-from is relative to the top of the directory tree\&. A pattern read from a file specified by \-\-exclude\-per\-directory is relative to the directory that the pattern file appears in\&.
-
-
+When \-\-exclude\-per\-directory=<name> is specified, upon entering a directory that has such a file, its contents are appended at the end of the current "list of patterns". They are popped off when leaving the directory.
+Each pattern in the pattern list specifies "a match pattern" and optionally the fate; either a file that matches the pattern is considered excluded or included. A filename is matched against the patterns in the three lists; the \-\-exclude\-from list is checked first, then the \-\-exclude\-per\-directory list, and then finally the \-\-exclude list. The last match determines its fate. If there is no match in the three lists, the fate is "included".
+.sp
+A pattern specified on the command line with \-\-exclude or read from the file specified with \-\-exclude\-from is relative to the top of the directory tree. A pattern read from a file specified by \-\-exclude\-per\-directory is relative to the directory that the pattern file appears in.
+.sp
An exclude pattern is of the following format:
-
+.sp
.TP 3
\(bu
-an optional prefix \fI!\fR which means that the fate this pattern specifies is "include", not the usual "exclude"; the remainder of the pattern string is interpreted according to the following rules\&.
+an optional prefix
+\fI!\fR
+which means that the fate this pattern specifies is "include", not the usual "exclude"; the remainder of the pattern string is interpreted according to the following rules.
.TP
\(bu
-if it does not contain a slash \fI/\fR, it is a shell glob pattern and used to match against the filename without leading directories\&.
+if it does not contain a slash
+\fI/\fR, it is a shell glob pattern and used to match against the filename without leading directories.
.TP
\(bu
-otherwise, it is a shell glob pattern, suitable for consumption by fnmatch(3) with FNM_PATHNAME flag\&. I\&.e\&. a slash in the pattern must match a slash in the pathname\&. "Documentation/*\&.html" matches "Documentation/git\&.html" but not "ppc/ppc\&.html"\&. As a natural exception, "/*\&.c" matches "cat\-file\&.c" but not "mozilla\-sha1/sha1\&.c"\&.
-.LP
-
-
+otherwise, it is a shell glob pattern, suitable for consumption by fnmatch(3) with FNM_PATHNAME flag. I.e. a slash in the pattern must match a slash in the pathname. "Documentation/*.html" matches "Documentation/git.html" but not "ppc/ppc.html". As a natural exception, "/*.c" matches "cat\-file.c" but not "mozilla\-sha1/sha1.c".
An example:
-
+.sp
+.sp
.nf
- $ cat \&.git/info/exclude
- # ignore objects and archives, anywhere in the tree\&.
- *\&.[oa]
- $ cat Documentation/\&.gitignore
+ $ cat .git/info/exclude
+ # ignore objects and archives, anywhere in the tree.
+ *.[oa]
+ $ cat Documentation/.gitignore
# ignore generated html files,
- *\&.html
- # except foo\&.html which is maintained by hand
- !foo\&.html
+ *.html
+ # except foo.html which is maintained by hand
+ !foo.html
$ git\-ls\-files \-\-ignored \\
- \-\-exclude='Documentation/*\&.[0\-9]' \\
- \-\-exclude\-from=\&.git/info/exclude \\
- \-\-exclude\-per\-directory=\&.gitignore
+ \-\-exclude='Documentation/*.[0\-9]' \\
+ \-\-exclude\-from=.git/info/exclude \\
+ \-\-exclude\-per\-directory=.gitignore
.fi
-
-
Another example:
-
+.sp
+.sp
.nf
- $ cat \&.gitignore
+ $ cat .gitignore
vmlinux*
$ ls arch/foo/kernel/vm*
- arch/foo/kernel/vmlinux\&.lds\&.S
- $ echo '!/vmlinux*' >arch/foo/kernel/\&.gitignore
+ arch/foo/kernel/vmlinux.lds.S
+ $ echo '!/vmlinux*' >arch/foo/kernel/.gitignore
.fi
-
-
-The second \&.gitignore keeps arch/foo/kernel/vmlinux\&.lds\&.S file from getting ignored\&.
-
+The second .gitignore keeps arch/foo/kernel/vmlinux.lds.S file from getting ignored.
+.sp
.SH "SEE ALSO"
-
-
\fBgit\-read\-tree\fR(1)
-
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+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>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-LS-REMOTE" 1 "" "" ""
-.SH NAME
-git-ls-remote \- List references in a remote repository
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-ls\-remote \- List references in a remote repository
.SH "SYNOPSIS"
-
+.sp
.nf
\fIgit\-ls\-remote\fR [\-\-heads] [\-\-tags] [\-u <exec> | \-\-upload\-pack <exec>]
- <repository> <refs>...
+ <repository> <refs>\&...
.fi
-
.SH "DESCRIPTION"
-
-
-Displays references available in a remote repository along with the associated commit IDs\&.
-
+Displays references available in a remote repository along with the associated commit IDs.
+.sp
.SH "OPTIONS"
-
.TP
\-h|\-\-heads, \-t|\-\-tags
-Limit to only refs/heads and refs/tags, respectively\&. These options are _not_ mutually exclusive; when given both, references stored in refs/heads and refs/tags are displayed\&.
-
+Limit to only refs/heads and refs/tags, respectively. These options are _not_ mutually exclusive; when given both, references stored in refs/heads and refs/tags are displayed.
.TP
\-u <exec>, \-\-upload\-pack=<exec>
-Specify the full path of \fBgit\-upload\-pack\fR(1) on the remote host\&. This allows listing references from repositories accessed via SSH and where the SSH deamon does not use the PATH configured by the user\&. Also see the \fI\-\-exec\fR option for \fBgit\-peek\-remote\fR(1)\&.
-
+Specify the full path of
+\fBgit\-upload\-pack\fR(1)
+on the remote host. This allows listing references from repositories accessed via SSH and where the SSH deamon does not use the PATH configured by the user. Also see the
+\fI\-\-exec\fR
+option for
+\fBgit\-peek\-remote\fR(1).
.TP
<repository>
-Location of the repository\&. The shorthand defined in $GIT_DIR/branches/ can be used\&. Use "\&." (dot) to list references in the local repository\&.
-
+Location of the repository. The shorthand defined in $GIT_DIR/branches/ can be used. Use "." (dot) to list references in the local repository.
.TP
-<refs>...
-When unspecified, all references, after filtering done with \-\-heads and \-\-tags, are shown\&. When <refs>... are specified, only references matching the given patterns are displayed\&.
-
+<refs>\&...
+When unspecified, all references, after filtering done with \-\-heads and \-\-tags, are shown. When <refs>\&... are specified, only references matching the given patterns are displayed.
.SH "EXAMPLES"
-
+.sp
.nf
-$ git ls\-remote \-\-tags \&./\&.
-d6602ec5194c87b0fc87103ca4d67251c76f233a refs/tags/v0\&.99
-f25a265a342aed6041ab0cc484224d9ca54b6f41 refs/tags/v0\&.99\&.1
-7ceca275d047c90c0c7d5afb13ab97efdf51bd6e refs/tags/v0\&.99\&.3
-c5db5456ae3b0873fc659c19fafdde22313cc441 refs/tags/v0\&.99\&.2
+$ git ls\-remote \-\-tags ./.
+d6602ec5194c87b0fc87103ca4d67251c76f233a refs/tags/v0.99
+f25a265a342aed6041ab0cc484224d9ca54b6f41 refs/tags/v0.99.1
+7ceca275d047c90c0c7d5afb13ab97efdf51bd6e refs/tags/v0.99.3
+c5db5456ae3b0873fc659c19fafdde22313cc441 refs/tags/v0.99.2
0918385dbd9656cab0d1d81ba7453d49bbc16250 refs/tags/junio\-gpg\-pub
-$ git ls\-remote http://www\&.kernel\&.org/pub/scm/git/git\&.git master pu rc
+$ git ls\-remote http://www.kernel.org/pub/scm/git/git.git master pu rc
5fe978a5381f1fbad26a80e682ddd2a401966740 refs/heads/master
c781a84b5204fb294c9ccc79f8b3baceeb32c061 refs/heads/pu
b1d096f2926c4e37c9c0b6a7bf2119bedaa277cb refs/heads/rc
-$ echo http://www\&.kernel\&.org/pub/scm/git/git\&.git >\&.git/branches/public
+$ echo http://www.kernel.org/pub/scm/git/git.git >.git/branches/public
$ git ls\-remote \-\-tags public v\\*
-d6602ec5194c87b0fc87103ca4d67251c76f233a refs/tags/v0\&.99
-f25a265a342aed6041ab0cc484224d9ca54b6f41 refs/tags/v0\&.99\&.1
-c5db5456ae3b0873fc659c19fafdde22313cc441 refs/tags/v0\&.99\&.2
-7ceca275d047c90c0c7d5afb13ab97efdf51bd6e refs/tags/v0\&.99\&.3
+d6602ec5194c87b0fc87103ca4d67251c76f233a refs/tags/v0.99
+f25a265a342aed6041ab0cc484224d9ca54b6f41 refs/tags/v0.99.1
+c5db5456ae3b0873fc659c19fafdde22313cc441 refs/tags/v0.99.2
+7ceca275d047c90c0c7d5afb13ab97efdf51bd6e refs/tags/v0.99.3
.fi
-
.SH "AUTHOR"
-
-
-Written by Junio C Hamano <junkio@cox\&.net>
-
+Written by Junio C Hamano <junkio@cox.net>
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-LS-TREE" 1 "" "" ""
-.SH NAME
-git-ls-tree \- Lists the contents of a tree object
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-ls\-tree \- Lists the contents of a tree object
.SH "SYNOPSIS"
-
+.sp
.nf
\fIgit\-ls\-tree\fR [\-d] [\-r] [\-t] [\-z]
[\-\-name\-only] [\-\-name\-status] [\-\-full\-name] [\-\-abbrev=[<n>]]
- <tree\-ish> [paths...]
+ <tree\-ish> [paths\&...]
.fi
-
.SH "DESCRIPTION"
-
-
-Lists the contents of a given tree object, like what "/bin/ls \-a" does in the current working directory\&. Note that the usage is subtly different, though \- \fIpaths\fR denote just a list of patterns to match, e\&.g\&. so specifying directory name (without \fI\-r\fR) will behave differently, and order of the arguments does not matter\&.
-
+Lists the contents of a given tree object, like what "/bin/ls \-a" does in the current working directory. Note that the usage is subtly different, though \- \fIpaths\fR denote just a list of patterns to match, e.g. so specifying directory name (without \fI\-r\fR) will behave differently, and order of the arguments does not matter.
+.sp
.SH "OPTIONS"
-
.TP
<tree\-ish>
-Id of a tree\-ish\&.
-
+Id of a tree\-ish.
.TP
\-d
-Show only the named tree entry itself, not its children\&.
-
+Show only the named tree entry itself, not its children.
.TP
\-r
-Recurse into sub\-trees\&.
-
+Recurse into sub\-trees.
.TP
\-t
-Show tree entries even when going to recurse them\&. Has no effect if \fI\-r\fR was not passed\&. \fI\-d\fR implies \fI\-t\fR\&.
-
+Show tree entries even when going to recurse them. Has no effect if
+\fI\-r\fR
+was not passed.
+\fI\-d\fR
+implies
+\fI\-t\fR.
.TP
\-z
-\\0 line termination on output\&.
-
+\\0 line termination on output.
.TP
-\-\-name\-only, \-\-name\-status
-List only filenames (instead of the "long" output), one per line\&.
-
+\-\-name\-only , \-\-name\-status
+List only filenames (instead of the "long" output), one per line.
.TP
\-\-abbrev[=<n>]
-Instead of showing the full 40\-byte hexadecimal object lines, show only handful hexdigits prefix\&. Non default number of digits can be specified with \-\-abbrev=<n>\&.
-
+Instead of showing the full 40\-byte hexadecimal object lines, show only handful hexdigits prefix. Non default number of digits can be specified with \-\-abbrev=<n>.
.TP
\-\-full\-name
-Instead of showing the path names relative to the current working directory, show the full path names\&.
-
+Instead of showing the path names relative to the current working directory, show the full path names.
.TP
paths
-When paths are given, show them (note that this isn't really raw pathnames, but rather a list of patterns to match)\&. Otherwise implicitly uses the root level of the tree as the sole path argument\&.
-
+When paths are given, show them (note that this isn't really raw pathnames, but rather a list of patterns to match). Otherwise implicitly uses the root level of the tree as the sole path argument.
.SH "OUTPUT FORMAT"
-
+.sp
.nf
<mode> SP <type> SP <object> TAB <file>
.fi
-
-
-When the \-z option is not used, TAB, LF, and backslash characters in pathnames are represented as \\t, \\n, and \\\\, respectively\&.
-
+When the \-z option is not used, TAB, LF, and backslash characters in pathnames are represented as \\t, \\n, and \\\\, respectively.
+.sp
.SH "AUTHOR"
-
-
-Written by Petr Baudis <pasky@suse\&.cz> Completely rewritten from scratch by Junio C Hamano <junkio@cox\&.net>, another major rewrite by Linus Torvalds <torvalds@osdl\&.org>
-
+Written by Petr Baudis <pasky@suse.cz> Completely rewritten from scratch by Junio C Hamano <junkio@cox.net>, another major rewrite by Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-MAILINFO" 1 "" "" ""
-.SH NAME
-git-mailinfo \- Extracts patch from a single e-mail message
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-mailinfo \- Extracts patch from a single e\-mail message
.SH "SYNOPSIS"
-
-
\fIgit\-mailinfo\fR [\-k] [\-u | \-\-encoding=<encoding>] <msg> <patch>
-
+.sp
.SH "DESCRIPTION"
-
-
-Reading a single e\-mail message from the standard input, and writes the commit log message in <msg> file, and the patches in <patch> file\&. The author name, e\-mail and e\-mail subject are written out to the standard output to be used by git\-applypatch to create a commit\&. It is usually not necessary to use this command directly\&.
-
+Reading a single e\-mail message from the standard input, and writes the commit log message in <msg> file, and the patches in <patch> file. The author name, e\-mail and e\-mail subject are written out to the standard output to be used by git\-applypatch to create a commit. It is usually not necessary to use this command directly.
+.sp
.SH "OPTIONS"
-
.TP
\-k
-Usually the program \fIcleans up\fR the Subject: header line to extract the title line for the commit log message, among which (1) remove \fIRe:\fR or \fIre:\fR, (2) leading whitespaces, (3) \fI[\fR up to \fI]\fR, typically \fI[PATCH]\fR, and then prepends "[PATCH] "\&. This flag forbids this munging, and is most useful when used to read back \fIgit format\-patch \-\-mbox\fR output\&.
-
+Usually the program
+\fIcleans up\fR
+the Subject: header line to extract the title line for the commit log message, among which (1) remove
+\fIRe:\fR
+or
+\fIre:\fR, (2) leading whitespaces, (3)
+\fI[\fR
+up to
+\fI]\fR, typically
+\fI[PATCH]\fR, and then prepends "[PATCH] ". This flag forbids this munging, and is most useful when used to read back
+\fIgit format\-patch \-\-mbox\fR
+output.
.TP
\-u
-By default, the commit log message, author name and author email are taken from the e\-mail without any charset conversion, after minimally decoding MIME transfer encoding\&. This flag causes the resulting commit to be encoded in the encoding specified by i18n\&.commitencoding configuration (defaults to utf\-8) by transliterating them\&. Note that the patch is always used as is without charset conversion, even with this flag\&.
-
+By default, the commit log message, author name and author email are taken from the e\-mail without any charset conversion, after minimally decoding MIME transfer encoding. This flag causes the resulting commit to be encoded in the encoding specified by i18n.commitencoding configuration (defaults to utf\-8) by transliterating them. Note that the patch is always used as is without charset conversion, even with this flag.
.TP
\-\-encoding=<encoding>
-Similar to \-u but if the local convention is different from what is specified by i18n\&.commitencoding, this flag can be used to override it\&.
-
+Similar to \-u but if the local convention is different from what is specified by i18n.commitencoding, this flag can be used to override it.
.TP
<msg>
-The commit log message extracted from e\-mail, usually except the title line which comes from e\-mail Subject\&.
-
+The commit log message extracted from e\-mail, usually except the title line which comes from e\-mail Subject.
.TP
<patch>
-The patch extracted from e\-mail\&.
-
+The patch extracted from e\-mail.
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org> and Junio C Hamano <junkio@cox\&.net>
-
+Written by Linus Torvalds <torvalds@osdl.org> and Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-MAILSPLIT" 1 "" "" ""
-.SH NAME
-git-mailsplit \- Totally braindamaged mbox splitter program
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-mailsplit \- Totally braindamaged mbox splitter program
.SH "SYNOPSIS"
-
-
-\fIgit\-mailsplit\fR [\-b] [\-f<nn>] [\-d<prec>] \-o<directory> [\-\-] [<mbox>...]
-
+\fIgit\-mailsplit\fR [\-b] [\-f<nn>] [\-d<prec>] \-o<directory> [\-\-] [<mbox>\&...]
+.sp
.SH "DESCRIPTION"
-
-
-Splits a mbox file into a list of files: "0001" "0002" \&.\&. in the specified directory so you can process them further from there\&.
-
+Splits a mbox file into a list of files: "0001" "0002" .. in the specified directory so you can process them further from there.
+.sp
.SH "OPTIONS"
-
.TP
<mbox>
-Mbox file to split\&. If not given, the mbox is read from the standard input\&.
-
+Mbox file to split. If not given, the mbox is read from the standard input.
.TP
<directory>
-Directory in which to place the individual messages\&.
-
+Directory in which to place the individual messages.
.TP
\-b
-If any file doesn't begin with a From line, assume it is a single mail message instead of signaling error\&.
-
+If any file doesn't begin with a From line, assume it is a single mail message instead of signaling error.
.TP
\-d<prec>
-Instead of the default 4 digits with leading zeros, different precision can be specified for the generated filenames\&.
-
+Instead of the default 4 digits with leading zeros, different precision can be specified for the generated filenames.
.TP
\-f<nn>
-Skip the first <nn> numbers, for example if \-f3 is specified, start the numbering with 0004\&.
-
+Skip the first <nn> numbers, for example if \-f3 is specified, start the numbering with 0004.
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org> and Junio C Hamano <junkio@cox\&.net>
-
+Written by Linus Torvalds <torvalds@osdl.org> and Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-MERGE-BASE" 1 "" "" ""
-.SH NAME
-git-merge-base \- Finds as good a common ancestor as possible for a merge
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-merge\-base \- Finds as good a common ancestor as possible for a merge
.SH "SYNOPSIS"
-
-
\fIgit\-merge\-base\fR [\-\-all] <commit> <commit>
-
+.sp
.SH "DESCRIPTION"
-
-
-"git\-merge\-base" finds as good a common ancestor as possible between the two commits\&. That is, given two commits A and B \fIgit\-merge\-base A B\fR will output a commit which is reachable from both A and B through the parent relationship\&.
-
-
-Given a selection of equally good common ancestors it should not be relied on to decide in any particular way\&.
-
-
-The "git\-merge\-base" algorithm is still in flux \- use the source...
-
+"git\-merge\-base" finds as good a common ancestor as possible between the two commits. That is, given two commits A and B \fIgit\-merge\-base A B\fR will output a commit which is reachable from both A and B through the parent relationship.
+.sp
+Given a selection of equally good common ancestors it should not be relied on to decide in any particular way.
+.sp
+The "git\-merge\-base" algorithm is still in flux \- use the source\&...
+.sp
.SH "OPTIONS"
-
.TP
\-\-all
-Output all common ancestors for the two commits instead of just one\&.
-
+Output all common ancestors for the two commits instead of just one.
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+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>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-MERGE-INDEX" 1 "" "" ""
-.SH NAME
-git-merge-index \- Runs a merge for files needing merging
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-merge\-index \- Runs a merge for files needing merging
.SH "SYNOPSIS"
-
-
\fIgit\-merge\-index\fR [\-o] [\-q] <merge\-program> (\-a | \-\- | <file>*)
-
+.sp
.SH "DESCRIPTION"
-
-
-This looks up the <file>(s) in the index and, if there are any merge entries, passes the SHA1 hash for those files as arguments 1, 2, 3 (empty argument if no file), and <file> as argument 4\&. File modes for the three files are passed as arguments 5, 6 and 7\&.
-
+This looks up the <file>(s) in the index and, if there are any merge entries, passes the SHA1 hash for those files as arguments 1, 2, 3 (empty argument if no file), and <file> as argument 4. File modes for the three files are passed as arguments 5, 6 and 7.
+.sp
.SH "OPTIONS"
-
.TP
\-\-
-Do not interpret any more arguments as options\&.
-
+Do not interpret any more arguments as options.
.TP
\-a
-Run merge against all files in the index that need merging\&.
-
+Run merge against all files in the index that need merging.
.TP
\-o
-Instead of stopping at the first failed merge, do all of them in one shot \- continue with merging even when previous merges returned errors, and only return the error code after all the merges are over\&.
-
+Instead of stopping at the first failed merge, do all of them in one shot \- continue with merging even when previous merges returned errors, and only return the error code after all the merges are over.
.TP
\-q
-Do not complain about failed merge program (the merge program failure usually indicates conflicts during merge)\&. This is for porcelains which might want to emit custom messages\&.
-
-
-If "git\-merge\-index" is called with multiple <file>s (or \-a) then it processes them in turn only stopping if merge returns a non\-zero exit code\&.
-
-
-Typically this is run with the a script calling the merge command from the RCS package\&.
-
-
-A sample script called "git\-merge\-one\-file" is included in the distribution\&.
-
-
-ALERT ALERT ALERT! The git "merge object order" is different from the RCS "merge" program merge object order\&. In the above ordering, the original is first\&. But the argument order to the 3\-way merge program "merge" is to have the original in the middle\&. Don't ask me why\&.
-
-
+Do not complain about failed merge program (the merge program failure usually indicates conflicts during merge). This is for porcelains which might want to emit custom messages.
+If "git\-merge\-index" is called with multiple <file>s (or \-a) then it processes them in turn only stopping if merge returns a non\-zero exit code.
+.sp
+Typically this is run with the a script calling the merge command from the RCS package.
+.sp
+A sample script called "git\-merge\-one\-file" is included in the distribution.
+.sp
+ALERT ALERT ALERT! The git "merge object order" is different from the RCS "merge" program merge object order. In the above ordering, the original is first. But the argument order to the 3\-way merge program "merge" is to have the original in the middle. Don't ask me why.
+.sp
Examples:
-
+.sp
+.sp
.nf
torvalds@ppc970:~/merge\-test> git\-merge\-index cat MM
-This is MM from the original tree\&. # original
-This is modified MM in the branch A\&. # merge1
-This is modified MM in the branch B\&. # merge2
-This is modified MM in the branch B\&. # current contents
+This is MM from the original tree. # original
+This is modified MM in the branch A. # merge1
+This is modified MM in the branch B. # merge2
+This is modified MM in the branch B. # current contents
.fi
-
-
or
-
+.sp
+.sp
.nf
torvalds@ppc970:~/merge\-test> git\-merge\-index cat AA MM
cat: : No such file or directory
-This is added AA in the branch A\&.
-This is added AA in the branch B\&.
-This is added AA in the branch B\&.
+This is added AA in the branch A.
+This is added AA in the branch B.
+This is added AA in the branch B.
fatal: merge program failed
.fi
-
-
-where the latter example shows how "git\-merge\-index" will stop trying to merge once anything has returned an error (i\&.e\&., "cat" returned an error for the AA file, because it didn't exist in the original, and thus "git\-merge\-index" didn't even try to merge the MM thing)\&.
-
+where the latter example shows how "git\-merge\-index" will stop trying to merge once anything has returned an error (i.e., "cat" returned an error for the AA file, because it didn't exist in the original, and thus "git\-merge\-index" didn't even try to merge the MM thing).
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org> One\-shot merge by Petr Baudis <pasky@ucw\&.cz>
-
+Written by Linus Torvalds <torvalds@osdl.org> One\-shot merge by Petr Baudis <pasky@ucw.cz>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-MERGE-ONE-FILE" 1 "" "" ""
-.SH NAME
-git-merge-one-file \- The standard helper program to use with "git-merge-index"
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-merge\-one\-file \- The standard helper program to use with "git\-merge\-index"
.SH "SYNOPSIS"
-
-
\fIgit\-merge\-one\-file\fR
-
+.sp
.SH "DESCRIPTION"
-
-
-This is the standard helper program to use with "git\-merge\-index" to resolve a merge after the trivial merge done with "git\-read\-tree \-m"\&.
-
+This is the standard helper program to use with "git\-merge\-index" to resolve a merge after the trivial merge done with "git\-read\-tree \-m".
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>, Junio C Hamano <junkio@cox\&.net> and Petr Baudis <pasky@suse\&.cz>\&.
-
+Written by Linus Torvalds <torvalds@osdl.org>, Junio C Hamano <junkio@cox.net> and Petr Baudis <pasky@suse.cz>.
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-MERGE-TREE" 1 "" "" ""
-.SH NAME
-git-merge-tree \- Show three-way merge without touching index
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+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\&.
-
-
-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\&.
-
+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>
-
+Written by Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-MERGE" 1 "" "" ""
-.SH NAME
-git-merge \- Grand Unified Merge Driver
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-merge \- Grand Unified Merge Driver
.SH "SYNOPSIS"
-
-
-\fIgit\-merge\fR [\-n] [\-\-no\-commit] [\-s <strategy>]... <msg> <head> <remote> <remote>...
-
+\fIgit\-merge\fR [\-n] [\-\-no\-commit] [\-s <strategy>]\&... <msg> <head> <remote> <remote>\&...
+.sp
.SH "DESCRIPTION"
-
-
-This is the top\-level user interface to the merge machinery which drives multiple merge strategy scripts\&.
-
+This is the top\-level user interface to the merge machinery which drives multiple merge strategy scripts.
+.sp
.SH "OPTIONS"
-
.TP
\-n, \-\-no\-summary
-Do not show diffstat at the end of the merge\&.
-
+Do not show diffstat at the end of the merge.
.TP
\-\-no\-commit
-Perform the merge but pretend the merge failed and do not autocommit, to give the user a chance to inspect and further tweak the merge result before committing\&.
-
+Perform the merge but pretend the merge failed and do not autocommit, to give the user a chance to inspect and further tweak the merge result before committing.
.TP
\-\-squash
-Produce the working tree and index state as if a real merge happened, but do not actually make a commit or move the HEAD, nor record $GIT_DIR/MERGE_HEAD to cause the next git commit command to create a merge commit\&. This allows you to create a single commit on top of the current branch whose effect is the same as merging another branch (or more in case of an octopus)\&.
-
+Produce the working tree and index state as if a real merge happened, but do not actually make a commit or move the
+HEAD, nor record
+$GIT_DIR/MERGE_HEAD
+to cause the next
+git commit
+command to create a merge commit. This allows you to create a single commit on top of the current branch whose effect is the same as merging another branch (or more in case of an octopus).
.TP
\-s <strategy>, \-\-strategy=<strategy>
-Use the given merge strategy; can be supplied more than once to specify them in the order they should be tried\&. If there is no \-s option, a built\-in list of strategies is used instead (git\-merge\-recursive when merging a single head, git\-merge\-octopus otherwise)\&.
-
+Use the given merge strategy; can be supplied more than once to specify them in the order they should be tried. If there is no
+\-s
+option, a built\-in list of strategies is used instead (git\-merge\-recursive
+when merging a single head,
+git\-merge\-octopus
+otherwise).
.TP
<msg>
-The commit message to be used for the merge commit (in case it is created)\&. The git\-fmt\-merge\-msg script can be used to give a good default for automated git\-merge invocations\&.
-
+The commit message to be used for the merge commit (in case it is created). The
+git\-fmt\-merge\-msg
+script can be used to give a good default for automated
+git\-merge
+invocations.
.TP
<head>
-our branch head commit\&.
-
+our branch head commit.
.TP
<remote>
-other branch head merged into our branch\&. You need at least one <remote>\&. Specifying more than one <remote> obviously means you are trying an Octopus\&.
-
+other branch head merged into our branch. You need at least one <remote>. Specifying more than one <remote> obviously means you are trying an Octopus.
.SH "MERGE STRATEGIES"
-
.TP
resolve
-This can only resolve two heads (i\&.e\&. the current branch and another branch you pulled from) using 3\-way merge algorithm\&. It tries to carefully detect criss\-cross merge ambiguities and is considered generally safe and fast\&.
-
+This can only resolve two heads (i.e. the current branch and another branch you pulled from) using 3\-way merge algorithm. It tries to carefully detect criss\-cross merge ambiguities and is considered generally safe and fast.
.TP
recursive
-This can only resolve two heads using 3\-way merge algorithm\&. When there are more than one common ancestors that can be used for 3\-way merge, it creates a merged tree of the common ancestors and uses that as the reference tree for the 3\-way merge\&. This has been reported to result in fewer merge conflicts without causing mis\-merges by tests done on actual merge commits taken from Linux 2\&.6 kernel development history\&. Additionally this can detect and handle merges involving renames\&. This is the default merge strategy when pulling or merging one branch\&.
-
+This can only resolve two heads using 3\-way merge algorithm. When there are more than one common ancestors that can be used for 3\-way merge, it creates a merged tree of the common ancestors and uses that as the reference tree for the 3\-way merge. This has been reported to result in fewer merge conflicts without causing mis\-merges by tests done on actual merge commits taken from Linux 2.6 kernel development history. Additionally this can detect and handle merges involving renames. This is the default merge strategy when pulling or merging one branch.
.TP
octopus
-This resolves more than two\-head case, but refuses to do complex merge that needs manual resolution\&. It is primarily meant to be used for bundling topic branch heads together\&. This is the default merge strategy when pulling or merging more than one branches\&.
-
+This resolves more than two\-head case, but refuses to do complex merge that needs manual resolution. It is primarily meant to be used for bundling topic branch heads together. This is the default merge strategy when pulling or merging more than one branches.
.TP
ours
-This resolves any number of heads, but the result of the merge is always the current branch head\&. It is meant to be used to supersede old development history of side branches\&.
-
-
-If you tried a merge which resulted in a complex conflicts and would want to start over, you can recover with \fBgit\-reset\fR(1)\&.
-
+This resolves any number of heads, but the result of the merge is always the current branch head. It is meant to be used to supersede old development history of side branches.
+If you tried a merge which resulted in a complex conflicts and would want to start over, you can recover with \fBgit\-reset\fR(1).
+.sp
.SH "HOW MERGE WORKS"
-
-
-A merge is always between the current HEAD and one or more remote branch heads, and the index file must exactly match the tree of HEAD commit (i\&.e\&. the contents of the last commit) when it happens\&. In other words, git\-diff \-\-cached HEAD must report no changes\&.
-
-.RS
-.Sh "Note"
-
-
-This is a bit of lie\&. In certain special cases, your index are allowed to be different from the tree of HEAD commit\&. The most notable case is when your HEAD commit is already ahead of what is being merged, in which case your index can have arbitrary difference from your HEAD commit\&. Otherwise, your index entries are allowed have differences from your HEAD commit that match the result of trivial merge (e\&.g\&. you received the same patch from external source to produce the same result as what you are merging)\&. For example, if a path did not exist in the common ancestor and your head commit but exists in the tree you are merging into your repository, and if you already happen to have that path exactly in your index, the merge does not have to fail\&.
-
-.RE
-
-
-Otherwise, merge will refuse to do any harm to your repository (that is, it may fetch the objects from remote, and it may even update the local branch used to keep track of the remote branch with git pull remote rbranch:lbranch, but your working tree, \&.git/HEAD pointer and index file are left intact)\&.
-
-
-You may have local modifications in the working tree files\&. In other words, git\-diff is allowed to report changes\&. However, the merge uses your working tree as the working area, and in order to prevent the merge operation from losing such changes, it makes sure that they do not interfere with the merge\&. Those complex tables in read\-tree documentation define what it means for a path to "interfere with the merge"\&. And if your local modifications interfere with the merge, again, it stops before touching anything\&.
-
-
-So in the above two "failed merge" case, you do not have to worry about loss of data \-\-\- you simply were not ready to do a merge, so no merge happened at all\&. You may want to finish whatever you were in the middle of doing, and retry the same pull after you are done and ready\&.
-
-
+A merge is always between the current HEAD and one or more remote branch heads, and the index file must exactly match the tree of HEAD commit (i.e. the contents of the last commit) when it happens. In other words, git\-diff \-\-cached HEAD must report no changes.
+.sp
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+\fBNote\fR
+This is a bit of lie. In certain special cases, your index are allowed to be different from the tree of HEAD commit. The most notable case is when your HEAD commit is already ahead of what is being merged, in which case your index can have arbitrary difference from your HEAD commit. Otherwise, your index entries are allowed have differences from your HEAD commit that match the result of trivial merge (e.g. you received the same patch from external source to produce the same result as what you are merging). For example, if a path did not exist in the common ancestor and your head commit but exists in the tree you are merging into your repository, and if you already happen to have that path exactly in your index, the merge does not have to fail.
+.sp
+Otherwise, merge will refuse to do any harm to your repository (that is, it may fetch the objects from remote, and it may even update the local branch used to keep track of the remote branch with git pull remote rbranch:lbranch, but your working tree, .git/HEAD pointer and index file are left intact).
+.sp
+You may have local modifications in the working tree files. In other words, git\-diff is allowed to report changes. However, the merge uses your working tree as the working area, and in order to prevent the merge operation from losing such changes, it makes sure that they do not interfere with the merge. Those complex tables in read\-tree documentation define what it means for a path to "interfere with the merge". And if your local modifications interfere with the merge, again, it stops before touching anything.
+.sp
+So in the above two "failed merge" case, you do not have to worry about loss of data \-\-\- you simply were not ready to do a merge, so no merge happened at all. You may want to finish whatever you were in the middle of doing, and retry the same pull after you are done and ready.
+.sp
When things cleanly merge, these things happen:
-
+.sp
.TP 3
1.
the results are updated both in the index file and in your working tree,
the tree gets committed, and
.TP
4.
-the HEAD pointer gets advanced\&.
-.LP
-
-
-Because of 2\&., we require that the original state of the index file to match exactly the current HEAD commit; otherwise we will write out your local changes already registered in your index file along with the merge result, which is not good\&. Because 1\&. involves only the paths different between your branch and the remote branch you are pulling from during the merge (which is typically a fraction of the whole tree), you can have local modifications in your working tree as long as they do not overlap with what the merge updates\&.
-
-
+the
+HEAD
+pointer gets advanced.
+Because of 2., we require that the original state of the index file to match exactly the current HEAD commit; otherwise we will write out your local changes already registered in your index file along with the merge result, which is not good. Because 1. involves only the paths different between your branch and the remote branch you are pulling from during the merge (which is typically a fraction of the whole tree), you can have local modifications in your working tree as long as they do not overlap with what the merge updates.
+.sp
When there are conflicts, these things happen:
-
+.sp
.TP 3
1.
- HEAD stays the same\&.
+HEAD
+stays the same.
.TP
2.
-Cleanly merged paths are updated both in the index file and in your working tree\&.
+Cleanly merged paths are updated both in the index file and in your working tree.
.TP
3.
-For conflicting paths, the index file records up to three versions; stage1 stores the version from the common ancestor, stage2 from HEAD, and stage3 from the remote branch (you can inspect the stages with git\-ls\-files \-u)\&. The working tree files have the result of "merge" program; i\&.e\&. 3\-way merge result with familiar conflict markers <<< === >>>\&.
+For conflicting paths, the index file records up to three versions; stage1 stores the version from the common ancestor, stage2 from
+HEAD, and stage3 from the remote branch (you can inspect the stages with
+git\-ls\-files \-u). The working tree files have the result of "merge" program; i.e. 3\-way merge result with familiar conflict markers
+<<< === >>>.
.TP
4.
-No other changes are done\&. In particular, the local modifications you had before you started merge will stay the same and the index entries for them stay as they were, i\&.e\&. matching HEAD\&.
-.LP
-
-
+No other changes are done. In particular, the local modifications you had before you started merge will stay the same and the index entries for them stay as they were, i.e. matching
+HEAD.
After seeing a conflict, you can do two things:
-
+.sp
.TP 3
\(bu
-Decide not to merge\&. The only clean\-up you need are to reset the index file to the HEAD commit to reverse 2\&. and to clean up working tree changes made by 2\&. and 3\&.; git\-reset can be used for this\&.
+Decide not to merge. The only clean\-up you need are to reset the index file to the
+HEAD
+commit to reverse 2. and to clean up working tree changes made by 2. and 3.;
+git\-reset
+can be used for this.
.TP
\(bu
-Resolve the conflicts\&. git\-diff would report only the conflicting paths because of the above 2\&. and 3\&.\&. Edit the working tree files into a desirable shape, git\-update\-index them, to make the index file contain what the merge result should be, and run git\-commit to commit the result\&.
-.LP
-
+Resolve the conflicts.
+git\-diff
+would report only the conflicting paths because of the above 2. and 3.. Edit the working tree files into a desirable shape,
+git\-update\-index
+them, to make the index file contain what the merge result should be, and run
+git\-commit
+to commit the result.
.SH "SEE ALSO"
-
-
\fBgit\-fmt\-merge\-msg\fR(1), \fBgit\-pull\fR(1)
-
+.sp
.SH "AUTHOR"
-
-
-Written by Junio C Hamano <junkio@cox\&.net>
-
+Written by Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-MKTAG" 1 "" "" ""
-.SH NAME
-git-mktag \- Creates a tag object
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+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\&.
-
-
-The output is the new tag's <object> identifier\&.
-
+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\&.
-
-
-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)
-
+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>
-
+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>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-MKTREE" 1 "" "" ""
-.SH NAME
-git-mktree \- Build a tree-object from ls-tree formatted text
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+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\&.
-
+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>
-
+Written by Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-MV" 1 "" "" ""
-.SH NAME
-git-mv \- Move or rename a file, directory or symlink
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-mv \- Move or rename a file, directory or symlink
.SH "SYNOPSIS"
-
-
-\fIgit\-mv\fR <options>... <args>...
-
+\fIgit\-mv\fR <options>\&... <args>\&...
+.sp
.SH "DESCRIPTION"
-
-
-This script is used to move or rename a file, directory or symlink\&.
-
+This script is used to move or rename a file, directory or symlink.
+.sp
+.sp
.nf
git\-mv [\-f] [\-n] <source> <destination>
-git\-mv [\-f] [\-n] [\-k] <source> \&.\&.\&. <destination directory>
+git\-mv [\-f] [\-n] [\-k] <source> ... <destination directory>
.fi
-
-
-In the first form, it renames <source>, which must exist and be either a file, symlink or directory, to <destination>\&. In the second form, the last argument has to be an existing directory; the given sources will be moved into this directory\&.
-
-
-The index is updated after successful completion, but the change must still be committed\&.
-
+In the first form, it renames <source>, which must exist and be either a file, symlink or directory, to <destination>. In the second form, the last argument has to be an existing directory; the given sources will be moved into this directory.
+.sp
+The index is updated after successful completion, but the change must still be committed.
+.sp
.SH "OPTIONS"
-
.TP
\-f
Force renaming or moving of a file even if the target exists
-
.TP
\-k
-Skip move or rename actions which would lead to an error condition\&. An error happens when a source is neither existing nor controlled by GIT, or when it would overwrite an existing file unless \fI\-f\fR is given\&.
-
+Skip move or rename actions which would lead to an error condition. An error happens when a source is neither existing nor controlled by GIT, or when it would overwrite an existing file unless
+\fI\-f\fR
+is given.
.TP
\-n
Do nothing; only show what would happen
-
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org> Rewritten by Ryan Anderson <ryan@michonline\&.com> Move functionality added by Josef Weidendorfer <Josef\&.Weidendorfer@gmx\&.de>
-
+Written by Linus Torvalds <torvalds@osdl.org> Rewritten by Ryan Anderson <ryan@michonline.com> Move functionality added by Josef Weidendorfer <Josef.Weidendorfer@gmx.de>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-NAME-REV" 1 "" "" ""
-.SH NAME
-git-name-rev \- Find symbolic names for given revs
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-name\-rev \- Find symbolic names for given revs
.SH "SYNOPSIS"
-
-
-\fIgit\-name\-rev\fR [\-\-tags] ( \-\-all | \-\-stdin | <committish>... )
-
+\fIgit\-name\-rev\fR [\-\-tags] ( \-\-all | \-\-stdin | <committish>\&... )
+.sp
.SH "DESCRIPTION"
-
-
-Finds symbolic names suitable for human digestion for revisions given in any format parsable by git\-rev\-parse\&.
-
+Finds symbolic names suitable for human digestion for revisions given in any format parsable by git\-rev\-parse.
+.sp
.SH "OPTIONS"
-
.TP
\-\-tags
Do not use branch names, but only tags to name the commits
-
.TP
\-\-all
List all commits reachable from all refs
-
.TP
\-\-stdin
Read from stdin, append "(<rev_name>)" to all sha1's of nameable commits, and pass to stdout
-
.SH "EXAMPLE"
-
-
-Given a commit, find out where it is relative to the local refs\&. Say somebody wrote you about that fantastic commit 33db5f4d9027a10e477ccf054b2c1ab94f74c85a\&. Of course, you look into the commit, but that only tells you what happened, but not the context\&.
-
-
+Given a commit, find out where it is relative to the local refs. Say somebody wrote you about that fantastic commit 33db5f4d9027a10e477ccf054b2c1ab94f74c85a. Of course, you look into the commit, but that only tells you what happened, but not the context.
+.sp
Enter git\-name\-rev:
-
+.sp
+.sp
.nf
% git name\-rev 33db5f4d9027a10e477ccf054b2c1ab94f74c85a
-33db5f4d9027a10e477ccf054b2c1ab94f74c85a tags/v0\&.99^0~940
+33db5f4d9027a10e477ccf054b2c1ab94f74c85a tags/v0.99^0~940
.fi
-
-
-Now you are wiser, because you know that it happened 940 revisions before v0\&.99\&.
-
-
+Now you are wiser, because you know that it happened 940 revisions before v0.99.
+.sp
Another nice thing you can do is:
-
+.sp
+.sp
.nf
% git log | git name\-rev \-\-stdin
.fi
-
.SH "AUTHOR"
-
-
-Written by Johannes Schindelin <Johannes\&.Schindelin@gmx\&.de>
-
+Written by Johannes Schindelin <Johannes.Schindelin@gmx.de>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Johannes Schindelin\&.
-
+Documentation by Johannes Schindelin.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-P4IMPORT" 1 "" "" ""
-.SH NAME
-git-p4import \- Import a Perforce repository into git
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-p4import \- Import a Perforce repository into git
.SH "SYNOPSIS"
-
-
git\-p4import [\-q|\-v] [\-\-notags] [\-\-authors <file>] [\-t <timezone>] <//p4repo/path> <branch>
-
-
+.sp
git\-p4import \-\-stitch <//p4repo/path>
-
-
+.sp
git\-p4import
-
+.sp
.SH "DESCRIPTION"
-
-
-Import a Perforce repository into an existing git repository\&. When a <//p4repo/path> and <branch> are specified a new branch with the given name will be created and the initial import will begin\&.
-
-
-Once the initial import is complete you can do an incremental import of new commits from the Perforce repository\&. You do this by checking out the appropriate git branch and then running git\-p4import without any options\&.
-
-
-The standard p4 client is used to communicate with the Perforce repository; it must be configured correctly in order for git\-p4import to operate (see below)\&.
-
+Import a Perforce repository into an existing git repository. When a <//p4repo/path> and <branch> are specified a new branch with the given name will be created and the initial import will begin.
+.sp
+Once the initial import is complete you can do an incremental import of new commits from the Perforce repository. You do this by checking out the appropriate git branch and then running git\-p4import without any options.
+.sp
+The standard p4 client is used to communicate with the Perforce repository; it must be configured correctly in order for git\-p4import to operate (see below).
+.sp
.SH "OPTIONS"
-
.TP
\-q
-Do not display any progress information\&.
-
+Do not display any progress information.
.TP
\-v
-Give extra progress information\&.
-
+Give extra progress information.
.TP
\-\-authors
-Specify an authors file containing a mapping of Perforce user ids to full names and email addresses (see Notes below)\&.
-
+Specify an authors file containing a mapping of Perforce user ids to full names and email addresses (see Notes below).
.TP
\-\-notags
-Do not create a tag for each imported commit\&.
-
+Do not create a tag for each imported commit.
.TP
\-\-stitch
-Import the contents of the given perforce branch into the currently checked out git branch\&.
-
+Import the contents of the given perforce branch into the currently checked out git branch.
.TP
\-\-log
-Store debugging information in the specified file\&.
-
+Store debugging information in the specified file.
.TP
\-t
-Specify that the remote repository is in the specified timezone\&. Timezone must be in the format "US/Pacific" or "Europe/London" etc\&. You only need to specify this once, it will be saved in the git config file for the repository\&.
-
+Specify that the remote repository is in the specified timezone. Timezone must be in the format "US/Pacific" or "Europe/London" etc. You only need to specify this once, it will be saved in the git config file for the repository.
.TP
<//p4repo/path>
-The Perforce path that will be imported into the specified branch\&.
-
+The Perforce path that will be imported into the specified branch.
.TP
<branch>
-The new branch that will be created to hold the Perforce imports\&.
-
+The new branch that will be created to hold the Perforce imports.
.SH "P4 CLIENT"
-
-
-You must make the p4 client command available in your $PATH and configure it to communicate with the target Perforce repository\&. Typically this means you must set the "$P4PORT" and "$P4CLIENT" environment variables\&.
-
-
+You must make the p4 client command available in your $PATH and configure it to communicate with the target Perforce repository. Typically this means you must set the "$P4PORT" and "$P4CLIENT" environment variables.
+.sp
You must also configure a p4 client "view" which maps the Perforce branch into the top level of your git repository, for example:
-
+.sp
+.sp
.nf
Client: myhost
Options: noallwrite clobber nocompress unlocked modtime rmdir
View:
- //public/jam/\&.\&.\&. //myhost/jam/\&.\&.\&.
+ //public/jam/... //myhost/jam/...
.fi
-
-
With the above p4 client setup, you could import the "jam" perforce branch into a branch named "jammy", like so:
-
+.sp
+.sp
.nf
$ mkdir \-p /home/sean/import/jam
$ cd /home/sean/import/jam
$ git init\-db
$ git p4import //public/jam jammy
.fi
-
.SH "MULTIPLE BRANCHES"
-
-
-Note that by creating multiple "views" you can use git\-p4import to import additional branches into the same git repository\&. However, the p4 client has a limitation in that it silently ignores all but the last "view" that maps into the same local directory\&. So the following will \fInot\fR work:
-
+Note that by creating multiple "views" you can use git\-p4import to import additional branches into the same git repository. However, the p4 client has a limitation in that it silently ignores all but the last "view" that maps into the same local directory. So the following will \fBnot\fR work:
+.sp
+.sp
.nf
View:
- //public/jam/\&.\&.\&. //myhost/jam/\&.\&.\&.
- //public/other/\&.\&.\&. //myhost/jam/\&.\&.\&.
- //public/guest/\&.\&.\&. //myhost/jam/\&.\&.\&.
+ //public/jam/... //myhost/jam/...
+ //public/other/... //myhost/jam/...
+ //public/guest/... //myhost/jam/...
.fi
-
-
-If you want more than one Perforce branch to be imported into the same directory you must employ a workaround\&. A simple option is to adjust your p4 client before each import to only include a single view\&.
-
-
-Another option is to create multiple symlinks locally which all point to the same directory in your git repository and then use one per "view" instead of listing the actual directory\&.
-
+If you want more than one Perforce branch to be imported into the same directory you must employ a workaround. A simple option is to adjust your p4 client before each import to only include a single view.
+.sp
+Another option is to create multiple symlinks locally which all point to the same directory in your git repository and then use one per "view" instead of listing the actual directory.
+.sp
.SH "TAGS"
-
-
-A git tag of the form p4/xx is created for every change imported from the Perforce repository where xx is the Perforce changeset number\&. Therefore after the import you can use git to access any commit by its Perforce number, e\&.g\&. git show p4/327\&.
-
-
-The tag associated with the HEAD commit is also how git\-p4import determines if there are new changes to incrementally import from the Perforce repository\&.
-
-
-If you import from a repository with many thousands of changes you will have an equal number of p4/xxxx git tags\&. Git tags can be expensive in terms of disk space and repository operations\&. If you don't need to perform further incremental imports, you may delete the tags\&.
-
+A git tag of the form p4/xx is created for every change imported from the Perforce repository where xx is the Perforce changeset number. Therefore after the import you can use git to access any commit by its Perforce number, e.g. git show p4/327.
+.sp
+The tag associated with the HEAD commit is also how git\-p4import determines if there are new changes to incrementally import from the Perforce repository.
+.sp
+If you import from a repository with many thousands of changes you will have an equal number of p4/xxxx git tags. Git tags can be expensive in terms of disk space and repository operations. If you don't need to perform further incremental imports, you may delete the tags.
+.sp
.SH "NOTES"
-
-
-You can interrupt the import (e\&.g\&. ctrl\-c) at any time and restart it without worry\&.
-
-
-Author information is automatically determined by querying the Perforce "users" table using the id associated with each change\&. However, if you want to manually supply these mappings you can do so with the "\-\-authors" option\&. It accepts a file containing a list of mappings with each line containing one mapping in the format:
-
+You can interrupt the import (e.g. ctrl\-c) at any time and restart it without worry.
+.sp
+Author information is automatically determined by querying the Perforce "users" table using the id associated with each change. However, if you want to manually supply these mappings you can do so with the "\-\-authors" option. It accepts a file containing a list of mappings with each line containing one mapping in the format:
+.sp
+.sp
.nf
- perforce_id = Full Name <email@address\&.com>
+ perforce_id = Full Name <email@address.com>
.fi
-
.SH "AUTHOR"
-
-
-Written by Sean Estabrooks <seanlkml@sympatico\&.ca>
-
+Written by Sean Estabrooks <seanlkml@sympatico.ca>
+.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\-OBJECTS" "1" "09/18/2006" "" ""
+.TH "GIT\-PACK\-OBJECTS" "1" "10/03/2006" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-PACK-REDUNDANT" 1 "" "" ""
-.SH NAME
-git-pack-redundant \- Program used to find redundant pack files
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-pack\-redundant \- Program used to find redundant pack files
.SH "SYNOPSIS"
-
-
-\fIgit\-pack\-redundant\fR [ \-\-verbose ] [ \-\-alt\-odb ] < \-\-all | \&.pack filename ... >
-
+\fIgit\-pack\-redundant\fR [ \-\-verbose ] [ \-\-alt\-odb ] < \-\-all | .pack filename \&... >
+.sp
.SH "DESCRIPTION"
-
-
-This program computes which packs in your repository are redundant\&. The output is suitable for piping to \fIxargs rm\fR if you are in the root of the repository\&.
-
-
-git\-pack\-redundant accepts a list of objects on standard input\&. Any objects given will be ignored when checking which packs are required\&. This makes the following command useful when wanting to remove packs which contain unreachable objects\&.
-
-
+This program computes which packs in your repository are redundant. The output is suitable for piping to \fIxargs rm\fR if you are in the root of the repository.
+.sp
+git\-pack\-redundant accepts a list of objects on standard input. Any objects given will be ignored when checking which packs are required. This makes the following command useful when wanting to remove packs which contain unreachable objects.
+.sp
git\-fsck\-objects \-\-full \-\-unreachable | cut \-d \fI \fR \-f3 | git\-pack\-redundant \-\-all | xargs rm
-
+.sp
.SH "OPTIONS"
-
.TP
\-\-all
-Processes all packs\&. Any filenames on the command line are ignored\&.
-
+Processes all packs. Any filenames on the command line are ignored.
.TP
\-\-alt\-odb
-Don't require objects present in packs from alternate object directories to be present in local packs\&.
-
+Don't require objects present in packs from alternate object directories to be present in local packs.
.TP
\-\-verbose
-Outputs some statistics to stderr\&. Has a small performance penalty\&.
-
+Outputs some statistics to stderr. Has a small performance penalty.
.SH "AUTHOR"
-
-
-Written by Lukas Sandström <lukass@etek\&.chalmers\&.se>
-
+Written by Lukas Sandström <lukass@etek.chalmers.se>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Lukas Sandström <lukass@etek\&.chalmers\&.se>
-
+Documentation by Lukas Sandström <lukass@etek.chalmers.se>
+.sp
.SH "SEE ALSO"
-
-
\fBgit\-pack\-objects\fR(1) \fBgit\-repack\fR(1) \fBgit\-prune\-packed\fR(1)
-
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-PARSE-REMOTE" 1 "" "" ""
-.SH NAME
-git-parse-remote \- Routines to help parsing $GIT_DIR/remotes/
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-parse\-remote \- Routines to help parsing $GIT_DIR/remotes/
.SH "SYNOPSIS"
-
-
-\fI\&. git\-parse\-remote\fR
-
+\fI. git\-parse\-remote\fR
+.sp
.SH "DESCRIPTION"
-
-
-This script is included in various scripts to supply routines to parse files under $GIT_DIR/remotes/ and $GIT_DIR/branches/\&.
-
-
+This script is included in various scripts to supply routines to parse files under $GIT_DIR/remotes/ and $GIT_DIR/branches/.
+.sp
The primary entry points are:
-
+.sp
.TP
get_remote_refs_for_fetch
-Given the list of user\-supplied <repo> <refspec>..., return the list of refs to fetch after canonicalizing them into $GIT_DIR relative paths (e\&.g\&. refs/heads/foo)\&. When <refspec>... is empty the returned list of refs consists of the defaults for the given <repo>, if specified in $GIT_DIR/remotes/ or $GIT_DIR/branches/\&.
-
+Given the list of user\-supplied
+<repo> <refspec>\&..., return the list of refs to fetch after canonicalizing them into
+$GIT_DIR
+relative paths (e.g.
+refs/heads/foo). When
+<refspec>\&...
+is empty the returned list of refs consists of the defaults for the given
+<repo>, if specified in
+$GIT_DIR/remotes/
+or
+$GIT_DIR/branches/.
.TP
get_remote_refs_for_push
-Given the list of user\-supplied <repo> <refspec>..., return the list of refs to push in a form suitable to be fed to the git\-send\-pack command\&. When <refspec>... is empty the returned list of refs consists of the defaults for the given <repo>, if specified in $GIT_DIR/remotes/\&.
-
+Given the list of user\-supplied
+<repo> <refspec>\&..., return the list of refs to push in a form suitable to be fed to the
+git\-send\-pack
+command. When
+<refspec>\&...
+is empty the returned list of refs consists of the defaults for the given
+<repo>, if specified in
+$GIT_DIR/remotes/.
.SH "AUTHOR"
-
-
-Written by Junio C Hamano\&.
-
+Written by Junio C Hamano.
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-PATCH-ID" 1 "" "" ""
-.SH NAME
-git-patch-id \- Generate a patch ID
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-patch\-id \- Generate a patch ID
.SH "SYNOPSIS"
-
-
\fIgit\-patch\-id\fR < <patch>
-
+.sp
.SH "DESCRIPTION"
-
-
-A "patch ID" is nothing but a SHA1 of the diff associated with a patch, with whitespace and line numbers ignored\&. As such, it's "reasonably stable", but at the same time also reasonably unique, i\&.e\&., two patches that have the same "patch ID" are almost guaranteed to be the same thing\&.
-
-
-IOW, you can use this thing to look for likely duplicate commits\&.
-
-
-When dealing with git\-diff\-tree output, it takes advantage of the fact that the patch is prefixed with the object name of the commit, and outputs two 40\-byte hexadecimal string\&. The first string is the patch ID, and the second string is the commit ID\&. This can be used to make a mapping from patch ID to commit ID\&.
-
+A "patch ID" is nothing but a SHA1 of the diff associated with a patch, with whitespace and line numbers ignored. As such, it's "reasonably stable", but at the same time also reasonably unique, i.e., two patches that have the same "patch ID" are almost guaranteed to be the same thing.
+.sp
+IOW, you can use this thing to look for likely duplicate commits.
+.sp
+When dealing with git\-diff\-tree output, it takes advantage of the fact that the patch is prefixed with the object name of the commit, and outputs two 40\-byte hexadecimal string. The first string is the patch ID, and the second string is the commit ID. This can be used to make a mapping from patch ID to commit ID.
+.sp
.SH "OPTIONS"
-
.TP
<patch>
-The diff to create the ID of\&.
-
+The diff to create the ID of.
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+Written by Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-PEEK-REMOTE" 1 "" "" ""
-.SH NAME
-git-peek-remote \- Lists the references in a remote repository
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-peek\-remote \- Lists the references in a remote repository
.SH "SYNOPSIS"
-
-
\fIgit\-peek\-remote\fR [\-\-exec=<git\-upload\-pack>] [<host>:]<directory>
-
+.sp
.SH "DESCRIPTION"
-
-
-Lists the references the remote repository has, and optionally stores them in the local repository under the same name\&.
-
+Lists the references the remote repository has, and optionally stores them in the local repository under the same name.
+.sp
.SH "OPTIONS"
-
.TP
\-\-exec=<git\-upload\-pack>
-Use this to specify the path to \fIgit\-upload\-pack\fR on the remote side, if it is not found on your $PATH\&. Some installations of sshd ignores the user's environment setup scripts for login shells (e\&.g\&. \&.bash_profile) and your privately installed git may not be found on the system default $PATH\&. Another workaround suggested is to set up your $PATH in "\&.bashrc", but this flag is for people who do not want to pay the overhead for non\-interactive shells, but prefer having a lean \&.bashrc file (they set most of the things up in \&.bash_profile)\&.
-
+Use this to specify the path to
+\fIgit\-upload\-pack\fR
+on the remote side, if it is not found on your $PATH. Some installations of sshd ignores the user's environment setup scripts for login shells (e.g. .bash_profile) and your privately installed git may not be found on the system default $PATH. Another workaround suggested is to set up your $PATH in ".bashrc", but this flag is for people who do not want to pay the overhead for non\-interactive shells, but prefer having a lean .bashrc file (they set most of the things up in .bash_profile).
.TP
<host>
-A remote host that houses the repository\&. When this part is specified, \fIgit\-upload\-pack\fR is invoked via ssh\&.
-
+A remote host that houses the repository. When this part is specified,
+\fIgit\-upload\-pack\fR
+is invoked via ssh.
.TP
<directory>
-The repository to sync from\&.
-
+The repository to sync from.
.SH "AUTHOR"
-
-
-Written by Junio C Hamano <junkio@cox\&.net>
-
+Written by Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano\&.
-
+Documentation by Junio C Hamano.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-PRUNE-PACKED" 1 "" "" ""
-.SH NAME
-git-prune-packed \- Program used to remove the extra object files that are now residing in a pack file.
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-prune\-packed \- Program used to remove the extra object files that are now residing in a pack file.
.SH "SYNOPSIS"
-
-
\fIgit\-prune\-packed\fR [\-n]
-
+.sp
.SH "DESCRIPTION"
-
-
-This program search the $GIT_OBJECT_DIR for all objects that currently exist in a pack file as well as the independent object directories\&.
-
-
-All such extra objects are removed\&.
-
-
-A pack is a collection of objects, individually compressed, with delta compression applied, stored in a single file, with an associated index file\&.
-
-
-Packs are used to reduce the load on mirror systems, backup engines, disk storage, etc\&.
-
+This program search the $GIT_OBJECT_DIR for all objects that currently exist in a pack file as well as the independent object directories.
+.sp
+All such extra objects are removed.
+.sp
+A pack is a collection of objects, individually compressed, with delta compression applied, stored in a single file, with an associated index file.
+.sp
+Packs are used to reduce the load on mirror systems, backup engines, disk storage, etc.
+.sp
.SH "OPTIONS"
-
.TP
\-n
-Don't actually remove any objects, only show those that would have been removed\&.
-
+Don't actually remove any objects, only show those that would have been removed.
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+Written by Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Ryan Anderson <ryan@michonline\&.com>
-
+Documentation by Ryan Anderson <ryan@michonline.com>
+.sp
.SH "SEE ALSO"
-
-
\fBgit\-pack\-objects\fR(1) \fBgit\-repack\fR(1)
-
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-PRUNE" 1 "" "" ""
-.SH NAME
-git-prune \- Prunes all unreachable objects from the object database
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-prune \- Prunes all unreachable objects from the object database
.SH "SYNOPSIS"
-
-
-\fIgit\-prune\fR [\-n] [\-\-] [<head>...]
-
+\fIgit\-prune\fR [\-n] [\-\-] [<head>\&...]
+.sp
.SH "DESCRIPTION"
-
-
-This runs git\-fsck\-objects \-\-unreachable using all the refs available in $GIT_DIR/refs, optionally with additional set of objects specified on the command line, and prunes all objects unreachable from any of these head objects from the object database\&. In addition, it prunes the unpacked objects that are also found in packs by running git prune\-packed\&.
-
+This runs git\-fsck\-objects \-\-unreachable using all the refs available in $GIT_DIR/refs, optionally with additional set of objects specified on the command line, and prunes all objects unreachable from any of these head objects from the object database. In addition, it prunes the unpacked objects that are also found in packs by running git prune\-packed.
+.sp
.SH "OPTIONS"
-
.TP
\-n
-Do not remove anything; just report what it would remove\&.
-
+Do not remove anything; just report what it would remove.
.TP
\-\-
-Do not interpret any more arguments as options\&.
-
+Do not interpret any more arguments as options.
.TP
-<head>...
-In addition to objects reachable from any of our references, keep objects reachable from listed <head>s\&.
-
+<head>\&...
+In addition to objects reachable from any of our references, keep objects reachable from listed <head>s.
.SH "EXAMPLE"
-
-
-To prune objects not used by your repository nor another that borrows from your repository via its \&.git/objects/info/alternates:
-
+To prune objects not used by your repository nor another that borrows from your repository via its .git/objects/info/alternates:
+.sp
+.sp
.nf
-$ git prune $(cd \&.\&./another && $(git\-rev\-parse \-\-all))
+$ git prune $(cd ../another && $(git\-rev\-parse \-\-all))
.fi
-
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+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>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-PULL" 1 "" "" ""
-.SH NAME
-git-pull \- Pull and merge from another repository
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-pull \- Pull and merge from another repository
.SH "SYNOPSIS"
-
-
-\fIgit\-pull\fR <options> <repository> <refspec>...
-
+\fIgit\-pull\fR <options> <repository> <refspec>\&...
+.sp
.SH "DESCRIPTION"
-
-
-Runs git\-fetch with the given parameters, and calls git\-merge to merge the retrieved head(s) into the current branch\&.
-
-
-Note that you can use \&. (current directory) as the <repository> to pull from the local repository -- this is useful when merging local branches into the current branch\&.
-
+Runs git\-fetch with the given parameters, and calls git\-merge to merge the retrieved head(s) into the current branch.
+.sp
+Note that you can use . (current directory) as the <repository> to pull from the local repository \(em this is useful when merging local branches into the current branch.
+.sp
.SH "OPTIONS"
-
.TP
\-n, \-\-no\-summary
-Do not show diffstat at the end of the merge\&.
-
+Do not show diffstat at the end of the merge.
.TP
\-\-no\-commit
-Perform the merge but pretend the merge failed and do not autocommit, to give the user a chance to inspect and further tweak the merge result before committing\&.
-
+Perform the merge but pretend the merge failed and do not autocommit, to give the user a chance to inspect and further tweak the merge result before committing.
.TP
\-\-squash
-Produce the working tree and index state as if a real merge happened, but do not actually make a commit or move the HEAD, nor record $GIT_DIR/MERGE_HEAD to cause the next git commit command to create a merge commit\&. This allows you to create a single commit on top of the current branch whose effect is the same as merging another branch (or more in case of an octopus)\&.
-
+Produce the working tree and index state as if a real merge happened, but do not actually make a commit or move the
+HEAD, nor record
+$GIT_DIR/MERGE_HEAD
+to cause the next
+git commit
+command to create a merge commit. This allows you to create a single commit on top of the current branch whose effect is the same as merging another branch (or more in case of an octopus).
.TP
\-s <strategy>, \-\-strategy=<strategy>
-Use the given merge strategy; can be supplied more than once to specify them in the order they should be tried\&. If there is no \-s option, a built\-in list of strategies is used instead (git\-merge\-recursive when merging a single head, git\-merge\-octopus otherwise)\&.
-
+Use the given merge strategy; can be supplied more than once to specify them in the order they should be tried. If there is no
+\-s
+option, a built\-in list of strategies is used instead (git\-merge\-recursive
+when merging a single head,
+git\-merge\-octopus
+otherwise).
.TP
\-a, \-\-append
-Append ref names and object names of fetched refs to the existing contents of \&.git/FETCH_HEAD\&. Without this option old data in \&.git/FETCH_HEAD will be overwritten\&.
-
+Append ref names and object names of fetched refs to the existing contents of
+.git/FETCH_HEAD. Without this option old data in
+.git/FETCH_HEAD
+will be overwritten.
.TP
\-\-upload\-pack <upload\-pack>
-When given, and the repository to fetch from is handled by \fIgit\-fetch\-pack\fR, \fI\-\-exec=<upload\-pack>\fR is passed to the command to specify non\-default path for the command run on the other end\&.
-
+When given, and the repository to fetch from is handled by
+\fIgit\-fetch\-pack\fR,
+\fI\-\-exec=<upload\-pack>\fR
+is passed to the command to specify non\-default path for the command run on the other end.
.TP
\-f, \-\-force
-When git\-fetch is used with <rbranch>:<lbranch> refspec, it refuses to update the local branch <lbranch> unless the remote branch <rbranch> it fetches is a descendant of <lbranch>\&. This option overrides that check\&.
-
+When
+git\-fetch
+is used with
+<rbranch>:<lbranch>
+refspec, it refuses to update the local branch
+<lbranch>
+unless the remote branch
+<rbranch>
+it fetches is a descendant of
+<lbranch>. This option overrides that check.
.TP
\-\-no\-tags
-By default, git\-fetch fetches tags that point at objects that are downloaded from the remote repository and stores them locally\&. This option disables this automatic tag following\&.
-
+By default,
+git\-fetch
+fetches tags that point at objects that are downloaded from the remote repository and stores them locally. This option disables this automatic tag following.
.TP
\-t, \-\-tags
-Most of the tags are fetched automatically as branch heads are downloaded, but tags that do not point at objects reachable from the branch heads that are being tracked will not be fetched by this mechanism\&. This flag lets all tags and their associated objects be downloaded\&.
-
+Most of the tags are fetched automatically as branch heads are downloaded, but tags that do not point at objects reachable from the branch heads that are being tracked will not be fetched by this mechanism. This flag lets all tags and their associated objects be downloaded.
.TP
\-k, \-\-keep
-Keep downloaded pack\&.
-
+Keep downloaded pack.
.TP
\-u, \-\-update\-head\-ok
-By default git\-fetch refuses to update the head which corresponds to the current branch\&. This flag disables the check\&. Note that fetching into the current branch will not update the index and working directory, so use it with care\&.
-
+By default
+git\-fetch
+refuses to update the head which corresponds to the current branch. This flag disables the check. Note that fetching into the current branch will not update the index and working directory, so use it with care.
.TP
<repository>
-The "remote" repository that is the source of a fetch or pull operation\&. See the section GIT URLS below\&.
-
+The "remote" repository that is the source of a fetch or pull operation. See the section
+GIT URLS
+below.
.TP
<refspec>
-The canonical format of a <refspec> parameter is +?<src>:<dst>; that is, an optional plus +, followed by the source ref, followed by a colon :, followed by the destination ref\&.
-
-The remote ref that matches <src> is fetched, and if <dst> is not empty string, the local ref that matches it is fast forwarded using <src>\&. Again, if the optional plus + is used, the local ref is updated even if it does not result in a fast forward update\&.
-
-
-.RS
-.Sh "Note"
-If the remote branch from which you want to pull is modified in non\-linear ways such as being rewound and rebased frequently, then a pull will attempt a merge with an older version of itself, likely conflict, and fail\&. It is under these conditions that you would want to use the + sign to indicate non\-fast\-forward updates will be needed\&. There is currently no easy way to determine or declare that a branch will be made available in a repository with this behavior; the pulling user simply must know this is the expected usage pattern for a branch\&.
-
-.RE
-
-.RS
-.Sh "Note"
-You never do your own development on branches that appear on the right hand side of a <refspec> colon on Pull: lines; they are to be updated by git\-fetch\&. If you intend to do development derived from a remote branch B, have a Pull: line to track it (i\&.e\&. Pull: B:remote\-B), and have a separate branch my\-B to do your development on top of it\&. The latter is created by git branch my\-B remote\-B (or its equivalent git checkout \-b my\-B remote\-B)\&. Run git fetch to keep track of the progress of the remote side, and when you see something new on the remote branch, merge it into your development branch with git pull \&. remote\-B, while you are on my\-B branch\&. The common Pull: master:origin mapping of a remote master branch to a local origin branch, which is then merged to a local development branch, again typically named master, is made when you run git clone for you to follow this pattern\&.
-
-.RE
-
-.RS
-.Sh "Note"
-There is a difference between listing multiple <refspec> directly on git\-pull command line and having multiple Pull: <refspec> lines for a <repository> and running git\-pull command without any explicit <refspec> parameters\&. <refspec> listed explicitly on the command line are always merged into the current branch after fetching\&. In other words, if you list more than one remote refs, you would be making an Octopus\&. While git\-pull run without any explicit <refspec> parameter takes default <refspec>s from Pull: lines, it merges only the first <refspec> found into the current branch, after fetching all the remote refs\&. This is because making an Octopus from remote refs is rarely done, while keeping track of multiple remote heads in one\-go by fetching more than one is often useful\&.
-
-.RE
-Some short\-cut notations are also supported\&.
-
+The canonical format of a <refspec> parameter is
++?<src>:<dst>; that is, an optional plus
++, followed by the source ref, followed by a colon
+:, followed by the destination ref.
+.sp
+The remote ref that matches <src> is fetched, and if <dst> is not empty string, the local ref that matches it is fast forwarded using <src>. Again, if the optional plus
++
+is used, the local ref is updated even if it does not result in a fast forward update.
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+\fBNote\fR
+If the remote branch from which you want to pull is modified in non\-linear ways such as being rewound and rebased frequently, then a pull will attempt a merge with an older version of itself, likely conflict, and fail. It is under these conditions that you would want to use the
++
+sign to indicate non\-fast\-forward updates will be needed. There is currently no easy way to determine or declare that a branch will be made available in a repository with this behavior; the pulling user simply must know this is the expected usage pattern for a branch.
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+\fBNote\fR
+You never do your own development on branches that appear on the right hand side of a <refspec> colon on
+Pull:
+lines; they are to be updated by
+git\-fetch. If you intend to do development derived from a remote branch
+B, have a
+Pull:
+line to track it (i.e.
+Pull: B:remote\-B), and have a separate branch
+my\-B
+to do your development on top of it. The latter is created by
+git branch my\-B remote\-B
+(or its equivalent
+git checkout \-b my\-B remote\-B). Run
+git fetch
+to keep track of the progress of the remote side, and when you see something new on the remote branch, merge it into your development branch with
+git pull . remote\-B, while you are on
+my\-B
+branch. The common
+Pull: master:origin
+mapping of a remote
+master
+branch to a local
+origin
+branch, which is then merged to a local development branch, again typically named
+master, is made when you run
+git clone
+for you to follow this pattern.
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+\fBNote\fR
+There is a difference between listing multiple <refspec> directly on
+git\-pull
+command line and having multiple
+Pull:
+<refspec> lines for a <repository> and running
+git\-pull
+command without any explicit <refspec> parameters. <refspec> listed explicitly on the command line are always merged into the current branch after fetching. In other words, if you list more than one remote refs, you would be making an Octopus. While
+git\-pull
+run without any explicit <refspec> parameter takes default <refspec>s from
+Pull:
+lines, it merges only the first <refspec> found into the current branch, after fetching all the remote refs. This is because making an Octopus from remote refs is rarely done, while keeping track of multiple remote heads in one\-go by fetching more than one is often useful.
+Some short\-cut notations are also supported.
.RS
.TP 3
\(bu
- tag <tag> means the same as refs/tags/<tag>:refs/tags/<tag>; it requests fetching everything up to the given tag\&.
+tag <tag>
+means the same as
+refs/tags/<tag>:refs/tags/<tag>; it requests fetching everything up to the given tag.
.TP
\(bu
A parameter <ref> without a colon is equivalent to <ref>: when pulling/fetching, so it merges <ref> into the current branch without storing the remote branch anywhere locally
-.LP
.RE
-.IP
-
.SH "GIT URLS"
-
-
One of the following notations can be used to name the remote repository:
-
+.sp
.IP
-
.TP 3
\(bu
-rsync://host\&.xz/path/to/repo\&.git/
+rsync://host.xz/path/to/repo.git/
.TP
\(bu
-http://host\&.xz/path/to/repo\&.git/
+http://host.xz/path/to/repo.git/
.TP
\(bu
-https://host\&.xz/path/to/repo\&.git/
+https://host.xz/path/to/repo.git/
.TP
\(bu
-git://host\&.xz/path/to/repo\&.git/
+git://host.xz/path/to/repo.git/
.TP
\(bu
-git://host\&.xz/~user/path/to/repo\&.git/
+git://host.xz/~user/path/to/repo.git/
.TP
\(bu
-ssh://[user@]host\&.xz/path/to/repo\&.git/
+ssh://[user@]host.xz/path/to/repo.git/
.TP
\(bu
-ssh://[user@]host\&.xz/~user/path/to/repo\&.git/
+ssh://[user@]host.xz/~user/path/to/repo.git/
.TP
\(bu
-ssh://[user@]host\&.xz/~/path/to/repo\&.git
-.LP
-
-
-SSH is the default transport protocol\&. You can optionally specify which user to log\-in as, and an alternate, scp\-like syntax is also supported\&. Both syntaxes support username expansion, as does the native git protocol\&. The following three are identical to the last three above, respectively:
-
+ssh://[user@]host.xz/~/path/to/repo.git
+SSH is the default transport protocol. You can optionally specify which user to log\-in as, and an alternate, scp\-like syntax is also supported. Both syntaxes support username expansion, as does the native git protocol. The following three are identical to the last three above, respectively:
+.sp
.IP
-
.TP 3
\(bu
-[user@]host\&.xz:/path/to/repo\&.git/
+[user@]host.xz:/path/to/repo.git/
.TP
\(bu
-[user@]host\&.xz:~user/path/to/repo\&.git/
+[user@]host.xz:~user/path/to/repo.git/
.TP
\(bu
-[user@]host\&.xz:path/to/repo\&.git
-.LP
-
-
+[user@]host.xz:path/to/repo.git
To sync with a local directory, use:
-
+.sp
.IP
-
.TP 3
\(bu
-/path/to/repo\&.git/
-.LP
-
+/path/to/repo.git/
.SH "REMOTES"
-
-
In addition to the above, as a short\-hand, the name of a file in $GIT_DIR/remotes directory can be given; the named file should be in the following format:
-
+.sp
+.sp
.nf
URL: one of the above URL format
Push: <refspec>
Pull: <refspec>
.fi
-
-
-Then such a short\-hand is specified in place of <repository> without <refspec> parameters on the command line, <refspec> specified on Push: lines or Pull: lines are used for git\-push and git\-fetch/git\-pull, respectively\&. Multiple Push: and Pull: lines may be specified for additional branch mappings\&.
-
-
-The name of a file in $GIT_DIR/branches directory can be specified as an older notation short\-hand; the named file should contain a single line, a URL in one of the above formats, optionally followed by a hash # and the name of remote head (URL fragment notation)\&. $GIT_DIR/branches/<remote> file that stores a <url> without the fragment is equivalent to have this in the corresponding file in the $GIT_DIR/remotes/ directory\&.
-
+Then such a short\-hand is specified in place of <repository> without <refspec> parameters on the command line, <refspec> specified on Push: lines or Pull: lines are used for git\-push and git\-fetch/git\-pull, respectively. Multiple Push: and Pull: lines may be specified for additional branch mappings.
+.sp
+The name of a file in $GIT_DIR/branches directory can be specified as an older notation short\-hand; the named file should contain a single line, a URL in one of the above formats, optionally followed by a hash # and the name of remote head (URL fragment notation). $GIT_DIR/branches/<remote> file that stores a <url> without the fragment is equivalent to have this in the corresponding file in the $GIT_DIR/remotes/ directory.
+.sp
+.sp
.nf
URL: <url>
Pull: refs/heads/master:<remote>
.fi
-
-
while having <url>#<head> is equivalent to
-
+.sp
+.sp
.nf
URL: <url>
Pull: refs/heads/<head>:<remote>
.fi
-
.SH "MERGE STRATEGIES"
-
.TP
resolve
-This can only resolve two heads (i\&.e\&. the current branch and another branch you pulled from) using 3\-way merge algorithm\&. It tries to carefully detect criss\-cross merge ambiguities and is considered generally safe and fast\&.
-
+This can only resolve two heads (i.e. the current branch and another branch you pulled from) using 3\-way merge algorithm. It tries to carefully detect criss\-cross merge ambiguities and is considered generally safe and fast.
.TP
recursive
-This can only resolve two heads using 3\-way merge algorithm\&. When there are more than one common ancestors that can be used for 3\-way merge, it creates a merged tree of the common ancestors and uses that as the reference tree for the 3\-way merge\&. This has been reported to result in fewer merge conflicts without causing mis\-merges by tests done on actual merge commits taken from Linux 2\&.6 kernel development history\&. Additionally this can detect and handle merges involving renames\&. This is the default merge strategy when pulling or merging one branch\&.
-
+This can only resolve two heads using 3\-way merge algorithm. When there are more than one common ancestors that can be used for 3\-way merge, it creates a merged tree of the common ancestors and uses that as the reference tree for the 3\-way merge. This has been reported to result in fewer merge conflicts without causing mis\-merges by tests done on actual merge commits taken from Linux 2.6 kernel development history. Additionally this can detect and handle merges involving renames. This is the default merge strategy when pulling or merging one branch.
.TP
octopus
-This resolves more than two\-head case, but refuses to do complex merge that needs manual resolution\&. It is primarily meant to be used for bundling topic branch heads together\&. This is the default merge strategy when pulling or merging more than one branches\&.
-
+This resolves more than two\-head case, but refuses to do complex merge that needs manual resolution. It is primarily meant to be used for bundling topic branch heads together. This is the default merge strategy when pulling or merging more than one branches.
.TP
ours
-This resolves any number of heads, but the result of the merge is always the current branch head\&. It is meant to be used to supersede old development history of side branches\&.
-
+This resolves any number of heads, but the result of the merge is always the current branch head. It is meant to be used to supersede old development history of side branches.
.SH "EXAMPLES"
-
.TP
git pull, git pull origin
-Fetch the default head from the repository you cloned from and merge it into your current branch\&.
-
+Fetch the default head from the repository you cloned from and merge it into your current branch.
.TP
-git pull \-s ours \&. obsolete
-Merge local branch obsolete into the current branch, using ours merge strategy\&.
-
-.TP
-git pull \&. fixes enhancements
-Bundle local branch fixes and enhancements on top of the current branch, making an Octopus merge\&.
-
-.TP
-git pull \-\-no\-commit \&. maint
-Merge local branch maint into the current branch, but do not make a commit automatically\&. This can be used when you want to include further changes to the merge, or want to write your own merge commit message\&.
-
-You should refrain from abusing this option to sneak substantial changes into a merge commit\&. Small fixups like bumping release/version name would be acceptable\&.
-
+git pull \-s ours . obsolete
+Merge local branch
+obsolete
+into the current branch, using
+ours
+merge strategy.
+.TP
+git pull . fixes enhancements
+Bundle local branch
+fixes
+and
+enhancements
+on top of the current branch, making an Octopus merge.
+.TP
+git pull \-\-no\-commit . maint
+Merge local branch
+maint
+into the current branch, but do not make a commit automatically. This can be used when you want to include further changes to the merge, or want to write your own merge commit message.
+.sp
+You should refrain from abusing this option to sneak substantial changes into a merge commit. Small fixups like bumping release/version name would be acceptable.
.TP
Command line pull of multiple branches from one repository
-
+.sp
.nf
-$ cat \&.git/remotes/origin
-URL: git://git\&.kernel\&.org/pub/scm/git/git\&.git
+$ cat .git/remotes/origin
+URL: git://git.kernel.org/pub/scm/git/git.git
Pull: master:origin
$ git checkout master
$ git fetch origin master:origin +pu:pu maint:maint
-$ git pull \&. origin
+$ git pull . origin
.fi
-Here, a typical \&.git/remotes/origin file from a git\-clone operation is used in combination with command line options to git\-fetch to first update multiple branches of the local repository and then to merge the remote origin branch into the local master branch\&. The local pu branch is updated even if it does not result in a fast forward update\&. Here, the pull can obtain its objects from the local repository using \&., as the previous git\-fetch is known to have already obtained and made available all the necessary objects\&.
-
-.TP
-Pull of multiple branches from one repository using \&.git/remotes file
-
+Here, a typical
+.git/remotes/origin
+file from a
+git\-clone
+operation is used in combination with command line options to
+git\-fetch
+to first update multiple branches of the local repository and then to merge the remote
+origin
+branch into the local
+master
+branch. The local
+pu
+branch is updated even if it does not result in a fast forward update. Here, the pull can obtain its objects from the local repository using
+., as the previous
+git\-fetch
+is known to have already obtained and made available all the necessary objects.
+.TP
+Pull of multiple branches from one repository using .git/remotes file
+.sp
.nf
-$ cat \&.git/remotes/origin
-URL: git://git\&.kernel\&.org/pub/scm/git/git\&.git
+$ cat .git/remotes/origin
+URL: git://git.kernel.org/pub/scm/git/git.git
Pull: master:origin
Pull: +pu:pu
Pull: maint:maint
$ git checkout master
$ git pull origin
.fi
-Here, a typical \&.git/remotes/origin file from a git\-clone operation has been hand\-modified to include the branch\-mapping of additional remote and local heads directly\&. A single git\-pull operation while in the master branch will fetch multiple heads and merge the remote origin head into the current, local master branch\&.
-
-
-If you tried a pull which resulted in a complex conflicts and would want to start over, you can recover with \fBgit\-reset\fR(1)\&.
-
+Here, a typical
+.git/remotes/origin
+file from a
+git\-clone
+operation has been hand\-modified to include the branch\-mapping of additional remote and local heads directly. A single
+git\-pull
+operation while in the
+master
+branch will fetch multiple heads and merge the remote
+origin
+head into the current, local
+master
+branch.
+If you tried a pull which resulted in a complex conflicts and would want to start over, you can recover with \fBgit\-reset\fR(1).
+.sp
.SH "SEE ALSO"
-
-
\fBgit\-fetch\fR(1), \fBgit\-merge\fR(1)
-
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org> and Junio C Hamano <junkio@cox\&.net>
-
+Written by Linus Torvalds <torvalds@osdl.org> and Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Jon Loeliger, David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Jon Loeliger, David Greaves, Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-PUSH" 1 "" "" ""
-.SH NAME
-git-push \- Update remote refs along with associated objects
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-push \- Update remote refs along with associated objects
.SH "SYNOPSIS"
-
-
-\fIgit\-push\fR [\-\-all] [\-\-tags] [\-f | \-\-force] <repository> <refspec>...
-
+\fIgit\-push\fR [\-\-all] [\-\-tags] [\-f | \-\-force] <repository> <refspec>\&...
+.sp
.SH "DESCRIPTION"
-
-
-Updates remote refs using local refs, while sending objects necessary to complete the given refs\&.
-
-
-You can make interesting things happen to a repository every time you push into it, by setting up \fIhooks\fR there\&. See documentation for \fBgit\-receive\-pack\fR(1)\&.
-
+Updates remote refs using local refs, while sending objects necessary to complete the given refs.
+.sp
+You can make interesting things happen to a repository every time you push into it, by setting up \fIhooks\fR there. See documentation for \fBgit\-receive\-pack\fR(1).
+.sp
.SH "OPTIONS"
-
.TP
<repository>
-The "remote" repository that is destination of a push operation\&. See the section GIT URLS below\&.
-
+The "remote" repository that is destination of a push operation. See the section
+GIT URLS
+below.
.TP
<refspec>
-The canonical format of a <refspec> parameter is +?<src>:<dst>; that is, an optional plus +, followed by the source ref, followed by a colon :, followed by the destination ref\&.
-
-The <src> side can be an arbitrary "SHA1 expression" that can be used as an argument to git\-cat\-file \-t\&. E\&.g\&. master~4 (push four parents before the current master head)\&.
-
-The local ref that matches <src> is used to fast forward the remote ref that matches <dst>\&. If the optional plus + is used, the remote ref is updated even if it does not result in a fast forward update\&.
-
-Note: If no explicit refspec is found, (that is neither on the command line nor in any Push line of the corresponding remotes file\-\-\-see below), then all the refs that exist both on the local side and on the remote side are updated\&.
-
-Some short\-cut notations are also supported\&.
-
+The canonical format of a <refspec> parameter is
++?<src>:<dst>; that is, an optional plus
++, followed by the source ref, followed by a colon
+:, followed by the destination ref.
+.sp
+The <src> side can be an arbitrary "SHA1 expression" that can be used as an argument to
+git\-cat\-file \-t. E.g.
+master~4
+(push four parents before the current master head).
+.sp
+The local ref that matches <src> is used to fast forward the remote ref that matches <dst>. If the optional plus
++
+is used, the remote ref is updated even if it does not result in a fast forward update.
+.sp
+Note: If no explicit refspec is found, (that is neither on the command line nor in any Push line of the corresponding remotes file\-\-\-see below), then all the refs that exist both on the local side and on the remote side are updated.
+.sp
+Some short\-cut notations are also supported.
.RS
.TP 3
\(bu
- tag <tag> means the same as refs/tags/<tag>:refs/tags/<tag>\&.
+tag <tag>
+means the same as
+refs/tags/<tag>:refs/tags/<tag>.
.TP
\(bu
-A parameter <ref> without a colon is equivalent to <ref>:<ref>, hence updates <ref> in the destination from <ref> in the source\&.
-.LP
+A parameter <ref> without a colon is equivalent to <ref>:<ref>, hence updates <ref> in the destination from <ref> in the source.
.RE
-.IP
-
.TP
\-\-all
-Instead of naming each ref to push, specifies that all refs be pushed\&.
-
+Instead of naming each ref to push, specifies that all refs be pushed.
.TP
\-\-tags
-All refs under $GIT_DIR/refs/tags are pushed, in addition to refspecs explicitly listed on the command line\&.
-
+All refs under
+$GIT_DIR/refs/tags
+are pushed, in addition to refspecs explicitly listed on the command line.
.TP
\-f, \-\-force
-Usually, the command refuses to update a remote ref that is not a descendant of the local ref used to overwrite it\&. This flag disables the check\&. This can cause the remote repository to lose commits; use it with care\&.
-
+Usually, the command refuses to update a remote ref that is not a descendant of the local ref used to overwrite it. This flag disables the check. This can cause the remote repository to lose commits; use it with care.
.SH "GIT URLS"
-
-
One of the following notations can be used to name the remote repository:
-
+.sp
.IP
-
.TP 3
\(bu
-rsync://host\&.xz/path/to/repo\&.git/
+rsync://host.xz/path/to/repo.git/
.TP
\(bu
-http://host\&.xz/path/to/repo\&.git/
+http://host.xz/path/to/repo.git/
.TP
\(bu
-https://host\&.xz/path/to/repo\&.git/
+https://host.xz/path/to/repo.git/
.TP
\(bu
-git://host\&.xz/path/to/repo\&.git/
+git://host.xz/path/to/repo.git/
.TP
\(bu
-git://host\&.xz/~user/path/to/repo\&.git/
+git://host.xz/~user/path/to/repo.git/
.TP
\(bu
-ssh://[user@]host\&.xz/path/to/repo\&.git/
+ssh://[user@]host.xz/path/to/repo.git/
.TP
\(bu
-ssh://[user@]host\&.xz/~user/path/to/repo\&.git/
+ssh://[user@]host.xz/~user/path/to/repo.git/
.TP
\(bu
-ssh://[user@]host\&.xz/~/path/to/repo\&.git
-.LP
-
-
-SSH is the default transport protocol\&. You can optionally specify which user to log\-in as, and an alternate, scp\-like syntax is also supported\&. Both syntaxes support username expansion, as does the native git protocol\&. The following three are identical to the last three above, respectively:
-
+ssh://[user@]host.xz/~/path/to/repo.git
+SSH is the default transport protocol. You can optionally specify which user to log\-in as, and an alternate, scp\-like syntax is also supported. Both syntaxes support username expansion, as does the native git protocol. The following three are identical to the last three above, respectively:
+.sp
.IP
-
.TP 3
\(bu
-[user@]host\&.xz:/path/to/repo\&.git/
+[user@]host.xz:/path/to/repo.git/
.TP
\(bu
-[user@]host\&.xz:~user/path/to/repo\&.git/
+[user@]host.xz:~user/path/to/repo.git/
.TP
\(bu
-[user@]host\&.xz:path/to/repo\&.git
-.LP
-
-
+[user@]host.xz:path/to/repo.git
To sync with a local directory, use:
-
+.sp
.IP
-
.TP 3
\(bu
-/path/to/repo\&.git/
-.LP
-
+/path/to/repo.git/
.SH "REMOTES"
-
-
In addition to the above, as a short\-hand, the name of a file in $GIT_DIR/remotes directory can be given; the named file should be in the following format:
-
+.sp
+.sp
.nf
URL: one of the above URL format
Push: <refspec>
Pull: <refspec>
.fi
-
-
-Then such a short\-hand is specified in place of <repository> without <refspec> parameters on the command line, <refspec> specified on Push: lines or Pull: lines are used for git\-push and git\-fetch/git\-pull, respectively\&. Multiple Push: and Pull: lines may be specified for additional branch mappings\&.
-
-
-The name of a file in $GIT_DIR/branches directory can be specified as an older notation short\-hand; the named file should contain a single line, a URL in one of the above formats, optionally followed by a hash # and the name of remote head (URL fragment notation)\&. $GIT_DIR/branches/<remote> file that stores a <url> without the fragment is equivalent to have this in the corresponding file in the $GIT_DIR/remotes/ directory\&.
-
+Then such a short\-hand is specified in place of <repository> without <refspec> parameters on the command line, <refspec> specified on Push: lines or Pull: lines are used for git\-push and git\-fetch/git\-pull, respectively. Multiple Push: and Pull: lines may be specified for additional branch mappings.
+.sp
+The name of a file in $GIT_DIR/branches directory can be specified as an older notation short\-hand; the named file should contain a single line, a URL in one of the above formats, optionally followed by a hash # and the name of remote head (URL fragment notation). $GIT_DIR/branches/<remote> file that stores a <url> without the fragment is equivalent to have this in the corresponding file in the $GIT_DIR/remotes/ directory.
+.sp
+.sp
.nf
URL: <url>
Pull: refs/heads/master:<remote>
.fi
-
-
while having <url>#<head> is equivalent to
-
+.sp
+.sp
.nf
URL: <url>
Pull: refs/heads/<head>:<remote>
.fi
-
.SH "AUTHOR"
-
-
-Written by Junio C Hamano <junkio@cox\&.net>
-
+Written by Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-QUILTIMPORT" 1 "" "" ""
-.SH NAME
-git-quiltimport \- Applies a quilt patchset onto the current branch
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-quiltimport \- Applies a quilt patchset onto the current branch
.SH "SYNOPSIS"
-
+.sp
.nf
\fIgit\-quiltimport\fR [\-\-dry\-run] [\-\-author <author>] [\-\-patches <dir>]
.fi
-
.SH "DESCRIPTION"
-
-
-Applies a quilt patchset onto the current git branch, preserving the patch boundaries, patch order, and patch descriptions present in the quilt patchset\&.
-
-
-For each patch the code attempts to extract the author from the patch description\&. If that fails it falls back to the author specified with \-\-author\&. If the \-\-author flag was not given the patch description is displayed and the user is asked to interactively enter the author of the patch\&.
-
-
-If a subject is not found in the patch description the patch name is preserved as the 1 line subject in the git description\&.
-
+Applies a quilt patchset onto the current git branch, preserving the patch boundaries, patch order, and patch descriptions present in the quilt patchset.
+.sp
+For each patch the code attempts to extract the author from the patch description. If that fails it falls back to the author specified with \-\-author. If the \-\-author flag was not given the patch description is displayed and the user is asked to interactively enter the author of the patch.
+.sp
+If a subject is not found in the patch description the patch name is preserved as the 1 line subject in the git description.
+.sp
.SH "OPTIONS"
-
.TP
\-\-dry\-run
-Walk through the patches in the series and warn if we cannot find all of the necessary information to commit a patch\&. At the time of this writing only missing author information is warned about\&.
-
+Walk through the patches in the series and warn if we cannot find all of the necessary information to commit a patch. At the time of this writing only missing author information is warned about.
.TP
\-\-author Author Name <Author Email>
-The author name and email address to use when no author information can be found in the patch description\&.
-
+The author name and email address to use when no author information can be found in the patch description.
.TP
\-\-patches <dir>
-The directory to find the quilt patches and the quilt series file\&.
-
+The directory to find the quilt patches and the quilt series file.
+.sp
.nf
The default for the patch directory is patches
or the value of the $QUILT_PATCHES environment
-variable\&.
+variable.
.fi
-
.SH "AUTHOR"
-
-
-Written by Eric Biederman <ebiederm@lnxi\&.com>
-
+Written by Eric Biederman <ebiederm@lnxi.com>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Eric Biederman <ebiederm@lnxi\&.com>
-
+Documentation by Eric Biederman <ebiederm@lnxi.com>
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-READ-TREE" 1 "" "" ""
-.SH NAME
-git-read-tree \- Reads tree information into the index
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-read\-tree \- Reads tree information into the index
.SH "SYNOPSIS"
-
-
\fIgit\-read\-tree\fR (<tree\-ish> | [[\-m [\-\-aggressive] | \-\-reset | \-\-prefix=<prefix>] [\-u | \-i]] <tree\-ish1> [<tree\-ish2> [<tree\-ish3>]])
-
+.sp
.SH "DESCRIPTION"
-
-
-Reads the tree information given by <tree\-ish> into the index, but does not actually \fIupdate\fR any of the files it "caches"\&. (see: \fBgit\-checkout\-index\fR(1))
-
-
-Optionally, it can merge a tree into the index, perform a fast\-forward (i\&.e\&. 2\-way) merge, or a 3\-way merge, with the \-m flag\&. When used with \-m, the \-u flag causes it to also update the files in the work tree with the result of the merge\&.
-
-
-Trivial merges are done by git\-read\-tree itself\&. Only conflicting paths will be in unmerged state when git\-read\-tree returns\&.
-
+Reads the tree information given by <tree\-ish> into the index, but does not actually \fBupdate\fR any of the files it "caches". (see: \fBgit\-checkout\-index\fR(1))
+.sp
+Optionally, it can merge a tree into the index, perform a fast\-forward (i.e. 2\-way) merge, or a 3\-way merge, with the \-m flag. When used with \-m, the \-u flag causes it to also update the files in the work tree with the result of the merge.
+.sp
+Trivial merges are done by git\-read\-tree itself. Only conflicting paths will be in unmerged state when git\-read\-tree returns.
+.sp
.SH "OPTIONS"
-
.TP
\-m
-Perform a merge, not just a read\&. The command will refuse to run if your index file has unmerged entries, indicating that you have not finished previous merge you started\&.
-
+Perform a merge, not just a read. The command will refuse to run if your index file has unmerged entries, indicating that you have not finished previous merge you started.
.TP
\-\-reset
-Same as \-m, except that unmerged entries are discarded instead of failing\&.
-
+Same as \-m, except that unmerged entries are discarded instead of failing.
.TP
\-u
-After a successful merge, update the files in the work tree with the result of the merge\&.
-
+After a successful merge, update the files in the work tree with the result of the merge.
.TP
\-i
-Usually a merge requires the index file as well as the files in the working tree are up to date with the current head commit, in order not to lose local changes\&. This flag disables the check with the working tree and is meant to be used when creating a merge of trees that are not directly related to the current working tree status into a temporary index file\&.
-
+Usually a merge requires the index file as well as the files in the working tree are up to date with the current head commit, in order not to lose local changes. This flag disables the check with the working tree and is meant to be used when creating a merge of trees that are not directly related to the current working tree status into a temporary index file.
.TP
\-\-aggressive
-Usually a three\-way merge by git\-read\-tree resolves the merge for really trivial cases and leaves other cases unresolved in the index, so that Porcelains can implement different merge policies\&. This flag makes the command to resolve a few more cases internally:
-
+Usually a three\-way merge by
+git\-read\-tree
+resolves the merge for really trivial cases and leaves other cases unresolved in the index, so that Porcelains can implement different merge policies. This flag makes the command to resolve a few more cases internally:
.RS
.TP 3
\(bu
-when one side removes a path and the other side leaves the path unmodified\&. The resolution is to remove that path\&.
+when one side removes a path and the other side leaves the path unmodified. The resolution is to remove that path.
.TP
\(bu
-when both sides remove a path\&. The resolution is to remove that path\&.
+when both sides remove a path. The resolution is to remove that path.
.TP
\(bu
-when both sides adds a path identically\&. The resolution is to add that path\&.
-.LP
+when both sides adds a path identically. The resolution is to add that path.
.RE
-.IP
-
.TP
\-\-prefix=<prefix>/
-Keep the current index contents, and read the contents of named tree\-ish under directory at <prefix>\&. The original index file cannot have anything at the path <prefix> itself, and have nothing in <prefix>/ directory\&. Note that the <prefix>/ value must end with a slash\&.
-
+Keep the current index contents, and read the contents of named tree\-ish under directory at
+<prefix>. The original index file cannot have anything at the path
+<prefix>
+itself, and have nothing in
+<prefix>/
+directory. Note that the
+<prefix>/
+value must end with a slash.
.TP
<tree\-ish#>
-The id of the tree object(s) to be read/merged\&.
-
+The id of the tree object(s) to be read/merged.
.SH "MERGING"
-
-
-If \-m is specified, git\-read\-tree can perform 3 kinds of merge, a single tree merge if only 1 tree is given, a fast\-forward merge with 2 trees, or a 3\-way merge if 3 trees are provided\&.
-
+If \-m is specified, git\-read\-tree can perform 3 kinds of merge, a single tree merge if only 1 tree is given, a fast\-forward merge with 2 trees, or a 3\-way merge if 3 trees are provided.
+.sp
.SS "Single Tree Merge"
-
-
-If only 1 tree is specified, git\-read\-tree operates as if the user did not specify \-m, except that if the original index has an entry for a given pathname, and the contents of the path matches with the tree being read, the stat info from the index is used\&. (In other words, the index's stat()s take precedence over the merged tree's)\&.
-
-
-That means that if you do a git\-read\-tree \-m <newtree> followed by a git\-checkout\-index \-f \-u \-a, the git\-checkout\-index only checks out the stuff that really changed\&.
-
-
-This is used to avoid unnecessary false hits when git\-diff\-files is run after git\-read\-tree\&.
-
+If only 1 tree is specified, git\-read\-tree operates as if the user did not specify \-m, except that if the original index has an entry for a given pathname, and the contents of the path matches with the tree being read, the stat info from the index is used. (In other words, the index's stat()s take precedence over the merged tree's).
+.sp
+That means that if you do a git\-read\-tree \-m <newtree> followed by a git\-checkout\-index \-f \-u \-a, the git\-checkout\-index only checks out the stuff that really changed.
+.sp
+This is used to avoid unnecessary false hits when git\-diff\-files is run after git\-read\-tree.
+.sp
.SS "Two Tree Merge"
-
-
-Typically, this is invoked as git\-read\-tree \-m $H $M, where $H is the head commit of the current repository, and $M is the head of a foreign tree, which is simply ahead of $H (i\&.e\&. we are in a fast forward situation)\&.
-
-
+Typically, this is invoked as git\-read\-tree \-m $H $M, where $H is the head commit of the current repository, and $M is the head of a foreign tree, which is simply ahead of $H (i.e. we are in a fast forward situation).
+.sp
When two trees are specified, the user is telling git\-read\-tree the following:
-
+.sp
.TP 3
1.
The current index and work tree is derived from $H, but the user may have local changes in them since $H;
.TP
2.
-The user wants to fast\-forward to $M\&.
-.LP
-
-
-In this case, the git\-read\-tree \-m $H $M command makes sure that no local change is lost as the result of this "merge"\&. Here are the "carry forward" rules:
-
+The user wants to fast\-forward to $M.
+In this case, the git\-read\-tree \-m $H $M command makes sure that no local change is lost as the result of this "merge". Here are the "carry forward" rules:
+.sp
+.sp
.nf
I (index) H M Result
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
2 nothing exists nothing remove path from index
3 nothing exists exists use M
.fi
-
+.sp
.nf
clean I==H I==M
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
4 yes N/A N/A nothing nothing keep index
5 no N/A N/A nothing nothing keep index
.fi
-
+.sp
.nf
6 yes N/A yes nothing exists keep index
7 no N/A yes nothing exists keep index
8 yes N/A no nothing exists fail
9 no N/A no nothing exists fail
.fi
-
+.sp
.nf
10 yes yes N/A exists nothing remove path from index
11 no yes N/A exists nothing fail
12 yes no N/A exists nothing fail
13 no no N/A exists nothing fail
.fi
-
+.sp
.nf
clean (H=M)
\-\-\-\-\-\-
14 yes exists exists keep index
15 no exists exists keep index
.fi
-
+.sp
.nf
clean I==H I==M (H!=M)
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
20 yes yes no exists exists use M
21 no yes no exists exists fail
.fi
-
-
-In all "keep index" cases, the index entry stays as in the original index file\&. If the entry were not up to date, git\-read\-tree keeps the copy in the work tree intact when operating under the \-u flag\&.
-
-
-When this form of git\-read\-tree returns successfully, you can see what "local changes" you made are carried forward by running git\-diff\-index \-\-cached $M\&. Note that this does not necessarily match git\-diff\-index \-\-cached $H would have produced before such a two tree merge\&. This is because of cases 18 and 19 \-\-\- if you already had the changes in $M (e\&.g\&. maybe you picked it up via e\-mail in a patch form), git\-diff\-index \-\-cached $H would have told you about the change before this merge, but it would not show in git\-diff\-index \-\-cached $M output after two\-tree merge\&.
-
-.SS "3-Way Merge"
-
-
-Each "index" entry has two bits worth of "stage" state\&. stage 0 is the normal one, and is the only one you'd see in any kind of normal use\&.
-
-
-However, when you do git\-read\-tree with three trees, the "stage" starts out at 1\&.
-
-
+In all "keep index" cases, the index entry stays as in the original index file. If the entry were not up to date, git\-read\-tree keeps the copy in the work tree intact when operating under the \-u flag.
+.sp
+When this form of git\-read\-tree returns successfully, you can see what "local changes" you made are carried forward by running git\-diff\-index \-\-cached $M. Note that this does not necessarily match git\-diff\-index \-\-cached $H would have produced before such a two tree merge. This is because of cases 18 and 19 \-\-\- if you already had the changes in $M (e.g. maybe you picked it up via e\-mail in a patch form), git\-diff\-index \-\-cached $H would have told you about the change before this merge, but it would not show in git\-diff\-index \-\-cached $M output after two\-tree merge.
+.sp
+.SS "3\-Way Merge"
+Each "index" entry has two bits worth of "stage" state. stage 0 is the normal one, and is the only one you'd see in any kind of normal use.
+.sp
+However, when you do git\-read\-tree with three trees, the "stage" starts out at 1.
+.sp
This means that you can do
-
+.sp
+.sp
.nf
$ git\-read\-tree \-m <tree1> <tree2> <tree3>
.fi
-
-
-and you will end up with an index with all of the <tree1> entries in "stage1", all of the <tree2> entries in "stage2" and all of the <tree3> entries in "stage3"\&. When performing a merge of another branch into the current branch, we use the common ancestor tree as <tree1>, the current branch head as <tree2>, and the other branch head as <tree3>\&.
-
-
+and you will end up with an index with all of the <tree1> entries in "stage1", all of the <tree2> entries in "stage2" and all of the <tree3> entries in "stage3". When performing a merge of another branch into the current branch, we use the common ancestor tree as <tree1>, the current branch head as <tree2>, and the other branch head as <tree3>.
+.sp
Furthermore, git\-read\-tree has special\-case logic that says: if you see a file that matches in all respects in the following states, it "collapses" back to "stage0":
-
+.sp
.TP 3
\(bu
stage 2 and 3 are the same; take one or the other (it makes no difference \- the same work has been done on our branch in stage 2 and their branch in stage 3)
.TP
\(bu
stage 1 and stage 3 are the same and stage 2 is different take stage 2 (we did something while they did nothing)
-.LP
-
-
-The git\-write\-tree command refuses to write a nonsensical tree, and it will complain about unmerged entries if it sees a single entry that is not stage 0\&.
-
-
-OK, this all sounds like a collection of totally nonsensical rules, but it's actually exactly what you want in order to do a fast merge\&. The different stages represent the "result tree" (stage 0, aka "merged"), the original tree (stage 1, aka "orig"), and the two trees you are trying to merge (stage 2 and 3 respectively)\&.
-
-
-The order of stages 1, 2 and 3 (hence the order of three <tree\-ish> command line arguments) are significant when you start a 3\-way merge with an index file that is already populated\&. Here is an outline of how the algorithm works:
-
+The git\-write\-tree command refuses to write a nonsensical tree, and it will complain about unmerged entries if it sees a single entry that is not stage 0.
+.sp
+OK, this all sounds like a collection of totally nonsensical rules, but it's actually exactly what you want in order to do a fast merge. The different stages represent the "result tree" (stage 0, aka "merged"), the original tree (stage 1, aka "orig"), and the two trees you are trying to merge (stage 2 and 3 respectively).
+.sp
+The order of stages 1, 2 and 3 (hence the order of three <tree\-ish> command line arguments) are significant when you start a 3\-way merge with an index file that is already populated. Here is an outline of how the algorithm works:
+.sp
.TP 3
\(bu
-if a file exists in identical format in all three trees, it will automatically collapse to "merged" state by git\-read\-tree\&.
+if a file exists in identical format in all three trees, it will automatically collapse to "merged" state by git\-read\-tree.
.TP
\(bu
-a file that has _any_ difference what\-so\-ever in the three trees will stay as separate entries in the index\&. It's up to "porcelain policy" to determine how to remove the non\-0 stages, and insert a merged version\&.
+a file that has _any_ difference what\-so\-ever in the three trees will stay as separate entries in the index. It's up to "porcelain policy" to determine how to remove the non\-0 stages, and insert a merged version.
.TP
\(bu
-the index file saves and restores with all this information, so you can merge things incrementally, but as long as it has entries in stages 1/2/3 (i\&.e\&., "unmerged entries") you can't write the result\&. So now the merge algorithm ends up being really simple:
-
+the index file saves and restores with all this information, so you can merge things incrementally, but as long as it has entries in stages 1/2/3 (i.e., "unmerged entries") you can't write the result. So now the merge algorithm ends up being really simple:
.RS
.TP 3
\(bu
-you walk the index in order, and ignore all entries of stage 0, since they've already been done\&.
+you walk the index in order, and ignore all entries of stage 0, since they've already been done.
.TP
\(bu
-if you find a "stage1", but no matching "stage2" or "stage3", you know it's been removed from both trees (it only existed in the original tree), and you remove that entry\&.
+if you find a "stage1", but no matching "stage2" or "stage3", you know it's been removed from both trees (it only existed in the original tree), and you remove that entry.
.TP
\(bu
-if you find a matching "stage2" and "stage3" tree, you remove one of them, and turn the other into a "stage0" entry\&. Remove any matching "stage1" entry if it exists too\&. \&.\&. all the normal trivial rules \&.\&.
-.LP
+if you find a matching "stage2" and "stage3" tree, you remove one of them, and turn the other into a "stage0" entry. Remove any matching "stage1" entry if it exists too. .. all the normal trivial rules ..
.RE
-.IP
-.LP
-
-
-You would normally use git\-merge\-index with supplied git\-merge\-one\-file to do this last step\&. The script updates the files in the working tree as it merges each path and at the end of a successful merge\&.
-
-
-When you start a 3\-way merge with an index file that is already populated, it is assumed that it represents the state of the files in your work tree, and you can even have files with changes unrecorded in the index file\&. It is further assumed that this state is "derived" from the stage 2 tree\&. The 3\-way merge refuses to run if it finds an entry in the original index file that does not match stage 2\&.
-
-
-This is done to prevent you from losing your work\-in\-progress changes, and mixing your random changes in an unrelated merge commit\&. To illustrate, suppose you start from what has been committed last to your repository:
-
+You would normally use git\-merge\-index with supplied git\-merge\-one\-file to do this last step. The script updates the files in the working tree as it merges each path and at the end of a successful merge.
+.sp
+When you start a 3\-way merge with an index file that is already populated, it is assumed that it represents the state of the files in your work tree, and you can even have files with changes unrecorded in the index file. It is further assumed that this state is "derived" from the stage 2 tree. The 3\-way merge refuses to run if it finds an entry in the original index file that does not match stage 2.
+.sp
+This is done to prevent you from losing your work\-in\-progress changes, and mixing your random changes in an unrelated merge commit. To illustrate, suppose you start from what has been committed last to your repository:
+.sp
+.sp
.nf
$ JC=`git\-rev\-parse \-\-verify "HEAD^0"`
$ git\-checkout\-index \-f \-u \-a $JC
.fi
-
-
-You do random edits, without running git\-update\-index\&. And then you notice that the tip of your "upstream" tree has advanced since you pulled from him:
-
+You do random edits, without running git\-update\-index. And then you notice that the tip of your "upstream" tree has advanced since you pulled from him:
+.sp
+.sp
.nf
-$ git\-fetch git://\&.\&.\&.\&. linus
-$ LT=`cat \&.git/FETCH_HEAD`
+$ git\-fetch git://.... linus
+$ LT=`cat .git/FETCH_HEAD`
.fi
-
-
-Your work tree is still based on your HEAD ($JC), but you have some edits since\&. Three\-way merge makes sure that you have not added or modified index entries since $JC, and if you haven't, then does the right thing\&. So with the following sequence:
-
+Your work tree is still based on your HEAD ($JC), but you have some edits since. Three\-way merge makes sure that you have not added or modified index entries since $JC, and if you haven't, then does the right thing. So with the following sequence:
+.sp
+.sp
.nf
$ git\-read\-tree \-m \-u `git\-merge\-base $JC $LT` $JC $LT
$ git\-merge\-index git\-merge\-one\-file \-a
$ echo "Merge with Linus" | \\
git\-commit\-tree `git\-write\-tree` \-p $JC \-p $LT
.fi
-
-
-what you would commit is a pure merge between $JC and $LT without your work\-in\-progress changes, and your work tree would be updated to the result of the merge\&.
-
-
-However, if you have local changes in the working tree that would be overwritten by this merge,git\-read\-tree will refuse to run to prevent your changes from being lost\&.
-
-
-In other words, there is no need to worry about what exists only in the working tree\&. When you have local changes in a part of the project that is not involved in the merge, your changes do not interfere with the merge, and are kept intact\&. When they \fIdo\fR interfere, the merge does not even start (git\-read\-tree complains loudly and fails without modifying anything)\&. In such a case, you can simply continue doing what you were in the middle of doing, and when your working tree is ready (i\&.e\&. you have finished your work\-in\-progress), attempt the merge again\&.
-
+what you would commit is a pure merge between $JC and $LT without your work\-in\-progress changes, and your work tree would be updated to the result of the merge.
+.sp
+However, if you have local changes in the working tree that would be overwritten by this merge,git\-read\-tree will refuse to run to prevent your changes from being lost.
+.sp
+In other words, there is no need to worry about what exists only in the working tree. When you have local changes in a part of the project that is not involved in the merge, your changes do not interfere with the merge, and are kept intact. When they \fBdo\fR interfere, the merge does not even start (git\-read\-tree complains loudly and fails without modifying anything). In such a case, you can simply continue doing what you were in the middle of doing, and when your working tree is ready (i.e. you have finished your work\-in\-progress), attempt the merge again.
+.sp
.SH "SEE ALSO"
-
-
\fBgit\-write\-tree\fR(1); \fBgit\-ls\-files\fR(1)
-
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+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>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-REBASE" 1 "" "" ""
-.SH NAME
-git-rebase \- Rebase local commits to a new head
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-rebase \- Rebase local commits to a new head
.SH "SYNOPSIS"
-
-
\fIgit\-rebase\fR [\-\-merge] [\-\-onto <newbase>] <upstream> [<branch>]
-
-
+.sp
\fIgit\-rebase\fR \-\-continue | \-\-skip | \-\-abort
-
+.sp
.SH "DESCRIPTION"
-
-
-git\-rebase replaces <branch> with a new branch of the same name\&. When the \-\-onto option is provided the new branch starts out with a HEAD equal to <newbase>, otherwise it is equal to <upstream>\&. It then attempts to create a new commit for each commit from the original <branch> that does not exist in the <upstream> branch\&.
-
-
-It is possible that a merge failure will prevent this process from being completely automatic\&. You will have to resolve any such merge failure and run git rebase \-\-continue\&. Another option is to bypass the commit that caused the merge failure with git rebase \-\-skip\&. To restore the original <branch> and remove the \&.dotest working files, use the command git rebase \-\-abort instead\&.
-
-
-Note that if <branch> is not specified on the command line, the currently checked out branch is used\&.
-
-
+git\-rebase replaces <branch> with a new branch of the same name. When the \-\-onto option is provided the new branch starts out with a HEAD equal to <newbase>, otherwise it is equal to <upstream>. It then attempts to create a new commit for each commit from the original <branch> that does not exist in the <upstream> branch.
+.sp
+It is possible that a merge failure will prevent this process from being completely automatic. You will have to resolve any such merge failure and run git rebase \-\-continue. Another option is to bypass the commit that caused the merge failure with git rebase \-\-skip. To restore the original <branch> and remove the .dotest working files, use the command git rebase \-\-abort instead.
+.sp
+Note that if <branch> is not specified on the command line, the currently checked out branch is used.
+.sp
Assume the following history exists and the current branch is "topic":
-
+.sp
+.sp
.nf
A\-\-\-B\-\-\-C topic
/
D\-\-\-E\-\-\-F\-\-\-G master
.fi
-
-
From this point, the result of either of the following commands:
-
+.sp
+.sp
.nf
git\-rebase master
git\-rebase master topic
.fi
-
-
would be:
-
+.sp
+.sp
.nf
A'\-\-B'\-\-C' topic
/
D\-\-\-E\-\-\-F\-\-\-G master
.fi
-
-
While, starting from the same point, the result of either of the following commands:
-
+.sp
+.sp
.nf
git\-rebase \-\-onto master~1 master
git\-rebase \-\-onto master~1 master topic
.fi
-
-
would be:
-
+.sp
+.sp
.nf
A'\-\-B'\-\-C' topic
/
D\-\-\-E\-\-\-F\-\-\-G master
.fi
-
-
-In case of conflict, git\-rebase will stop at the first problematic commit and leave conflict markers in the tree\&. You can use git diff to locate the markers (<<<<<<) and make edits to resolve the conflict\&. For each file you edit, you need to tell git that the conflict has been resolved, typically this would be done with
-
+In case of conflict, git\-rebase will stop at the first problematic commit and leave conflict markers in the tree. You can use git diff to locate the markers (<<<<<<) and make edits to resolve the conflict. For each file you edit, you need to tell git that the conflict has been resolved, typically this would be done with
+.sp
+.sp
.nf
git update\-index <filename>
.fi
-
-
After resolving the conflict manually and updating the index with the desired resolution, you can continue the rebasing process with
-
+.sp
+.sp
.nf
git rebase \-\-continue
.fi
-
-
Alternatively, you can undo the git\-rebase with
-
+.sp
+.sp
.nf
git rebase \-\-abort
.fi
-
.SH "OPTIONS"
-
.TP
<newbase>
-Starting point at which to create the new commits\&. If the \-\-onto option is not specified, the starting point is <upstream>\&.
-
+Starting point at which to create the new commits. If the \-\-onto option is not specified, the starting point is <upstream>.
.TP
<upstream>
-Upstream branch to compare against\&.
-
+Upstream branch to compare against.
.TP
<branch>
-Working branch; defaults to HEAD\&.
-
+Working branch; defaults to HEAD.
.TP
\-\-continue
-Restart the rebasing process after having resolved a merge conflict\&.
-
+Restart the rebasing process after having resolved a merge conflict.
.TP
\-\-abort
-Restore the original branch and abort the rebase operation\&.
-
+Restore the original branch and abort the rebase operation.
.TP
\-\-skip
-Restart the rebasing process by skipping the current patch\&.
-
+Restart the rebasing process by skipping the current patch.
.TP
\-\-merge
-Use merging strategies to rebase\&. When the recursive (default) merge strategy is used, this allows rebase to be aware of renames on the upstream side\&.
-
+Use merging strategies to rebase. When the recursive (default) merge strategy is used, this allows rebase to be aware of renames on the upstream side.
.TP
\-s <strategy>, \-\-strategy=<strategy>
-Use the given merge strategy; can be supplied more than once to specify them in the order they should be tried\&. If there is no \-s option, a built\-in list of strategies is used instead (git\-merge\-recursive when merging a single head, git\-merge\-octopus otherwise)\&. This implies \-\-merge\&.
-
+Use the given merge strategy; can be supplied more than once to specify them in the order they should be tried. If there is no
+\-s
+option, a built\-in list of strategies is used instead (git\-merge\-recursive
+when merging a single head,
+git\-merge\-octopus
+otherwise). This implies \-\-merge.
.SH "MERGE STRATEGIES"
-
.TP
resolve
-This can only resolve two heads (i\&.e\&. the current branch and another branch you pulled from) using 3\-way merge algorithm\&. It tries to carefully detect criss\-cross merge ambiguities and is considered generally safe and fast\&.
-
+This can only resolve two heads (i.e. the current branch and another branch you pulled from) using 3\-way merge algorithm. It tries to carefully detect criss\-cross merge ambiguities and is considered generally safe and fast.
.TP
recursive
-This can only resolve two heads using 3\-way merge algorithm\&. When there are more than one common ancestors that can be used for 3\-way merge, it creates a merged tree of the common ancestors and uses that as the reference tree for the 3\-way merge\&. This has been reported to result in fewer merge conflicts without causing mis\-merges by tests done on actual merge commits taken from Linux 2\&.6 kernel development history\&. Additionally this can detect and handle merges involving renames\&. This is the default merge strategy when pulling or merging one branch\&.
-
+This can only resolve two heads using 3\-way merge algorithm. When there are more than one common ancestors that can be used for 3\-way merge, it creates a merged tree of the common ancestors and uses that as the reference tree for the 3\-way merge. This has been reported to result in fewer merge conflicts without causing mis\-merges by tests done on actual merge commits taken from Linux 2.6 kernel development history. Additionally this can detect and handle merges involving renames. This is the default merge strategy when pulling or merging one branch.
.TP
octopus
-This resolves more than two\-head case, but refuses to do complex merge that needs manual resolution\&. It is primarily meant to be used for bundling topic branch heads together\&. This is the default merge strategy when pulling or merging more than one branches\&.
-
+This resolves more than two\-head case, but refuses to do complex merge that needs manual resolution. It is primarily meant to be used for bundling topic branch heads together. This is the default merge strategy when pulling or merging more than one branches.
.TP
ours
-This resolves any number of heads, but the result of the merge is always the current branch head\&. It is meant to be used to supersede old development history of side branches\&.
-
+This resolves any number of heads, but the result of the merge is always the current branch head. It is meant to be used to supersede old development history of side branches.
.SH "NOTES"
-
-
-When you rebase a branch, you are changing its history in a way that will cause problems for anyone who already has a copy of the branch in their repository and tries to pull updates from you\&. You should understand the implications of using \fIgit rebase\fR on a repository that you share\&.
-
-
-When the git rebase command is run, it will first execute a "pre\-rebase" hook if one exists\&. You can use this hook to do sanity checks and reject the rebase if it isn't appropriate\&. Please see the template pre\-rebase hook script for an example\&.
-
-
-You must be in the top directory of your project to start (or continue) a rebase\&. Upon completion, <branch> will be the current branch\&.
-
+When you rebase a branch, you are changing its history in a way that will cause problems for anyone who already has a copy of the branch in their repository and tries to pull updates from you. You should understand the implications of using \fIgit rebase\fR on a repository that you share.
+.sp
+When the git rebase command is run, it will first execute a "pre\-rebase" hook if one exists. You can use this hook to do sanity checks and reject the rebase if it isn't appropriate. Please see the template pre\-rebase hook script for an example.
+.sp
+You must be in the top directory of your project to start (or continue) a rebase. Upon completion, <branch> will be the current branch.
+.sp
.SH "AUTHOR"
-
-
-Written by Junio C Hamano <junkio@cox\&.net>
-
+Written by Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+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\-RECEIVE\-PACK" "1" "09/21/2006" "" ""
+.TH "GIT\-RECEIVE\-PACK" "1" "10/03/2006" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-RELINK" 1 "" "" ""
-.SH NAME
-git-relink \- Hardlink common objects in local repositories
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+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\&.
-
+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
-Stops if two objects with the same hash exist but have different sizes\&. Default is to warn and continue\&.
-
+Stops if two objects with the same hash exist but have different sizes. Default is to warn and continue.
.TP
<dir>
-Directories containing a \&.git/objects/ subdirectory\&.
-
+Directories containing a .git/objects/ subdirectory.
.SH "AUTHOR"
-
-
-Written by Ryan Anderson <ryan@michonline\&.com>
-
+Written by Ryan Anderson <ryan@michonline.com>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+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\-REPACK" "1" "09/18/2006" "" ""
+.TH "GIT\-REPACK" "1" "10/03/2006" "" ""
.\" 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" "10/01/2006" "" ""
+.TH "GIT\-REPO\-CONFIG" "1" "10/03/2006" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-REQUEST-PULL" 1 "" "" ""
-.SH NAME
-git-request-pull \- Generates a summary of pending changes
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+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\&.
-
+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 start at\&.
-
+Commit to start at.
.TP
<url>
-URL to include in the summary\&.
-
+URL to include in the summary.
.TP
<end>
-Commit to send at; defaults to HEAD\&.
-
+Commit to send at; defaults to HEAD.
.SH "AUTHOR"
-
-
-Written by Ryan Anderson <ryan@michonline\&.com> and Junio C Hamano <junkio@cox\&.net>
-
+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>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-RERERE" 1 "" "" ""
-.SH NAME
-git-rerere \- Reuse recorded resolve
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-rerere \- Reuse recorded resolve
.SH "SYNOPSIS"
-
-
\fIgit\-rerere\fR
-
+.sp
.SH "DESCRIPTION"
-
-
-In a workflow that employs relatively long lived topic branches, the developer sometimes needs to resolve the same conflict over and over again until the topic branches are done (either merged to the "release" branch, or sent out and accepted upstream)\&.
-
-
-This command helps this process by recording conflicted automerge results and corresponding hand\-resolve results on the initial manual merge, and later by noticing the same automerge results and applying the previously recorded hand resolution\&.
-
-.RS
-.Sh "Note"
-
-
-You need to create $GIT_DIR/rr\-cache directory to enable this command\&.
-
-.RE
-
+In a workflow that employs relatively long lived topic branches, the developer sometimes needs to resolve the same conflict over and over again until the topic branches are done (either merged to the "release" branch, or sent out and accepted upstream).
+.sp
+This command helps this process by recording conflicted automerge results and corresponding hand\-resolve results on the initial manual merge, and later by noticing the same automerge results and applying the previously recorded hand resolution.
+.sp
+.sp
+.it 1 an-trap
+.nr an-no-space-flag 1
+.nr an-break-flag 1
+.br
+\fBNote\fR
+You need to create $GIT_DIR/rr\-cache directory to enable this command.
+.sp
.SH "DISCUSSION"
-
-
When your topic branch modifies overlapping area that your master branch (or upstream) touched since your topic branch forked from it, you may want to test it with the latest master, even before your topic branch is ready to be pushed upstream:
-
+.sp
+.sp
.nf
o\-\-\-*\-\-\-o topic
/
o\-\-\-o\-\-\-o\-\-\-*\-\-\-o\-\-\-o master
.fi
-
-
-For such a test, you need to merge master and topic somehow\&. One way to do it is to pull master into the topic branch:
-
+For such a test, you need to merge master and topic somehow. One way to do it is to pull master into the topic branch:
+.sp
+.sp
.nf
$ git checkout topic
- $ git pull \&. master
+ $ git pull . master
o\-\-\-*\-\-\-o\-\-\-+ topic
/ /
o\-\-\-o\-\-\-o\-\-\-*\-\-\-o\-\-\-o master
.fi
-
-
-The commits marked with * touch the same area in the same file; you need to resolve the conflicts when creating the commit marked with +\&. Then you can test the result to make sure your work\-in\-progress still works with what is in the latest master\&.
-
-
-After this test merge, there are two ways to continue your work on the topic\&. The easiest is to build on top of the test merge commit +, and when your work in the topic branch is finally ready, pull the topic branch into master, and/or ask the upstream to pull from you\&. By that time, however, the master or the upstream might have been advanced since the test merge +, in which case the final commit graph would look like this:
-
+The commits marked with * touch the same area in the same file; you need to resolve the conflicts when creating the commit marked with +. Then you can test the result to make sure your work\-in\-progress still works with what is in the latest master.
+.sp
+After this test merge, there are two ways to continue your work on the topic. The easiest is to build on top of the test merge commit +, and when your work in the topic branch is finally ready, pull the topic branch into master, and/or ask the upstream to pull from you. By that time, however, the master or the upstream might have been advanced since the test merge +, in which case the final commit graph would look like this:
+.sp
+.sp
.nf
$ git checkout topic
- $ git pull \&. master
- $ \&.\&.\&. work on both topic and master branches
+ $ git pull . master
+ $ ... work on both topic and master branches
$ git checkout master
- $ git pull \&. topic
+ $ git pull . topic
o\-\-\-*\-\-\-o\-\-\-+\-\-\-o\-\-\-o topic
/ / \\
o\-\-\-o\-\-\-o\-\-\-*\-\-\-o\-\-\-o\-\-\-o\-\-\-o\-\-\-+ master
.fi
-
-
-When your topic branch is long\-lived, however, your topic branch would end up having many such "Merge from master" commits on it, which would unnecessarily clutter the development history\&. Readers of the Linux kernel mailing list may remember that Linus complained about such too frequent test merges when a subsystem maintainer asked to pull from a branch full of "useless merges"\&.
-
-
+When your topic branch is long\-lived, however, your topic branch would end up having many such "Merge from master" commits on it, which would unnecessarily clutter the development history. Readers of the Linux kernel mailing list may remember that Linus complained about such too frequent test merges when a subsystem maintainer asked to pull from a branch full of "useless merges".
+.sp
As an alternative, to keep the topic branch clean of test merges, you could blow away the test merge, and keep building on top of the tip before the test merge:
-
+.sp
+.sp
.nf
$ git checkout topic
- $ git pull \&. master
+ $ git pull . master
$ git reset \-\-hard HEAD^ ;# rewind the test merge
- $ \&.\&.\&. work on both topic and master branches
+ $ ... work on both topic and master branches
$ git checkout master
- $ git pull \&. topic
+ $ git pull . topic
o\-\-\-*\-\-\-o\-\-\-\-\-\-\-o\-\-\-o topic
/ \\
o\-\-\-o\-\-\-o\-\-\-*\-\-\-o\-\-\-o\-\-\-o\-\-\-o\-\-\-+ master
.fi
-
-
-This would leave only one merge commit when your topic branch is finally ready and merged into the master branch\&. This merge would require you to resolve the conflict, introduced by the commits marked with *\&. However, often this conflict is the same conflict you resolved when you created the test merge you blew away\&. git\-rerere command helps you to resolve this final conflicted merge using the information from your earlier hand resolve\&.
-
-
-Running git\-rerere command immediately after a conflicted automerge records the conflicted working tree files, with the usual conflict markers <<<<<<<, =======, and >>>>>>> in them\&. Later, after you are done resolving the conflicts, running git\-rerere again records the resolved state of these files\&. Suppose you did this when you created the test merge of master into the topic branch\&.
-
-
-Next time, running git\-rerere after seeing a conflicted automerge, if the conflict is the same as the earlier one recorded, it is noticed and a three\-way merge between the earlier conflicted automerge, the earlier manual resolution, and the current conflicted automerge is performed by the command\&. If this three\-way merge resolves cleanly, the result is written out to your working tree file, so you would not have to manually resolve it\&. Note that git\-rerere leaves the index file alone, so you still need to do the final sanity checks with git diff (or git diff \-c) and git update\-index when you are satisfied\&.
-
-
-As a convenience measure, git\-merge automatically invokes git\-rerere when it exits with a failed automerge, which records it if it is a new conflict, or reuses the earlier hand resolve when it is not\&. git\-commit also invokes git\-rerere when recording a merge result\&. What this means is that you do not have to do anything special yourself (Note: you still have to create $GIT_DIR/rr\-cache directory to enable this command)\&.
-
-
-In our example, when you did the test merge, the manual resolution is recorded, and it will be reused when you do the actual merge later with updated master and topic branch, as long as the earlier resolution is still applicable\&.
-
-
-The information git\-rerere records is also used when running git\-rebase\&. After blowing away the test merge and continuing development on the topic branch:
-
+This would leave only one merge commit when your topic branch is finally ready and merged into the master branch. This merge would require you to resolve the conflict, introduced by the commits marked with *. However, often this conflict is the same conflict you resolved when you created the test merge you blew away. git\-rerere command helps you to resolve this final conflicted merge using the information from your earlier hand resolve.
+.sp
+Running git\-rerere command immediately after a conflicted automerge records the conflicted working tree files, with the usual conflict markers <<<<<<<, =======, and >>>>>>> in them. Later, after you are done resolving the conflicts, running git\-rerere again records the resolved state of these files. Suppose you did this when you created the test merge of master into the topic branch.
+.sp
+Next time, running git\-rerere after seeing a conflicted automerge, if the conflict is the same as the earlier one recorded, it is noticed and a three\-way merge between the earlier conflicted automerge, the earlier manual resolution, and the current conflicted automerge is performed by the command. If this three\-way merge resolves cleanly, the result is written out to your working tree file, so you would not have to manually resolve it. Note that git\-rerere leaves the index file alone, so you still need to do the final sanity checks with git diff (or git diff \-c) and git update\-index when you are satisfied.
+.sp
+As a convenience measure, git\-merge automatically invokes git\-rerere when it exits with a failed automerge, which records it if it is a new conflict, or reuses the earlier hand resolve when it is not. git\-commit also invokes git\-rerere when recording a merge result. What this means is that you do not have to do anything special yourself (Note: you still have to create $GIT_DIR/rr\-cache directory to enable this command).
+.sp
+In our example, when you did the test merge, the manual resolution is recorded, and it will be reused when you do the actual merge later with updated master and topic branch, as long as the earlier resolution is still applicable.
+.sp
+The information git\-rerere records is also used when running git\-rebase. After blowing away the test merge and continuing development on the topic branch:
+.sp
+.sp
.nf
o\-\-\-*\-\-\-o\-\-\-\-\-\-\-o\-\-\-o topic
/
/
o\-\-\-o\-\-\-o\-\-\-*\-\-\-o\-\-\-o\-\-\-o\-\-\-o master
.fi
-
-
-you could run git rebase master topic, to keep yourself up\-to\-date even before your topic is ready to be sent upstream\&. This would result in falling back to three\-way merge, and it would conflict the same way the test merge you resolved earlier\&. git\-rerere is run by git rebase to help you resolve this conflict\&.
-
+you could run git rebase master topic, to keep yourself up\-to\-date even before your topic is ready to be sent upstream. This would result in falling back to three\-way merge, and it would conflict the same way the test merge you resolved earlier. git\-rerere is run by git rebase to help you resolve this conflict.
+.sp
.SH "AUTHOR"
-
-
-Written by Junio C Hamano <junkio@cox\&.net>
-
+Written by Junio C Hamano <junkio@cox.net>
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-RESET" 1 "" "" ""
-.SH NAME
-git-reset \- Reset current HEAD to the specified state
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-reset \- Reset current HEAD to the specified state
.SH "SYNOPSIS"
-
-
\fIgit\-reset\fR [\-\-mixed | \-\-soft | \-\-hard] [<commit\-ish>]
-
+.sp
.SH "DESCRIPTION"
-
-
-Sets the current head to the specified commit and optionally resets the index and working tree to match\&.
-
-
-This command is useful if you notice some small error in a recent commit (or set of commits) and want to redo that part without showing the undo in the history\&.
-
-
-If you want to undo a commit other than the latest on a branch, \fBgit\-revert\fR(1) is your friend\&.
-
+Sets the current head to the specified commit and optionally resets the index and working tree to match.
+.sp
+This command is useful if you notice some small error in a recent commit (or set of commits) and want to redo that part without showing the undo in the history.
+.sp
+If you want to undo a commit other than the latest on a branch, \fBgit\-revert\fR(1) is your friend.
+.sp
.SH "OPTIONS"
-
.TP
\-\-mixed
-Resets the index but not the working tree (i\&.e\&., the changed files are preserved but not marked for commit) and reports what has not been updated\&. This is the default action\&.
-
+Resets the index but not the working tree (i.e., the changed files are preserved but not marked for commit) and reports what has not been updated. This is the default action.
.TP
\-\-soft
-Does not touch the index file nor the working tree at all, but requires them to be in a good order\&. This leaves all your changed files "Updated but not checked in", as \fBgit\-status\fR(1) would put it\&.
-
+Does not touch the index file nor the working tree at all, but requires them to be in a good order. This leaves all your changed files "Updated but not checked in", as
+\fBgit\-status\fR(1)
+would put it.
.TP
\-\-hard
-Matches the working tree and index to that of the tree being switched to\&. Any changes to tracked files in the working tree since <commit\-ish> are lost\&.
-
+Matches the working tree and index to that of the tree being switched to. Any changes to tracked files in the working tree since <commit\-ish> are lost.
.TP
<commit\-ish>
-Commit to make the current HEAD\&.
-
+Commit to make the current HEAD.
.SH "EXAMPLES"
-
.TP
Undo a commit and redo
-
+.sp
.nf
-$ git commit \&.\&.\&.
+$ git commit ...
$ git reset \-\-soft HEAD^ \fB(1)\fR
$ edit \fB(2)\fR
$ git commit \-a \-c ORIG_HEAD \fB(3)\fR
.fi
.sp
-\fB1. \fRThis is most often done when you remembered what you just committed is incomplete, or you misspelled your commit message, or both\&. Leaves working tree as it was before "reset"\&.
+\fB1. \fRThis is most often done when you remembered what you just committed is incomplete, or you misspelled your commit message, or both. Leaves working tree as it was before "reset".
.br
-\fB2. \fRmake corrections to working tree files\&.
+\fB2. \fRmake corrections to working tree files.
.br
-\fB3. \fR"reset" copies the old head to \&.git/ORIG_HEAD; redo the commit by starting with its log message\&. If you do not need to edit the message further, you can give \-C option instead\&.
+\fB3. \fR"reset" copies the old head to .git/ORIG_HEAD; redo the commit by starting with its log message. If you do not need to edit the message further, you can give \-C option instead.
.br
-
-
.TP
Undo commits permanently
-
+.sp
.nf
-$ git commit \&.\&.\&.
+$ git commit ...
$ git reset \-\-hard HEAD~3 \fB(1)\fR
.fi
.sp
-\fB1. \fRThe last three commits (HEAD, HEAD^, and HEAD~2) were bad and you do not want to ever see them again\&. Do \fInot\fR do this if you have already given these commits to somebody else\&.
+\fB1. \fRThe last three commits (HEAD, HEAD^, and HEAD~2) were bad and you do not want to ever see them again. Do
+\fBnot\fR
+do this if you have already given these commits to somebody else.
.br
-
-
.TP
Undo a commit, making it a topic branch
-
+.sp
.nf
$ git branch topic/wip \fB(1)\fR
$ git reset \-\-hard HEAD~3 \fB(2)\fR
$ git checkout topic/wip \fB(3)\fR
.fi
.sp
-\fB1. \fRYou have made some commits, but realize they were premature to be in the "master" branch\&. You want to continue polishing them in a topic branch, so create "topic/wip" branch off of the current HEAD\&.
+\fB1. \fRYou have made some commits, but realize they were premature to be in the "master" branch. You want to continue polishing them in a topic branch, so create "topic/wip" branch off of the current HEAD.
.br
-\fB2. \fRRewind the master branch to get rid of those three commits\&.
+\fB2. \fRRewind the master branch to get rid of those three commits.
.br
-\fB3. \fRSwitch to "topic/wip" branch and keep working\&.
+\fB3. \fRSwitch to "topic/wip" branch and keep working.
.br
-
-
.TP
Undo update\-index
-
+.sp
.nf
$ edit \fB(1)\fR
-$ git\-update\-index frotz\&.c filfre\&.c
+$ git\-update\-index frotz.c filfre.c
$ mailx \fB(2)\fR
$ git reset \fB(3)\fR
-$ git pull git://info\&.example\&.com/ nitfol \fB(4)\fR
+$ git pull git://info.example.com/ nitfol \fB(4)\fR
.fi
.sp
-\fB1. \fRyou are happily working on something, and find the changes in these files are in good order\&. You do not want to see them when you run "git diff", because you plan to work on other files and changes with these files are distracting\&.
+\fB1. \fRyou are happily working on something, and find the changes in these files are in good order. You do not want to see them when you run "git diff", because you plan to work on other files and changes with these files are distracting.
.br
-\fB2. \fRsomebody asks you to pull, and the changes sounds worthy of merging\&.
+\fB2. \fRsomebody asks you to pull, and the changes sounds worthy of merging.
.br
-\fB3. \fRhowever, you already dirtied the index (i\&.e\&. your index does not match the HEAD commit)\&. But you know the pull you are going to make does not affect frotz\&.c nor filfre\&.c, so you revert the index changes for these two files\&. Your changes in working tree remain there\&.
+\fB3. \fRhowever, you already dirtied the index (i.e. your index does not match the HEAD commit). But you know the pull you are going to make does not affect frotz.c nor filfre.c, so you revert the index changes for these two files. Your changes in working tree remain there.
.br
-\fB4. \fRthen you can pull and merge, leaving frotz\&.c and filfre\&.c changes still in the working tree\&.
+\fB4. \fRthen you can pull and merge, leaving frotz.c and filfre.c changes still in the working tree.
.br
-
-
.TP
Undo a merge or pull
-
+.sp
.nf
$ git pull \fB(1)\fR
-Trying really trivial in\-index merge\&.\&.\&.
+Trying really trivial in\-index merge...
fatal: Merge requires file\-level merging
-Nope\&.
-\&.\&.\&.
+Nope.
+...
Auto\-merging nitfol
CONFLICT (content): Merge conflict in nitfol
Automatic merge failed/prevented; fix up by hand
$ git reset \-\-hard \fB(2)\fR
-$ git pull \&. topic/branch \fB(3)\fR
-Updating from 41223\&.\&.\&. to 13134\&.\&.\&.
+$ git pull . topic/branch \fB(3)\fR
+Updating from 41223... to 13134...
Fast forward
$ git reset \-\-hard ORIG_HEAD \fB(4)\fR
.fi
.sp
-\fB1. \fRtry to update from the upstream resulted in a lot of conflicts; you were not ready to spend a lot of time merging right now, so you decide to do that later\&.
+\fB1. \fRtry to update from the upstream resulted in a lot of conflicts; you were not ready to spend a lot of time merging right now, so you decide to do that later.
.br
-\fB2. \fR"pull" has not made merge commit, so "git reset \-\-hard" which is a synonym for "git reset \-\-hard HEAD" clears the mess from the index file and the working tree\&.
+\fB2. \fR"pull" has not made merge commit, so "git reset \-\-hard" which is a synonym for "git reset \-\-hard HEAD" clears the mess from the index file and the working tree.
.br
-\fB3. \fRmerge a topic branch into the current branch, which resulted in a fast forward\&.
+\fB3. \fRmerge a topic branch into the current branch, which resulted in a fast forward.
.br
-\fB4. \fRbut you decided that the topic branch is not ready for public consumption yet\&. "pull" or "merge" always leaves the original tip of the current branch in ORIG_HEAD, so resetting hard to it brings your index file and the working tree back to that state, and resets the tip of the branch to that commit\&.
+\fB4. \fRbut you decided that the topic branch is not ready for public consumption yet. "pull" or "merge" always leaves the original tip of the current branch in ORIG_HEAD, so resetting hard to it brings your index file and the working tree back to that state, and resets the tip of the branch to that commit.
.br
-
-
.TP
Interrupted workflow
-Suppose you are interrupted by an urgent fix request while you are in the middle of a large change\&. The files in your working tree are not in any shape to be committed yet, but you need to get to the other branch for a quick bugfix\&.
-
+Suppose you are interrupted by an urgent fix request while you are in the middle of a large change. The files in your working tree are not in any shape to be committed yet, but you need to get to the other branch for a quick bugfix.
+.sp
.nf
$ git checkout feature ;# you were working in "feature" branch and
$ work work work ;# got interrupted
$ git reset \fB(3)\fR
.fi
.sp
-\fB1. \fRThis commit will get blown away so a throw\-away log message is OK\&.
+\fB1. \fRThis commit will get blown away so a throw\-away log message is OK.
.br
-\fB2. \fRThis removes the \fIWIP\fR commit from the commit history, and sets your working tree to the state just before you made that snapshot\&.
+\fB2. \fRThis removes the
+\fIWIP\fR
+commit from the commit history, and sets your working tree to the state just before you made that snapshot.
.br
-\fB3. \fRAt this point the index file still has all the WIP changes you committed as \fIsnapshot WIP\fR\&. This updates the index to show your WIP files as uncommitted\&.
+\fB3. \fRAt this point the index file still has all the WIP changes you committed as
+\fIsnapshot WIP\fR. This updates the index to show your WIP files as uncommitted.
.br
-
-
.SH "AUTHOR"
-
-
-Written by Junio C Hamano <junkio@cox\&.net> and Linus Torvalds <torvalds@osdl\&.org>
-
+Written by Junio C Hamano <junkio@cox.net> and Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-RESOLVE" 1 "" "" ""
-.SH NAME
-git-resolve \- Merge two commits
+.\" ** You probably do not want to edit this file directly **
+.\" 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\-RESOLVE" "1" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-resolve \- Merge two commits
.SH "SYNOPSIS"
-
-
\fIgit\-resolve\fR <current> <merged> <message>
-
+.sp
.SH "DESCRIPTION"
-
-
-Given two commits and a merge message, merge the <merged> commit into <current> commit, with the commit log message <message>\&.
-
-
-When <current> is a descendant of <merged>, or <current> is an ancestor of <merged>, no new commit is created and the <message> is ignored\&. The former is informally called "already up to date", and the latter is often called "fast forward"\&.
-
+Given two commits and a merge message, merge the <merged> commit into <current> commit, with the commit log message <message>.
+.sp
+When <current> is a descendant of <merged>, or <current> is an ancestor of <merged>, no new commit is created and the <message> is ignored. The former is informally called "already up to date", and the latter is often called "fast forward".
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org> and Dan Holmsand <holmsand@gmail\&.com>\&.
-
+Written by Linus Torvalds <torvalds@osdl.org> and Dan Holmsand <holmsand@gmail.com>.
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+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\-REV\-LIST" "1" "09/25/2006" "" ""
+.TH "GIT\-REV\-LIST" "1" "10/03/2006" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-REV-PARSE" 1 "" "" ""
-.SH NAME
-git-rev-parse \- Pick out and massage parameters
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-rev\-parse \- Pick out and massage parameters
.SH "SYNOPSIS"
-
-
-\fIgit\-rev\-parse\fR [ \-\-option ] <args>...
-
+\fIgit\-rev\-parse\fR [ \-\-option ] <args>\&...
+.sp
.SH "DESCRIPTION"
-
-
-Many git porcelainish commands take mixture of flags (i\&.e\&. parameters that begin with a dash \fI\-\fR) and parameters meant for underlying git\-rev\-list command they use internally and flags and parameters for other commands they use as the downstream of git\-rev\-list\&. This command is used to distinguish between them\&.
-
+Many git porcelainish commands take mixture of flags (i.e. parameters that begin with a dash \fI\-\fR) and parameters meant for underlying git\-rev\-list command they use internally and flags and parameters for other commands they use as the downstream of git\-rev\-list. This command is used to distinguish between them.
+.sp
.SH "OPTIONS"
-
.TP
\-\-revs\-only
-Do not output flags and parameters not meant for git\-rev\-list command\&.
-
+Do not output flags and parameters not meant for
+git\-rev\-list
+command.
.TP
\-\-no\-revs
-Do not output flags and parameters meant for git\-rev\-list command\&.
-
+Do not output flags and parameters meant for
+git\-rev\-list
+command.
.TP
\-\-flags
-Do not output non\-flag parameters\&.
-
+Do not output non\-flag parameters.
.TP
\-\-no\-flags
-Do not output flag parameters\&.
-
+Do not output flag parameters.
.TP
\-\-default <arg>
-If there is no parameter given by the user, use <arg> instead\&.
-
+If there is no parameter given by the user, use
+<arg>
+instead.
.TP
\-\-verify
-The parameter given must be usable as a single, valid object name\&. Otherwise barf and abort\&.
-
+The parameter given must be usable as a single, valid object name. Otherwise barf and abort.
.TP
\-\-sq
-Usually the output is made one line per flag and parameter\&. This option makes output a single line, properly quoted for consumption by shell\&. Useful when you expect your parameter to contain whitespaces and newlines (e\&.g\&. when using pickaxe \-S with git\-diff\-*)\&.
-
+Usually the output is made one line per flag and parameter. This option makes output a single line, properly quoted for consumption by shell. Useful when you expect your parameter to contain whitespaces and newlines (e.g. when using pickaxe
+\-S
+with
+git\-diff\-*).
.TP
\-\-not
-When showing object names, prefix them with \fI^\fR and strip \fI^\fR prefix from the object names that already have one\&.
-
+When showing object names, prefix them with
+\fI^\fR
+and strip
+\fI^\fR
+prefix from the object names that already have one.
.TP
\-\-symbolic
-Usually the object names are output in SHA1 form (with possible \fI^\fR prefix); this option makes them output in a form as close to the original input as possible\&.
-
+Usually the object names are output in SHA1 form (with possible
+\fI^\fR
+prefix); this option makes them output in a form as close to the original input as possible.
.TP
\-\-all
-Show all refs found in $GIT_DIR/refs\&.
-
+Show all refs found in
+$GIT_DIR/refs.
.TP
\-\-branches
-Show branch refs found in $GIT_DIR/refs/heads\&.
-
+Show branch refs found in
+$GIT_DIR/refs/heads.
.TP
\-\-tags
-Show tag refs found in $GIT_DIR/refs/tags\&.
-
+Show tag refs found in
+$GIT_DIR/refs/tags.
.TP
\-\-remotes
-Show tag refs found in $GIT_DIR/refs/remotes\&.
-
+Show tag refs found in
+$GIT_DIR/refs/remotes.
.TP
\-\-show\-prefix
-When the command is invoked from a subdirectory, show the path of the current directory relative to the top\-level directory\&.
-
+When the command is invoked from a subdirectory, show the path of the current directory relative to the top\-level directory.
.TP
\-\-show\-cdup
-When the command is invoked from a subdirectory, show the path of the top\-level directory relative to the current directory (typically a sequence of "\&.\&./", or an empty string)\&.
-
+When the command is invoked from a subdirectory, show the path of the top\-level directory relative to the current directory (typically a sequence of "../", or an empty string).
.TP
\-\-git\-dir
-Show $GIT_DIR if defined else show the path to the \&.git directory\&.
-
+Show
+$GIT_DIR
+if defined else show the path to the .git directory.
.TP
\-\-short, \-\-short=number
-Instead of outputting the full SHA1 values of object names try to abbreviate them to a shorter unique name\&. When no length is specified 7 is used\&. The minimum length is 4\&.
-
+Instead of outputting the full SHA1 values of object names try to abbreviate them to a shorter unique name. When no length is specified 7 is used. The minimum length is 4.
.TP
\-\-since=datestring, \-\-after=datestring
-Parses the date string, and outputs corresponding \-\-max\-age= parameter for git\-rev\-list command\&.
-
+Parses the date string, and outputs corresponding \-\-max\-age= parameter for git\-rev\-list command.
.TP
\-\-until=datestring, \-\-before=datestring
-Parses the date string, and outputs corresponding \-\-min\-age= parameter for git\-rev\-list command\&.
-
+Parses the date string, and outputs corresponding \-\-min\-age= parameter for git\-rev\-list command.
.TP
-<args>...
-Flags and parameters to be parsed\&.
-
+<args>\&...
+Flags and parameters to be parsed.
.SH "SPECIFYING REVISIONS"
-
-
-A revision parameter typically, but not necessarily, names a commit object\&. They use what is called an \fIextended SHA1\fR syntax\&.
-
+A revision parameter typically, but not necessarily, names a commit object. They use what is called an \fIextended SHA1\fR syntax.
+.sp
.TP 3
\(bu
-The full SHA1 object name (40\-byte hexadecimal string), or a substring of such that is unique within the repository\&. E\&.g\&. dae86e1950b1277e545cee180551750029cfe735 and dae86e both name the same commit object if there are no other object in your repository whose object name starts with dae86e\&.
+The full SHA1 object name (40\-byte hexadecimal string), or a substring of such that is unique within the repository. E.g. dae86e1950b1277e545cee180551750029cfe735 and dae86e both name the same commit object if there are no other object in your repository whose object name starts with dae86e.
.TP
\(bu
-A symbolic ref name\&. E\&.g\&. \fImaster\fR typically means the commit object referenced by $GIT_DIR/refs/heads/master\&. If you happen to have both heads/master and tags/master, you can explicitly say \fIheads/master\fR to tell git which one you mean\&.
+A symbolic ref name. E.g.
+\fImaster\fR
+typically means the commit object referenced by $GIT_DIR/refs/heads/master. If you happen to have both heads/master and tags/master, you can explicitly say
+\fIheads/master\fR
+to tell git which one you mean.
.TP
\(bu
-A suffix \fI@\fR followed by a date specification enclosed in a brace pair (e\&.g\&. \fI{yesterday}\fR, \fI{1 month 2 weeks 3 days 1 hour 1 second ago}\fR or \fI{1979\-02\-26 18:30:00}\fR) to specify the value of the ref at a prior point in time\&. This suffix may only be used immediately following a ref name and the ref must have an existing log ($GIT_DIR/logs/<ref>)\&.
+A suffix
+\fI@\fR
+followed by a date specification enclosed in a brace pair (e.g.
+\fI{yesterday}\fR,
+\fI{1 month 2 weeks 3 days 1 hour 1 second ago}\fR
+or
+\fI{1979\-02\-26 18:30:00}\fR) to specify the value of the ref at a prior point in time. This suffix may only be used immediately following a ref name and the ref must have an existing log ($GIT_DIR/logs/<ref>).
.TP
\(bu
-A suffix \fI^\fR to a revision parameter means the first parent of that commit object\&. \fI^<n>\fR means the <n>th parent (i\&.e\&. \fIrev^\fR is equivalent to \fIrev^1\fR)\&. As a special rule, \fIrev^0\fR means the commit itself and is used when \fIrev\fR is the object name of a tag object that refers to a commit object\&.
+A suffix
+\fI^\fR
+to a revision parameter means the first parent of that commit object.
+\fI^<n>\fR
+means the <n>th parent (i.e.
+\fIrev^\fR
+is equivalent to
+\fIrev^1\fR). As a special rule,
+\fIrev^0\fR
+means the commit itself and is used when
+\fIrev\fR
+is the object name of a tag object that refers to a commit object.
.TP
\(bu
-A suffix \fI~<n>\fR to a revision parameter means the commit object that is the <n>th generation grand\-parent of the named commit object, following only the first parent\&. I\&.e\&. rev~3 is equivalent to rev^^^ which is equivalent to rev^1^1^1\&.
+A suffix
+\fI~<n>\fR
+to a revision parameter means the commit object that is the <n>th generation grand\-parent of the named commit object, following only the first parent. I.e. rev~3 is equivalent to rev^^^ which is equivalent to rev^1^1^1.
.TP
\(bu
-A suffix \fI^\fR followed by an object type name enclosed in brace pair (e\&.g\&. v0\&.99\&.8^{commit}) means the object could be a tag, and dereference the tag recursively until an object of that type is found or the object cannot be dereferenced anymore (in which case, barf)\&. rev^0 introduced earlier is a short\-hand for rev^{commit}\&.
+A suffix
+\fI^\fR
+followed by an object type name enclosed in brace pair (e.g.
+v0.99.8^{commit}) means the object could be a tag, and dereference the tag recursively until an object of that type is found or the object cannot be dereferenced anymore (in which case, barf).
+rev^0
+introduced earlier is a short\-hand for
+rev^{commit}.
.TP
\(bu
-A suffix \fI^\fR followed by an empty brace pair (e\&.g\&. v0\&.99\&.8^{}) means the object could be a tag, and dereference the tag recursively until a non\-tag object is found\&.
-.LP
-
-
-Here is an illustration, by Jon Loeliger\&. Both node B and C are a commit parents of commit node A\&. Parent commits are ordered left\-to\-right\&.
-
+A suffix
+\fI^\fR
+followed by an empty brace pair (e.g.
+v0.99.8^{}) means the object could be a tag, and dereference the tag recursively until a non\-tag object is found.
+Here is an illustration, by Jon Loeliger. Both node B and C are a commit parents of commit node A. Parent commits are ordered left\-to\-right.
+.sp
+.sp
.nf
G H I J
\\ / \\ /
\\ /
A
.fi
-
+.sp
.nf
A = = A^0
B = A^ = A^1 = A~1
I = F^ = B^3^ = A^^3^
J = F^2 = B^3^2 = A^^3^2
.fi
-
.SH "SPECIFYING RANGES"
-
-
-History traversing commands such as git\-log operate on a set of commits, not just a single commit\&. To these commands, specifying a single revision with the notation described in the previous section means the set of commits reachable from that commit, following the commit ancestry chain\&.
-
-
-To exclude commits reachable from a commit, a prefix ^ notation is used\&. E\&.g\&. "^r1 r2" means commits reachable from r2 but exclude the ones reachable from r1\&.
-
-
-This set operation appears so often that there is a shorthand for it\&. "r1\&.\&.r2" is equivalent to "^r1 r2"\&. It is the difference of two sets (subtract the set of commits reachable from r1 from the set of commits reachable from r2)\&.
-
-
-A similar notation "r1\&.\&.\&.r2" is called symmetric difference of r1 and r2 and is defined as "r1 r2 \-\-not $(git\-merge\-base \-\-all r1 r2)"\&. It it the set of commits that are reachable from either one of r1 or r2 but not from both\&.
-
-
+History traversing commands such as git\-log operate on a set of commits, not just a single commit. To these commands, specifying a single revision with the notation described in the previous section means the set of commits reachable from that commit, following the commit ancestry chain.
+.sp
+To exclude commits reachable from a commit, a prefix ^ notation is used. E.g. "^r1 r2" means commits reachable from r2 but exclude the ones reachable from r1.
+.sp
+This set operation appears so often that there is a shorthand for it. "r1..r2" is equivalent to "^r1 r2". It is the difference of two sets (subtract the set of commits reachable from r1 from the set of commits reachable from r2).
+.sp
+A similar notation "r1...r2" is called symmetric difference of r1 and r2 and is defined as "r1 r2 \-\-not $(git\-merge\-base \-\-all r1 r2)". It it the set of commits that are reachable from either one of r1 or r2 but not from both.
+.sp
Here are a few examples:
-
+.sp
+.sp
.nf
D A B D
D F A B C D F
^A G B D
^A F B C F
-G\&.\&.\&.I C D F G I
+G...I C D F G I
^B G I C D F G I
.fi
-
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org> and Junio C Hamano <junkio@cox\&.net>
-
+Written by Linus Torvalds <torvalds@osdl.org> and Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-REVERT" 1 "" "" ""
-.SH NAME
-git-revert \- Revert an existing commit
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-revert \- Revert an existing commit
.SH "SYNOPSIS"
-
-
\fIgit\-revert\fR [\-\-edit | \-\-no\-edit] [\-n] <commit>
-
+.sp
.SH "DESCRIPTION"
-
-
-Given one existing commit, revert the change the patch introduces, and record a new commit that records it\&. This requires your working tree to be clean (no modifications from the HEAD commit)\&.
-
+Given one existing commit, revert the change the patch introduces, and record a new commit that records it. This requires your working tree to be clean (no modifications from the HEAD commit).
+.sp
.SH "OPTIONS"
-
.TP
<commit>
-Commit to revert\&.
-
+Commit to revert.
.TP
\-e|\-\-edit
-With this option, git\-revert will let you edit the commit message prior committing the revert\&. This is the default if you run the command from a terminal\&.
-
+With this option,
+git\-revert
+will let you edit the commit message prior committing the revert. This is the default if you run the command from a terminal.
.TP
\-\-no\-edit
-With this option, git\-revert will not start the commit message editor\&.
-
+With this option,
+git\-revert
+will not start the commit message editor.
.TP
\-n|\-\-no\-commit
-Usually the command automatically creates a commit with a commit log message stating which commit was reverted\&. This flag applies the change necessary to revert the named commit to your working tree, but does not make the commit\&. In addition, when this option is used, your working tree does not have to match the HEAD commit\&. The revert is done against the beginning state of your working tree\&.
-
-This is useful when reverting more than one commits' effect to your working tree in a row\&.
-
+Usually the command automatically creates a commit with a commit log message stating which commit was reverted. This flag applies the change necessary to revert the named commit to your working tree, but does not make the commit. In addition, when this option is used, your working tree does not have to match the HEAD commit. The revert is done against the beginning state of your working tree.
+.sp
+This is useful when reverting more than one commits' effect to your working tree in a row.
.SH "AUTHOR"
-
-
-Written by Junio C Hamano <junkio@cox\&.net>
-
+Written by Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-RM" 1 "" "" ""
-.SH NAME
-git-rm \- Remove files from the working tree and from the index
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-rm \- Remove files from the working tree and from the index
.SH "SYNOPSIS"
-
-
-\fIgit\-rm\fR [\-f] [\-n] [\-v] [\-\-] <file>...
-
+\fIgit\-rm\fR [\-f] [\-n] [\-v] [\-\-] <file>\&...
+.sp
.SH "DESCRIPTION"
-
-
-A convenience wrapper for git\-update\-index \-\-remove\&. For those coming from cvs, git\-rm provides an operation similar to "cvs rm" or "cvs remove"\&.
-
+A convenience wrapper for git\-update\-index \-\-remove. For those coming from cvs, git\-rm provides an operation similar to "cvs rm" or "cvs remove".
+.sp
.SH "OPTIONS"
-
.TP
-<file>...
-Files to remove from the index and optionally, from the working tree as well\&.
-
+<file>\&...
+Files to remove from the index and optionally, from the working tree as well.
.TP
\-f
-Remove files from the working tree as well as from the index\&.
-
+Remove files from the working tree as well as from the index.
.TP
\-n
-Don't actually remove the file(s), just show if they exist in the index\&.
-
+Don't actually remove the file(s), just show if they exist in the index.
.TP
\-v
-Be verbose\&.
-
+Be verbose.
.TP
\-\-
-This option can be used to separate command\-line options from the list of files, (useful when filenames might be mistaken for command\-line options)\&.
-
+This option can be used to separate command\-line options from the list of files, (useful when filenames might be mistaken for command\-line options).
.SH "DISCUSSION"
-
-
-The list of <file> given to the command is fed to git\-ls\-files command to list files that are registered in the index and are not ignored/excluded by $GIT_DIR/info/exclude file or \&.gitignore file in each directory\&. This means two things:
-
+The list of <file> given to the command is fed to git\-ls\-files command to list files that are registered in the index and are not ignored/excluded by $GIT_DIR/info/exclude file or .gitignore file in each directory. This means two things:
+.sp
.TP 3
1.
You can put the name of a directory on the command line, and the command will remove all files in it and its subdirectories (the directories themselves are never removed from the working tree);
.TP
2.
-Giving the name of a file that is not in the index does not remove that file\&.
-.LP
-
+Giving the name of a file that is not in the index does not remove that file.
.SH "EXAMPLES"
-
.TP
-git\-rm Documentation/\\*\&.txt
-Removes all *\&.txt files from the index that are under the Documentation directory and any of its subdirectories\&. The files are not removed from the working tree\&.
-
-Note that the asterisk * is quoted from the shell in this example; this lets the command include the files from subdirectories of Documentation/ directory\&.
-
+git\-rm Documentation/\\*.txt
+Removes all
+*.txt
+files from the index that are under the
+Documentation
+directory and any of its subdirectories. The files are not removed from the working tree.
+.sp
+Note that the asterisk
+*
+is quoted from the shell in this example; this lets the command include the files from subdirectories of
+Documentation/
+directory.
.TP
-git\-rm \-f git\-*\&.sh
-Remove all git\-*\&.sh scripts that are in the index\&. The files are removed from the index, and (because of the \-f option), from the working tree as well\&. Because this example lets the shell expand the asterisk (i\&.e\&. you are listing the files explicitly), it does not remove subdir/git\-foo\&.sh\&.
-
+git\-rm \-f git\-*.sh
+Remove all git\-*.sh scripts that are in the index. The files are removed from the index, and (because of the \-f option), from the working tree as well. Because this example lets the shell expand the asterisk (i.e. you are listing the files explicitly), it does not remove
+subdir/git\-foo.sh.
.SH "SEE ALSO"
-
-
\fBgit\-add\fR(1)
-
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+Written by Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-SEND-EMAIL" 1 "" "" ""
-.SH NAME
-git-send-email \- Send a collection of patches as emails
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-send\-email \- Send a collection of patches as emails
.SH "SYNOPSIS"
-
-
-\fIgit\-send\-email\fR [options] <file|directory> [... file|directory]
-
+\fIgit\-send\-email\fR [options] <file|directory> [\&... file|directory]
+.sp
.SH "DESCRIPTION"
-
-
-Takes the patches given on the command line and emails them out\&.
-
-
-The header of the email is configurable by command line options\&. If not specified on the command line, the user will be prompted with a ReadLine enabled interface to provide the necessary information\&.
-
+Takes the patches given on the command line and emails them out.
+.sp
+The header of the email is configurable by command line options. If not specified on the command line, the user will be prompted with a ReadLine enabled interface to provide the necessary information.
+.sp
.SH "OPTIONS"
-
-
The options available are:
-
+.sp
.TP
\-\-bcc
-Specify a "Bcc:" value for each email\&.
-
+Specify a "Bcc:" value for each email.
+.sp
.nf
-The \-\-bcc option must be repeated for each user you want on the bcc list\&.
+The \-\-bcc option must be repeated for each user you want on the bcc list.
.fi
-
.TP
\-\-cc
-Specify a starting "Cc:" value for each email\&.
-
+Specify a starting "Cc:" value for each email.
+.sp
.nf
-The \-\-cc option must be repeated for each user you want on the cc list\&.
+The \-\-cc option must be repeated for each user you want on the cc list.
.fi
-
.TP
\-\-chain\-reply\-to, \-\-no\-chain\-reply\-to
-If this is set, each email will be sent as a reply to the previous email sent\&. If disabled with "\-\-no\-chain\-reply\-to", all emails after the first will be sent as replies to the first email sent\&. When using this, it is recommended that the first file given be an overview of the entire patch series\&. Default is \-\-chain\-reply\-to
-
+If this is set, each email will be sent as a reply to the previous email sent. If disabled with "\-\-no\-chain\-reply\-to", all emails after the first will be sent as replies to the first email sent. When using this, it is recommended that the first file given be an overview of the entire patch series. Default is \-\-chain\-reply\-to
.TP
\-\-compose
-Use $EDITOR to edit an introductory message for the patch series\&.
-
+Use $EDITOR to edit an introductory message for the patch series.
.TP
\-\-from
-Specify the sender of the emails\&. This will default to the value GIT_COMMITTER_IDENT, as returned by "git\-var \-l"\&. The user will still be prompted to confirm this entry\&.
-
+Specify the sender of the emails. This will default to the value GIT_COMMITTER_IDENT, as returned by "git\-var \-l". The user will still be prompted to confirm this entry.
.TP
\-\-in\-reply\-to
-Specify the contents of the first In\-Reply\-To header\&. Subsequent emails will refer to the previous email instead of this if \-\-chain\-reply\-to is set (the default) Only necessary if \-\-compose is also set\&. If \-\-compose is not set, this will be prompted for\&.
-
+Specify the contents of the first In\-Reply\-To header. Subsequent emails will refer to the previous email instead of this if \-\-chain\-reply\-to is set (the default) Only necessary if \-\-compose is also set. If \-\-compose is not set, this will be prompted for.
.TP
\-\-no\-signed\-off\-by\-cc
-Do not add emails found in Signed\-off\-by: lines to the cc list\&.
-
+Do not add emails found in Signed\-off\-by: lines to the cc list.
.TP
\-\-quiet
-Make git\-send\-email less verbose\&. One line per email should be all that is output\&.
-
+Make git\-send\-email less verbose. One line per email should be all that is output.
.TP
\-\-smtp\-server
-If set, specifies the outgoing SMTP server to use\&. Defaults to localhost\&.
-
+If set, specifies the outgoing SMTP server to use. Defaults to localhost.
.TP
\-\-subject
-Specify the initial subject of the email thread\&. Only necessary if \-\-compose is also set\&. If \-\-compose is not set, this will be prompted for\&.
-
+Specify the initial subject of the email thread. Only necessary if \-\-compose is also set. If \-\-compose is not set, this will be prompted for.
.TP
\-\-suppress\-from
-Do not add the From: address to the cc: list, if it shows up in a From: line\&.
-
+Do not add the From: address to the cc: list, if it shows up in a From: line.
.TP
\-\-to
-Specify the primary recipient of the emails generated\&. Generally, this will be the upstream maintainer of the project involved\&.
-
+Specify the primary recipient of the emails generated. Generally, this will be the upstream maintainer of the project involved.
+.sp
.nf
-The \-\-to option must be repeated for each user you want on the to list\&.
+The \-\-to option must be repeated for each user you want on the to list.
.fi
-
.SH "AUTHOR"
-
-
-Written by Ryan Anderson <ryan@michonline\&.com>
-
-
-git\-send\-email is originally based upon send_lots_of_email\&.pl by Greg Kroah\-Hartman\&.
-
+Written by Ryan Anderson <ryan@michonline.com>
+.sp
+git\-send\-email is originally based upon send_lots_of_email.pl by Greg Kroah\-Hartman.
+.sp
.SH "DOCUMENTATION"
-
-
Documentation by Ryan Anderson
-
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-SEND-PACK" 1 "" "" ""
-.SH NAME
-git-send-pack \- Push missing objects packed
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-send\-pack \- Push missing objects packed
.SH "SYNOPSIS"
-
-
-\fIgit\-send\-pack\fR [\-\-all] [\-\-force] [\-\-exec=<git\-receive\-pack>] [<host>:]<directory> [<ref>...]
-
+\fIgit\-send\-pack\fR [\-\-all] [\-\-force] [\-\-exec=<git\-receive\-pack>] [<host>:]<directory> [<ref>\&...]
+.sp
.SH "DESCRIPTION"
-
-
-Invokes \fIgit\-receive\-pack\fR on a possibly remote repository, and updates it from the current repository, sending named refs\&.
-
+Invokes \fIgit\-receive\-pack\fR on a possibly remote repository, and updates it from the current repository, sending named refs.
+.sp
.SH "OPTIONS"
-
.TP
\-\-exec=<git\-receive\-pack>
-Path to the \fIgit\-receive\-pack\fR program on the remote end\&. Sometimes useful when pushing to a remote repository over ssh, and you do not have the program in a directory on the default $PATH\&.
-
+Path to the
+\fIgit\-receive\-pack\fR
+program on the remote end. Sometimes useful when pushing to a remote repository over ssh, and you do not have the program in a directory on the default $PATH.
.TP
\-\-all
-Instead of explicitly specifying which refs to update, update all refs that locally exist\&.
-
+Instead of explicitly specifying which refs to update, update all refs that locally exist.
.TP
\-\-force
-Usually, the command refuses to update a remote ref that is not an ancestor of the local ref used to overwrite it\&. This flag disables the check\&. What this means is that the remote repository can lose commits; use it with care\&.
-
+Usually, the command refuses to update a remote ref that is not an ancestor of the local ref used to overwrite it. This flag disables the check. What this means is that the remote repository can lose commits; use it with care.
.TP
<host>
-A remote host to house the repository\&. When this part is specified, \fIgit\-receive\-pack\fR is invoked via ssh\&.
-
+A remote host to house the repository. When this part is specified,
+\fIgit\-receive\-pack\fR
+is invoked via ssh.
.TP
<directory>
-The repository to update\&.
-
-
-<ref>...: The remote refs to update\&.
-
+The repository to update.
+<ref>\&...: The remote refs to update.
+.sp
.SH "SPECIFYING THE REFS"
-
-
-There are three ways to specify which refs to update on the remote end\&.
-
-
-With \fI\-\-all\fR flag, all refs that exist locally are transferred to the remote side\&. You cannot specify any \fI<ref>\fR if you use this flag\&.
-
-
-Without \fI\-\-all\fR and without any \fI<ref>\fR, the refs that exist both on the local side and on the remote side are updated\&.
-
-
-When one or more \fI<ref>\fR are specified explicitly, it can be either a single pattern, or a pair of such pattern separated by a colon ":" (this means that a ref name cannot have a colon in it)\&. A single pattern \fI<name>\fR is just a shorthand for \fI<name>:<name>\fR\&.
-
-
-Each pattern pair consists of the source side (before the colon) and the destination side (after the colon)\&. The ref to be pushed is determined by finding a match that matches the source side, and where it is pushed is determined by using the destination side\&.
-
+There are three ways to specify which refs to update on the remote end.
+.sp
+With \fI\-\-all\fR flag, all refs that exist locally are transferred to the remote side. You cannot specify any \fI<ref>\fR if you use this flag.
+.sp
+Without \fI\-\-all\fR and without any \fI<ref>\fR, the refs that exist both on the local side and on the remote side are updated.
+.sp
+When one or more \fI<ref>\fR are specified explicitly, it can be either a single pattern, or a pair of such pattern separated by a colon ":" (this means that a ref name cannot have a colon in it). A single pattern \fI<name>\fR is just a shorthand for \fI<name>:<name>\fR.
+.sp
+Each pattern pair consists of the source side (before the colon) and the destination side (after the colon). The ref to be pushed is determined by finding a match that matches the source side, and where it is pushed is determined by using the destination side.
+.sp
.TP 3
\(bu
-It is an error if <src> does not match exactly one of the local refs\&.
+It is an error if <src> does not match exactly one of the local refs.
.TP
\(bu
-It is an error if <dst> matches more than one remote refs\&.
+It is an error if <dst> matches more than one remote refs.
.TP
\(bu
If <dst> does not match any remote ref, either
-
.RS
.TP 3
\(bu
-it has to start with "refs/"; <dst> is used as the destination literally in this case\&.
+it has to start with "refs/"; <dst> is used as the destination literally in this case.
.TP
\(bu
-<src> == <dst> and the ref that matched the <src> must not exist in the set of remote refs; the ref matched <src> locally is used as the name of the destination\&.
-.LP
+<src> == <dst> and the ref that matched the <src> must not exist in the set of remote refs; the ref matched <src> locally is used as the name of the destination.
.RE
-.IP
-.LP
-
-
-Without \fI\-\-force\fR, the <src> ref is stored at the remote only if <dst> does not exist, or <dst> is a proper subset (i\&.e\&. an ancestor) of <src>\&. This check, known as "fast forward check", is performed in order to avoid accidentally overwriting the remote ref and lose other peoples' commits from there\&.
-
-
-With \fI\-\-force\fR, the fast forward check is disabled for all refs\&.
-
-
-Optionally, a <ref> parameter can be prefixed with a plus \fI+\fR sign to disable the fast\-forward check only on that ref\&.
-
+Without \fI\-\-force\fR, the <src> ref is stored at the remote only if <dst> does not exist, or <dst> is a proper subset (i.e. an ancestor) of <src>. This check, known as "fast forward check", is performed in order to avoid accidentally overwriting the remote ref and lose other peoples' commits from there.
+.sp
+With \fI\-\-force\fR, the fast forward check is disabled for all refs.
+.sp
+Optionally, a <ref> parameter can be prefixed with a plus \fI+\fR sign to disable the fast\-forward check only on that ref.
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+Written by Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano\&.
-
+Documentation by Junio C Hamano.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-SH-SETUP" 1 "" "" ""
-.SH NAME
-git-sh-setup \- Common git shell script setup code
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-sh\-setup \- Common git shell script setup code
.SH "SYNOPSIS"
-
-
\fIgit\-sh\-setup\fR
-
+.sp
.SH "DESCRIPTION"
-
-
-Sets up the normal git environment variables and a few helper functions (currently just "die()"), and returns OK if it all looks like a git archive\&. So, to make the rest of the git scripts more careful and readable, use it as follows:
-
+Sets up the normal git environment variables and a few helper functions (currently just "die()"), and returns OK if it all looks like a git archive. So, to make the rest of the git scripts more careful and readable, use it as follows:
+.sp
+.sp
.nf
-\&. git\-sh\-setup || die "Not a git archive"
+. git\-sh\-setup || die "Not a git archive"
.fi
-
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+Written by Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-SHELL" 1 "" "" ""
-.SH NAME
-git-shell \- Restricted login shell for GIT over SSH only
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-shell \- Restricted login shell for GIT over SSH only
.SH "SYNOPSIS"
-
-
\fIgit\-shell\fR \-c <command> <argument>
-
+.sp
.SH "DESCRIPTION"
-
-
-This is meant to be used as a login shell for SSH accounts you want to restrict to GIT pull/push access only\&. It permits execution only of server\-side GIT commands implementing the pull/push functionality\&. The commands can be executed only by the \fI\-c\fR option; the shell is not interactive\&.
-
-
-Currently, only the git\-receive\-pack and git\-upload\-pack commands are permitted to be called, with a single required argument\&.
-
+This is meant to be used as a login shell for SSH accounts you want to restrict to GIT pull/push access only. It permits execution only of server\-side GIT commands implementing the pull/push functionality. The commands can be executed only by the \fI\-c\fR option; the shell is not interactive.
+.sp
+Currently, only the git\-receive\-pack and git\-upload\-pack commands are permitted to be called, with a single required argument.
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+Written by Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Petr Baudis and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Petr Baudis and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-SHORTLOG" 1 "" "" ""
-.SH NAME
-git-shortlog \- Summarize 'git log' output
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-shortlog \- Summarize 'git log' output
.SH "SYNOPSIS"
-
-
git\-log \-\-pretty=short | \fIgit\-shortlog\fR
-
+.sp
.SH "DESCRIPTION"
-
-
-Summarizes \fIgit log\fR output in a format suitable for inclusion in release announcements\&. Each commit will be grouped by author the first line of the commit message will be shown\&.
-
-
-Additionally, "[PATCH]" will be stripped from the commit description\&.
-
+Summarizes \fIgit log\fR output in a format suitable for inclusion in release announcements. Each commit will be grouped by author the first line of the commit message will be shown.
+.sp
+Additionally, "[PATCH]" will be stripped from the commit description.
+.sp
.SH "FILES"
-
.TP
-\fI\&.mailmap\fR
-If this file exists, it will be used for mapping author email addresses to a real author name\&. One mapping per line, first the author name followed by the email address enclosed by \fI<\fR and \fI>\fR\&. Use hash \fI#\fR for comments\&. Example:
-
+\fI.mailmap\fR
+If this file exists, it will be used for mapping author email addresses to a real author name. One mapping per line, first the author name followed by the email address enclosed by
+\fI<\fR
+and
+\fI>\fR. Use hash
+\fI#\fR
+for comments. Example:
+.sp
.nf
# Keep alphabetized
-Adam Morrow <adam@localhost\&.localdomain>
-Eve Jones <eve@laptop\&.(none)>
+Adam Morrow <adam@localhost.localdomain>
+Eve Jones <eve@laptop.(none)>
.fi
-
.SH "AUTHOR"
-
-
-Written by Jeff Garzik <jgarzik@pobox\&.com>
-
+Written by Jeff Garzik <jgarzik@pobox.com>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano\&.
-
+Documentation by Junio C Hamano.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-SHOW-BRANCH" 1 "" "" ""
-.SH NAME
-git-show-branch \- Show branches and their commits
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-show\-branch \- Show branches and their commits
.SH "SYNOPSIS"
-
+.sp
.nf
\fIgit\-show\-branch\fR [\-\-all] [\-\-heads] [\-\-tags] [\-\-topo\-order] [\-\-current]
[\-\-more=<n> | \-\-list | \-\-independent | \-\-merge\-base]
- [\-\-no\-name | \-\-sha1\-name] [<rev> | <glob>]...
+ [\-\-no\-name | \-\-sha1\-name] [<rev> | <glob>]\&...
.fi
-
.SH "DESCRIPTION"
-
-
-Shows the commit ancestry graph starting from the commits named with <rev>s or <globs>s (or all refs under $GIT_DIR/refs/heads and/or $GIT_DIR/refs/tags) semi\-visually\&.
-
-
-It cannot show more than 29 branches and commits at a time\&.
-
-
-It uses showbranch\&.default multi\-valued configuration items if no <rev> nor <glob> is given on the command line\&.
-
+Shows the commit ancestry graph starting from the commits named with <rev>s or <globs>s (or all refs under $GIT_DIR/refs/heads and/or $GIT_DIR/refs/tags) semi\-visually.
+.sp
+It cannot show more than 29 branches and commits at a time.
+.sp
+It uses showbranch.default multi\-valued configuration items if no <rev> nor <glob> is given on the command line.
+.sp
.SH "OPTIONS"
-
.TP
<rev>
-Arbitrary extended SHA1 expression (see git\-rev\-parse) that typically names a branch HEAD or a tag\&.
-
+Arbitrary extended SHA1 expression (see
+git\-rev\-parse) that typically names a branch HEAD or a tag.
.TP
<glob>
-A glob pattern that matches branch or tag names under $GIT_DIR/refs\&. For example, if you have many topic branches under $GIT_DIR/refs/heads/topic, giving topic/* would show all of them\&.
-
+A glob pattern that matches branch or tag names under $GIT_DIR/refs. For example, if you have many topic branches under $GIT_DIR/refs/heads/topic, giving
+topic/*
+would show all of them.
.TP
\-\-all \-\-heads \-\-tags
-Show all refs under $GIT_DIR/refs, $GIT_DIR/refs/heads, and $GIT_DIR/refs/tags, respectively\&.
-
+Show all refs under $GIT_DIR/refs, $GIT_DIR/refs/heads, and $GIT_DIR/refs/tags, respectively.
.TP
\-\-current
-With this option, the command includes the current branch to the list of revs to be shown when it is not given on the command line\&.
-
+With this option, the command includes the current branch to the list of revs to be shown when it is not given on the command line.
.TP
\-\-topo\-order
-By default, the branches and their commits are shown in reverse chronological order\&. This option makes them appear in topological order (i\&.e\&., descendant commits are shown before their parents)\&.
-
+By default, the branches and their commits are shown in reverse chronological order. This option makes them appear in topological order (i.e., descendant commits are shown before their parents).
.TP
\-\-sparse
-By default, the output omits merges that are reachable from only one tip being shown\&. This option makes them visible\&.
-
+By default, the output omits merges that are reachable from only one tip being shown. This option makes them visible.
.TP
\-\-more=<n>
-Usually the command stops output upon showing the commit that is the common ancestor of all the branches\&. This flag tells the command to go <n> more common commits beyond that\&. When <n> is negative, display only the <reference>s given, without showing the commit ancestry tree\&.
-
+Usually the command stops output upon showing the commit that is the common ancestor of all the branches. This flag tells the command to go <n> more common commits beyond that. When <n> is negative, display only the <reference>s given, without showing the commit ancestry tree.
.TP
\-\-list
-Synonym to \-\-more=\-1
-
+Synonym to
+\-\-more=\-1
.TP
\-\-merge\-base
-Instead of showing the commit list, just act like the \fIgit\-merge\-base \-a\fR command, except that it can accept more than two heads\&.
-
+Instead of showing the commit list, just act like the
+\fIgit\-merge\-base \-a\fR
+command, except that it can accept more than two heads.
.TP
\-\-independent
-Among the <reference>s given, display only the ones that cannot be reached from any other <reference>\&.
-
+Among the <reference>s given, display only the ones that cannot be reached from any other <reference>.
.TP
\-\-no\-name
-Do not show naming strings for each commit\&.
-
+Do not show naming strings for each commit.
.TP
\-\-sha1\-name
-Instead of naming the commits using the path to reach them from heads (e\&.g\&. "master~2" to mean the grandparent of "master"), name them with the unique prefix of their object names\&.
-
-
-Note that \-\-more, \-\-list, \-\-independent and \-\-merge\-base options are mutually exclusive\&.
-
+Instead of naming the commits using the path to reach them from heads (e.g. "master~2" to mean the grandparent of "master"), name them with the unique prefix of their object names.
+Note that \-\-more, \-\-list, \-\-independent and \-\-merge\-base options are mutually exclusive.
+.sp
.SH "OUTPUT"
-
-
-Given N <references>, the first N lines are the one\-line description from their commit message\&. The branch head that is pointed at by $GIT_DIR/HEAD is prefixed with an asterisk * character while other heads are prefixed with a ! character\&.
-
-
-Following these N lines, one\-line log for each commit is displayed, indented N places\&. If a commit is on the I\-th branch, the I\-th indentation character shows a + sign; otherwise it shows a space\&. Merge commits are denoted by a \- sign\&. Each commit shows a short name that can be used as an extended SHA1 to name that commit\&.
-
-
+Given N <references>, the first N lines are the one\-line description from their commit message. The branch head that is pointed at by $GIT_DIR/HEAD is prefixed with an asterisk * character while other heads are prefixed with a ! character.
+.sp
+Following these N lines, one\-line log for each commit is displayed, indented N places. If a commit is on the I\-th branch, the I\-th indentation character shows a + sign; otherwise it shows a space. Merge commits are denoted by a \- sign. Each commit shows a short name that can be used as an extended SHA1 to name that commit.
+.sp
The following example shows three branches, "master", "fixes" and "mhf":
-
+.sp
+.sp
.nf
$ git show\-branch master fixes mhf
-* [master] Add 'git show\-branch'\&.
+* [master] Add 'git show\-branch'.
! [fixes] Introduce "reset type" flag to "git reset"
- ! [mhf] Allow "+remote:local" refspec to cause \-\-force when fetching\&.
+ ! [mhf] Allow "+remote:local" refspec to cause \-\-force when fetching.
\-\-\-
- + [mhf] Allow "+remote:local" refspec to cause \-\-force when fetching\&.
- + [mhf~1] Use git\-octopus when pulling more than one heads\&.
+ + [mhf] Allow "+remote:local" refspec to cause \-\-force when fetching.
+ + [mhf~1] Use git\-octopus when pulling more than one heads.
+ [fixes] Introduce "reset type" flag to "git reset"
- + [mhf~2] "git fetch \-\-force"\&.
- + [mhf~3] Use \&.git/remote/origin, not \&.git/branches/origin\&.
+ + [mhf~2] "git fetch \-\-force".
+ + [mhf~3] Use .git/remote/origin, not .git/branches/origin.
+ [mhf~4] Make "git pull" and "git fetch" default to origin
+ [mhf~5] Infamous 'octopus merge'
- + [mhf~6] Retire git\-parse\-remote\&.
- + [mhf~7] Multi\-head fetch\&.
- + [mhf~8] Start adding the $GIT_DIR/remotes/ support\&.
-*++ [master] Add 'git show\-branch'\&.
+ + [mhf~6] Retire git\-parse\-remote.
+ + [mhf~7] Multi\-head fetch.
+ + [mhf~8] Start adding the $GIT_DIR/remotes/ support.
+*++ [master] Add 'git show\-branch'.
.fi
-
-
-These three branches all forked from a common commit, [master], whose commit message is "Add \fIgit show\-branch\fR\&. "fixes" branch adds one commit \fIIntroduce "reset type"\fR\&. "mhf" branch has many other commits\&. The current branch is "master"\&.
-
+These three branches all forked from a common commit, [master], whose commit message is "Add \fIgit show\-branch\fR. "fixes" branch adds one commit \fIIntroduce "reset type"\fR. "mhf" branch has many other commits. The current branch is "master".
+.sp
.SH "EXAMPLE"
-
-
If you keep your primary branches immediately under $GIT_DIR/refs/heads, and topic branches in subdirectories of it, having the following in the configuration file may help:
-
+.sp
+.sp
.nf
[showbranch]
default = \-\-topo\-order
default = heads/*
-
.fi
-
-
-With this, git show\-branch without extra parameters would show only the primary branches\&. In addition, if you happen to be on your topic branch, it is shown as well\&.
-
+With this, git show\-branch without extra parameters would show only the primary branches. In addition, if you happen to be on your topic branch, it is shown as well.
+.sp
.SH "AUTHOR"
-
-
-Written by Junio C Hamano <junkio@cox\&.net>
-
+Written by Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano\&.
-
+Documentation by Junio C Hamano.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-SHOW-INDEX" 1 "" "" ""
-.SH NAME
-git-show-index \- Show packed archive index
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+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\&.
-
-
-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\&.
-
+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>
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-SHOW" 1 "" "" ""
-.SH NAME
-git-show \- Show one commit with difference it introduces
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-show \- Show one commit with difference it introduces
.SH "SYNOPSIS"
-
-
-\fIgit\-show\fR <option>...
-
+\fIgit\-show\fR <option>\&...
+.sp
.SH "DESCRIPTION"
-
-
-Shows commit log and textual diff for a single commit\&. The command internally invokes \fIgit\-rev\-list\fR piped to \fIgit\-diff\-tree\fR, and takes command line options for both of these commands\&. It also presents the merge commit in a special format as produced by \fIgit\-diff\-tree \-\-cc\fR\&.
-
-
-This manual page describes only the most frequently used options\&.
-
+Shows commit log and textual diff for a single commit. The command internally invokes \fIgit\-rev\-list\fR piped to \fIgit\-diff\-tree\fR, and takes command line options for both of these commands. It also presents the merge commit in a special format as produced by \fIgit\-diff\-tree \-\-cc\fR.
+.sp
+This manual page describes only the most frequently used options.
+.sp
.SH "OPTIONS"
-
.TP
<commitid>
-ID of the commit to show\&.
-
+ID of the commit to show.
.TP
\-\-pretty=<format>
-Controls the output format for the commit logs\&. <format> can be one of \fIraw\fR, \fImedium\fR, \fIshort\fR, \fIfull\fR, and \fIoneline\fR\&.
-
+Controls the output format for the commit logs. <format> can be one of
+\fIraw\fR,
+\fImedium\fR,
+\fIshort\fR,
+\fIfull\fR, and
+\fIoneline\fR.
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org> and Junio C Hamano <junkio@cox\&.net>
-
+Written by Linus Torvalds <torvalds@osdl.org> and Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by David Greaves, Petr Baudis and the git\-list <git@vger\&.kernel\&.org>\&.
-
-
-This manual page is a stub\&. You can help the git documentation by expanding it\&.
-
+Documentation by David Greaves, Petr Baudis and the git\-list <git@vger.kernel.org>.
+.sp
+This manual page is a stub. You can help the git documentation by expanding it.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-SSH-FETCH" 1 "" "" ""
-.SH NAME
-git-ssh-fetch \- Pulls from a remote repository over ssh connection
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-ssh\-fetch \- Pulls from a remote repository over ssh connection
.SH "SYNOPSIS"
-
-
\fIgit\-ssh\-fetch\fR [\-c] [\-t] [\-a] [\-d] [\-v] [\-w filename] [\-\-recover] commit\-id url
-
+.sp
.SH "DESCRIPTION"
-
-
-Pulls from a remote repository over ssh connection, invoking git\-ssh\-upload on the other end\&. It functions identically to git\-ssh\-upload, aside from which end you run it on\&.
-
+Pulls from a remote repository over ssh connection, invoking git\-ssh\-upload on the other end. It functions identically to git\-ssh\-upload, aside from which end you run it on.
+.sp
.SH "OPTIONS"
-
.TP
commit\-id
-Either the hash or the filename under [URL]/refs/ to pull\&.
-
+Either the hash or the filename under [URL]/refs/ to pull.
.TP
\-c
-Get the commit objects\&.
-
+Get the commit objects.
.TP
\-t
-Get trees associated with the commit objects\&.
-
+Get trees associated with the commit objects.
.TP
\-a
-Get all the objects\&.
-
+Get all the objects.
.TP
\-v
-Report what is downloaded\&.
-
+Report what is downloaded.
.TP
\-w
-Writes the commit\-id into the filename under $GIT_DIR/refs/ on the local end after the transfer is complete\&.
-
+Writes the commit\-id into the filename under $GIT_DIR/refs/ on the local end after the transfer is complete.
.SH "AUTHOR"
-
-
-Written by Daniel Barkalow <barkalow@iabervon\&.org>
-
+Written by Daniel Barkalow <barkalow@iabervon.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-SSH-UPLOAD" 1 "" "" ""
-.SH NAME
-git-ssh-upload \- Pushes to a remote repository over ssh connection
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-ssh\-upload \- Pushes to a remote repository over ssh connection
.SH "SYNOPSIS"
-
-
\fIgit\-ssh\-upload\fR [\-c] [\-t] [\-a] [\-d] [\-v] [\-w filename] [\-\-recover] commit\-id url
-
+.sp
.SH "DESCRIPTION"
-
-
-Pushes from a remote repository over ssh connection, invoking git\-ssh\-fetch on the other end\&. It functions identically to git\-ssh\-fetch, aside from which end you run it on\&.
-
+Pushes from a remote repository over ssh connection, invoking git\-ssh\-fetch on the other end. It functions identically to git\-ssh\-fetch, aside from which end you run it on.
+.sp
.SH "OPTIONS"
-
.TP
commit\-id
-Id of commit to push\&.
-
+Id of commit to push.
.TP
\-c
-Get the commit objects\&.
-
+Get the commit objects.
.TP
\-t
-Get tree associated with the requested commit object\&.
-
+Get tree associated with the requested commit object.
.TP
\-a
-Get all the objects\&.
-
+Get all the objects.
.TP
\-v
-Report what is uploaded\&.
-
+Report what is uploaded.
.TP
\-w
-Writes the commit\-id into the filename under [URL]/refs/ on the remote end after the transfer is complete\&.
-
+Writes the commit\-id into the filename under [URL]/refs/ on the remote end after the transfer is complete.
.SH "AUTHOR"
-
-
-Written by Daniel Barkalow <barkalow@iabervon\&.org>
-
+Written by Daniel Barkalow <barkalow@iabervon.org>
+.sp
.SH "DOCUMENTATION"
-
-
Documentation by Daniel Barkalow
-
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-STATUS" 1 "" "" ""
-.SH NAME
-git-status \- Show working tree status
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-status \- Show working tree status
.SH "SYNOPSIS"
-
-
-\fIgit\-status\fR <options>...
-
+\fIgit\-status\fR <options>\&...
+.sp
.SH "DESCRIPTION"
-
-
-Examines paths in the working tree that has changes unrecorded to the index file, and changes between the index file and the current HEAD commit\&. The former paths are what you _could_ commit by running \fIgit\-update\-index\fR before running \fIgit commit\fR, and the latter paths are what you _would_ commit by running \fIgit commit\fR\&.
-
-
-If there is no path that is different between the index file and the current HEAD commit, the command exits with non\-zero status\&.
-
-
-The command takes the same set of options as git\-commit; it shows what would be committed if the same options are given to git\-commit\&.
-
+Examines paths in the working tree that has changes unrecorded to the index file, and changes between the index file and the current HEAD commit. The former paths are what you _could_ commit by running \fIgit\-update\-index\fR before running \fIgit commit\fR, and the latter paths are what you _would_ commit by running \fIgit commit\fR.
+.sp
+If there is no path that is different between the index file and the current HEAD commit, the command exits with non\-zero status.
+.sp
+The command takes the same set of options as git\-commit; it shows what would be committed if the same options are given to git\-commit.
+.sp
.SH "OUTPUT"
-
-
-The output from this command is designed to be used as a commit template comments, and all the output lines are prefixed with \fI#\fR\&.
-
+The output from this command is designed to be used as a commit template comments, and all the output lines are prefixed with \fI#\fR.
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org> and Junio C Hamano <junkio@cox\&.net>\&.
-
+Written by Linus Torvalds <torvalds@osdl.org> and Junio C Hamano <junkio@cox.net>.
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-STRIPSPACE" 1 "" "" ""
-.SH NAME
-git-stripspace \- Filter out empty lines
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+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\&.
-
+Remove multiple empty lines, and empty lines at beginning and end.
+.sp
.SH "OPTIONS"
-
.TP
<stream>
-Byte stream to act on\&.
-
+Byte stream to act on.
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+Written by Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+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" "09/25/2006" "" ""
+.TH "GIT\-SVN" "1" "10/03/2006" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-SVNIMPORT" 1 "" "" ""
-.SH NAME
-git-svnimport \- Import a SVN repository into git
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-svnimport \- Import a SVN repository into git
.SH "SYNOPSIS"
-
+.sp
.nf
\fIgit\-svnimport\fR [ \-o <branch\-for\-HEAD> ] [ \-h ] [ \-v ] [ \-d | \-D ]
[ \-C <GIT_repository> ] [ \-i ] [ \-u ] [\-l limit_rev]
[ \-I <ignorefile_name> ] [ \-A <author_file> ]
<SVN_repository_URL> [ <path> ]
.fi
-
.SH "DESCRIPTION"
-
-
-Imports a SVN repository into git\&. It will either create a new repository, or incrementally import into an existing one\&.
-
-
-SVN access is done by the SVN::Perl module\&.
-
-
-git\-svnimport assumes that SVN repositories are organized into one "trunk" directory where the main development happens, "branch/FOO" directories for branches, and "/tags/FOO" directories for tags\&. Other subdirectories are ignored\&.
-
-
-git\-svnimport creates a file "\&.git/svn2git", which is required for incremental SVN imports\&.
-
+Imports a SVN repository into git. It will either create a new repository, or incrementally import into an existing one.
+.sp
+SVN access is done by the SVN::Perl module.
+.sp
+git\-svnimport assumes that SVN repositories are organized into one "trunk" directory where the main development happens, "branch/FOO" directories for branches, and "/tags/FOO" directories for tags. Other subdirectories are ignored.
+.sp
+git\-svnimport creates a file ".git/svn2git", which is required for incremental SVN imports.
+.sp
.SH "OPTIONS"
-
.TP
\-C <target\-dir>
-The GIT repository to import to\&. If the directory doesn't exist, it will be created\&. Default is the current directory\&.
-
+The GIT repository to import to. If the directory doesn't exist, it will be created. Default is the current directory.
.TP
\-s <start_rev>
-Start importing at this SVN change number\&. The default is 1\&.
-
-When importing incrementally, you might need to edit the \&.git/svn2git file\&.
-
+Start importing at this SVN change number. The default is 1.
+.sp
+When importing incrementally, you might need to edit the .git/svn2git file.
.TP
\-i
-Import\-only: don't perform a checkout after importing\&. This option ensures the working directory and index remain untouched and will not create them if they do not exist\&.
-
+Import\-only: don't perform a checkout after importing. This option ensures the working directory and index remain untouched and will not create them if they do not exist.
.TP
\-T <trunk_subdir>
-Name the SVN trunk\&. Default "trunk"\&.
-
+Name the SVN trunk. Default "trunk".
.TP
\-t <tag_subdir>
-Name the SVN subdirectory for tags\&. Default "tags"\&.
-
+Name the SVN subdirectory for tags. Default "tags".
.TP
\-b <branch_subdir>
-Name the SVN subdirectory for branches\&. Default "branches"\&.
-
+Name the SVN subdirectory for branches. Default "branches".
.TP
\-o <branch\-for\-HEAD>
-The \fItrunk\fR branch from SVN is imported to the \fIorigin\fR branch within the git repository\&. Use this option if you want to import into a different branch\&.
-
+The
+\fItrunk\fR
+branch from SVN is imported to the
+\fIorigin\fR
+branch within the git repository. Use this option if you want to import into a different branch.
.TP
\-r
-Prepend \fIrX: \fR to commit messages, where X is the imported subversion revision\&.
-
+Prepend
+\fIrX: \fR
+to commit messages, where X is the imported subversion revision.
.TP
\-I <ignorefile_name>
-Import the svn:ignore directory property to files with this name in each directory\&. (The Subversion and GIT ignore syntaxes are similar enough that using the Subversion patterns directly with "\-I \&.gitignore" will almost always just work\&.)
-
+Import the svn:ignore directory property to files with this name in each directory. (The Subversion and GIT ignore syntaxes are similar enough that using the Subversion patterns directly with "\-I .gitignore" will almost always just work.)
.TP
\-A <author_file>
Read a file with lines on the form
-
-
+.sp
.nf
- username = User's Full Name <email@addr\&.es>
-
+ username = User's Full Name <email@addr.es>
.fi
-and use "User's Full Name <email@addr\&.es>" as the GIT author and committer for Subversion commits made by "username"\&. If encountering a commit made by a user not in the list, abort\&.
-
-For convenience, this data is saved to $GIT_DIR/svn\-authors each time the \-A option is provided, and read from that same file each time git\-svnimport is run with an existing GIT repository without \-A\&.
-
+and use "User's Full Name <email@addr.es>" as the GIT author and committer for Subversion commits made by "username". If encountering a commit made by a user not in the list, abort.
+.sp
+For convenience, this data is saved to $GIT_DIR/svn\-authors each time the \-A option is provided, and read from that same file each time git\-svnimport is run with an existing GIT repository without \-A.
.TP
\-m
-Attempt to detect merges based on the commit message\&. This option will enable default regexes that try to capture the name source branch name from the commit message\&.
-
+Attempt to detect merges based on the commit message. This option will enable default regexes that try to capture the name source branch name from the commit message.
.TP
\-M <regex>
-Attempt to detect merges based on the commit message with a custom regex\&. It can be used with \-m to also see the default regexes\&. You must escape forward slashes\&.
-
+Attempt to detect merges based on the commit message with a custom regex. It can be used with \-m to also see the default regexes. You must escape forward slashes.
.TP
\-l <max_rev>
-Specify a maximum revision number to pull\&.
-
+Specify a maximum revision number to pull.
+.sp
.nf
Formerly, this option controlled how many revisions to pull,
-due to SVN memory leaks\&. (These have been worked around\&.)
+due to SVN memory leaks. (These have been worked around.)
.fi
-
.TP
\-v
-Verbosity: let \fIsvnimport\fR report what it is doing\&.
-
+Verbosity: let
+\fIsvnimport\fR
+report what it is doing.
.TP
\-d
-Use direct HTTP requests if possible\&. The "<path>" argument is used only for retrieving the SVN logs; the path to the contents is included in the SVN log\&.
-
+Use direct HTTP requests if possible. The "<path>" argument is used only for retrieving the SVN logs; the path to the contents is included in the SVN log.
.TP
\-D
-Use direct HTTP requests if possible\&. The "<path>" argument is used for retrieving the logs, as well as for the contents\&.
-
-There's no safe way to automatically find out which of these options to use, so you need to try both\&. Usually, the one that's wrong will die with a 40x error pretty quickly\&.
-
+Use direct HTTP requests if possible. The "<path>" argument is used for retrieving the logs, as well as for the contents.
+.sp
+There's no safe way to automatically find out which of these options to use, so you need to try both. Usually, the one that's wrong will die with a 40x error pretty quickly.
.TP
<SVN_repository_URL>
-The URL of the SVN module you want to import\&. For local repositories, use "file:///absolute/path"\&.
-
-If you're using the "\-d" or "\-D" option, this is the URL of the SVN repository itself; it usually ends in "/svn"\&.
-
+The URL of the SVN module you want to import. For local repositories, use "file:///absolute/path".
+.sp
+If you're using the "\-d" or "\-D" option, this is the URL of the SVN repository itself; it usually ends in "/svn".
.TP
<path>
-The path to the module you want to check out\&.
-
+The path to the module you want to check out.
.TP
\-h
-Print a short usage message and exit\&.
-
+Print a short usage message and exit.
.SH "OUTPUT"
-
-
-If \fI\-v\fR is specified, the script reports what it is doing\&.
-
-
-Otherwise, success is indicated the Unix way, i\&.e\&. by simply exiting with a zero exit status\&.
-
+If \fI\-v\fR is specified, the script reports what it is doing.
+.sp
+Otherwise, success is indicated the Unix way, i.e. by simply exiting with a zero exit status.
+.sp
.SH "AUTHOR"
-
-
-Written by Matthias Urlichs <smurf@smurf\&.noris\&.de>, with help from various participants of the git\-list <git@vger\&.kernel\&.org>\&.
-
-
-Based on a cvs2git script by the same author\&.
-
+Written by Matthias Urlichs <smurf@smurf.noris.de>, with help from various participants of the git\-list <git@vger.kernel.org>.
+.sp
+Based on a cvs2git script by the same author.
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Matthias Urlichs <smurf@smurf\&.noris\&.de>\&.
-
+Documentation by Matthias Urlichs <smurf@smurf.noris.de>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-SYMBOLIC-REF" 1 "" "" ""
-.SH NAME
-git-symbolic-ref \- read and modify symbolic refs
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-symbolic\-ref \- read and modify symbolic refs
.SH "SYNOPSIS"
-
-
\fIgit\-symbolic\-ref\fR <name> [<ref>]
-
+.sp
.SH "DESCRIPTION"
-
-
-Given one argument, reads which branch head the given symbolic ref refers to and outputs its path, relative to the \&.git/ directory\&. Typically you would give HEAD as the <name> argument to see on which branch your working tree is on\&.
-
-
-Give two arguments, create or update a symbolic ref <name> to point at the given branch <ref>\&.
-
-
-Traditionally, \&.git/HEAD is a symlink pointing at refs/heads/master\&. When we want to switch to another branch, we did ln \-sf refs/heads/newbranch \&.git/HEAD, and when we want to find out which branch we are on, we did readlink \&.git/HEAD\&. This was fine, and internally that is what still happens by default, but on platforms that do not have working symlinks, or that do not have the readlink(1) command, this was a bit cumbersome\&. On some platforms, ln \-sf does not even work as advertised (horrors)\&.
-
-
-A symbolic ref can be a regular file that stores a string that begins with ref: refs/\&. For example, your \&.git/HEAD \fIcan\fR be a regular file whose contents is ref: refs/heads/master\&. This can be used on a filesystem that does not support symbolic links\&. Instead of doing readlink \&.git/HEAD, git\-symbolic\-ref HEAD can be used to find out which branch we are on\&. To point the HEAD to newbranch, instead of ln \-sf refs/heads/newbranch \&.git/HEAD, git\-symbolic\-ref HEAD refs/heads/newbranch can be used\&.
-
-
-Currently, \&.git/HEAD uses a regular file symbolic ref on Cygwin, and everywhere else it is implemented as a symlink\&. This can be changed at compilation time\&.
-
+Given one argument, reads which branch head the given symbolic ref refers to and outputs its path, relative to the .git/ directory. Typically you would give HEAD as the <name> argument to see on which branch your working tree is on.
+.sp
+Give two arguments, create or update a symbolic ref <name> to point at the given branch <ref>.
+.sp
+Traditionally, .git/HEAD is a symlink pointing at refs/heads/master. When we want to switch to another branch, we did ln \-sf refs/heads/newbranch .git/HEAD, and when we want to find out which branch we are on, we did readlink .git/HEAD. This was fine, and internally that is what still happens by default, but on platforms that do not have working symlinks, or that do not have the readlink(1) command, this was a bit cumbersome. On some platforms, ln \-sf does not even work as advertised (horrors).
+.sp
+A symbolic ref can be a regular file that stores a string that begins with ref: refs/. For example, your .git/HEAD \fBcan\fR be a regular file whose contents is ref: refs/heads/master. This can be used on a filesystem that does not support symbolic links. Instead of doing readlink .git/HEAD, git\-symbolic\-ref HEAD can be used to find out which branch we are on. To point the HEAD to newbranch, instead of ln \-sf refs/heads/newbranch .git/HEAD, git\-symbolic\-ref HEAD refs/heads/newbranch can be used.
+.sp
+Currently, .git/HEAD uses a regular file symbolic ref on Cygwin, and everywhere else it is implemented as a symlink. This can be changed at compilation time.
+.sp
.SH "AUTHOR"
-
-
-Written by Junio C Hamano <junkio@cox\&.net>
-
+Written by Junio C Hamano <junkio@cox.net>
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-TAG" 1 "" "" ""
-.SH NAME
-git-tag \- Create a tag object signed with GPG
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-tag \- Create a tag object signed with GPG
.SH "SYNOPSIS"
-
+.sp
.nf
\fIgit\-tag\fR [\-a | \-s | \-u <key\-id>] [\-f | \-d] [\-m <msg>] <name> [<head>]
\fIgit\-tag\fR \-l [<pattern>]
.fi
-
.SH "DESCRIPTION"
-
-
-Adds a \fItag\fR reference in \&.git/refs/tags/
-
-
-Unless \-f is given, the tag must not yet exist in \&.git/refs/tags/ directory\&.
-
-
-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\&.
-
-
-Otherwise just the SHA1 object name of the commit object is written (i\&.e\&. a lightweight tag)\&.
-
-
-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\&.
-
-
-\-d <tag> deletes the tag\&.
-
-
-\-l <pattern> lists tags that match the given pattern (or all if no pattern is given)\&.
-
+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
Make an unsigned, annotated tag object
-
.TP
\-s
Make a GPG\-signed tag, using the default e\-mail address's key
-
.TP
\-u <key\-id>
Make a GPG\-signed tag, using the given key
-
.TP
\-f
Replace an existing tag with the given name (instead of failing)
-
.TP
\-d
Delete an existing tag with the given name
-
.TP
\-l <pattern>
-List tags that match the given pattern (or all if no pattern is given)\&.
-
+List tags that match the given pattern (or all if no pattern is given).
.TP
\-m <msg>
Use the given tag message (instead of prompting)
-
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>, Junio C Hamano <junkio@cox\&.net> and Chris Wright <chrisw@osdl\&.org>\&.
-
+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>\&.
-
+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\-TAR\-TREE" "1" "09/25/2006" "" ""
+.TH "GIT\-TAR\-TREE" "1" "10/03/2006" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-UNPACK-FILE" 1 "" "" ""
-.SH NAME
-git-unpack-file \- Creates a temporary file with a blob's contents
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+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
-
+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>
-
+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>\&.
-
+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" "09/14/2006" "" ""
+.TH "GIT\-UNPACK\-OBJECTS" "1" "10/03/2006" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-UPDATE-INDEX" 1 "" "" ""
-.SH NAME
-git-update-index \- Modifies the index or directory cache
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-update\-index \- Modifies the index or directory cache
.SH "SYNOPSIS"
-
+.sp
.nf
\fIgit\-update\-index\fR
[\-\-add] [\-\-remove | \-\-force\-remove] [\-\-replace]
[\-\-verbose]
[\-\-] [<file>]*
.fi
-
.SH "DESCRIPTION"
-
-
-Modifies the index or directory cache\&. Each file mentioned is updated into the index and any \fIunmerged\fR or \fIneeds updating\fR state is cleared\&.
-
-
+Modifies the index or directory cache. Each file mentioned is updated into the index and any \fIunmerged\fR or \fIneeds updating\fR state is cleared.
+.sp
The way "git\-update\-index" handles files it is told about can be modified using the various options:
-
+.sp
.SH "OPTIONS"
-
.TP
\-\-add
-If a specified file isn't in the index already then it's added\&. Default behaviour is to ignore new files\&.
-
+If a specified file isn't in the index already then it's added. Default behaviour is to ignore new files.
.TP
\-\-remove
-If a specified file is in the index but is missing then it's removed\&. Default behavior is to ignore removed file\&.
-
+If a specified file is in the index but is missing then it's removed. Default behavior is to ignore removed file.
.TP
\-\-refresh
-Looks at the current index and checks to see if merges or updates are needed by checking stat() information\&.
-
+Looks at the current index and checks to see if merges or updates are needed by checking stat() information.
.TP
\-q
-Quiet\&. If \-\-refresh finds that the index needs an update, the default behavior is to error out\&. This option makes git\-update\-index continue anyway\&.
-
+Quiet. If \-\-refresh finds that the index needs an update, the default behavior is to error out. This option makes git\-update\-index continue anyway.
.TP
\-\-unmerged
-If \-\-refresh finds unmerged changes in the index, the default behavior is to error out\&. This option makes git\-update\-index continue anyway\&.
-
+If \-\-refresh finds unmerged changes in the index, the default behavior is to error out. This option makes git\-update\-index continue anyway.
.TP
\-\-ignore\-missing
Ignores missing files during a \-\-refresh
-
.TP
\-\-cacheinfo <mode> <object> <path>
-Directly insert the specified info into the index\&.
-
+Directly insert the specified info into the index.
.TP
\-\-index\-info
-Read index information from stdin\&.
-
+Read index information from stdin.
.TP
\-\-chmod=(+|\-)x
-Set the execute permissions on the updated files\&.
-
+Set the execute permissions on the updated files.
.TP
\-\-assume\-unchanged, \-\-no\-assume\-unchanged
-When these flags are specified, the object name recorded for the paths are not updated\&. Instead, these options sets and unsets the "assume unchanged" bit for the paths\&. When the "assume unchanged" bit is on, git stops checking the working tree files for possible modifications, so you need to manually unset the bit to tell git when you change the working tree file\&. This is sometimes helpful when working with a big project on a filesystem that has very slow lstat(2) system call (e\&.g\&. cifs)\&.
-
+When these flags are specified, the object name recorded for the paths are not updated. Instead, these options sets and unsets the "assume unchanged" bit for the paths. When the "assume unchanged" bit is on, git stops checking the working tree files for possible modifications, so you need to manually unset the bit to tell git when you change the working tree file. This is sometimes helpful when working with a big project on a filesystem that has very slow lstat(2) system call (e.g. cifs).
.TP
\-\-again, \-g
-Runs git\-update\-index itself on the paths whose index entries are different from those from the HEAD commit\&.
-
+Runs
+git\-update\-index
+itself on the paths whose index entries are different from those from the
+HEAD
+commit.
.TP
\-\-unresolve
-Restores the \fIunmerged\fR or \fIneeds updating\fR state of a file during a merge if it was cleared by accident\&.
-
+Restores the
+\fIunmerged\fR
+or
+\fIneeds updating\fR
+state of a file during a merge if it was cleared by accident.
.TP
\-\-info\-only
-Do not create objects in the object database for all <file> arguments that follow this flag; just insert their object IDs into the index\&.
-
+Do not create objects in the object database for all <file> arguments that follow this flag; just insert their object IDs into the index.
.TP
\-\-force\-remove
-Remove the file from the index even when the working directory still has such a file\&. (Implies \-\-remove\&.)
-
+Remove the file from the index even when the working directory still has such a file. (Implies \-\-remove.)
.TP
\-\-replace
-By default, when a file path exists in the index, git\-update\-index refuses an attempt to add path/file\&. Similarly if a file path/file exists, a file path cannot be added\&. With \-\-replace flag, existing entries that conflicts with the entry being added are automatically removed with warning messages\&.
-
+By default, when a file
+path
+exists in the index, git\-update\-index refuses an attempt to add
+path/file. Similarly if a file
+path/file
+exists, a file
+path
+cannot be added. With \-\-replace flag, existing entries that conflicts with the entry being added are automatically removed with warning messages.
.TP
\-\-stdin
-Instead of taking list of paths from the command line, read list of paths from the standard input\&. Paths are separated by LF (i\&.e\&. one path per line) by default\&.
-
+Instead of taking list of paths from the command line, read list of paths from the standard input. Paths are separated by LF (i.e. one path per line) by default.
.TP
\-\-verbose
-Report what is being added and removed from index\&.
-
+Report what is being added and removed from index.
.TP
\-z
-Only meaningful with \-\-stdin; paths are separated with NUL character instead of LF\&.
-
+Only meaningful with
+\-\-stdin; paths are separated with NUL character instead of LF.
.TP
\-\-
-Do not interpret any more arguments as options\&.
-
+Do not interpret any more arguments as options.
.TP
<file>
-Files to act on\&. Note that files beginning with \fI\&.\fR are discarded\&. This includes \&./file and dir/\&./file\&. If you don't want this, then use cleaner names\&. The same applies to directories ending \fI/\fR and paths with \fI//\fR
-
-.SH "USING --REFRESH"
-
-
-\fI\-\-refresh\fR does not calculate a new sha1 file or bring the index up\-to\-date for mode/content changes\&. But what it \fIdoes\fR do is to "re\-match" the stat information of a file with the index, so that you can refresh the index for a file that hasn't been changed but where the stat entry is out of date\&.
-
-
-For example, you'd want to do this after doing a "git\-read\-tree", to link up the stat index details with the proper files\&.
-
-.SH "USING --CACHEINFO OR --INFO-ONLY"
-
-
-\fI\-\-cacheinfo\fR is used to register a file that is not in the current working directory\&. This is useful for minimum\-checkout merging\&.
-
-
+Files to act on. Note that files beginning with
+\fI.\fR
+are discarded. This includes
+./file
+and
+dir/./file. If you don't want this, then use cleaner names. The same applies to directories ending
+\fI/\fR
+and paths with
+\fI//\fR
+.SH "USING \-\-REFRESH"
+\fI\-\-refresh\fR does not calculate a new sha1 file or bring the index up\-to\-date for mode/content changes. But what it \fBdoes\fR do is to "re\-match" the stat information of a file with the index, so that you can refresh the index for a file that hasn't been changed but where the stat entry is out of date.
+.sp
+For example, you'd want to do this after doing a "git\-read\-tree", to link up the stat index details with the proper files.
+.sp
+.SH "USING \-\-CACHEINFO OR \-\-INFO\-ONLY"
+\fI\-\-cacheinfo\fR is used to register a file that is not in the current working directory. This is useful for minimum\-checkout merging.
+.sp
To pretend you have a file with mode and sha1 at path, say:
-
+.sp
+.sp
.nf
$ git\-update\-index \-\-cacheinfo mode sha1 path
.fi
-
-
-\fI\-\-info\-only\fR is used to register files without placing them in the object database\&. This is useful for status\-only repositories\&.
-
-
-Both \fI\-\-cacheinfo\fR and \fI\-\-info\-only\fR behave similarly: the index is updated but the object database isn't\&. \fI\-\-cacheinfo\fR is useful when the object is in the database but the file isn't available locally\&. \fI\-\-info\-only\fR is useful when the file is available, but you do not wish to update the object database\&.
-
-.SH "USING --INDEX-INFO"
-
-
-\-\-index\-info is a more powerful mechanism that lets you feed multiple entry definitions from the standard input, and designed specifically for scripts\&. It can take inputs of three formats:
-
+\fI\-\-info\-only\fR is used to register files without placing them in the object database. This is useful for status\-only repositories.
+.sp
+Both \fI\-\-cacheinfo\fR and \fI\-\-info\-only\fR behave similarly: the index is updated but the object database isn't. \fI\-\-cacheinfo\fR is useful when the object is in the database but the file isn't available locally. \fI\-\-info\-only\fR is useful when the file is available, but you do not wish to update the object database.
+.sp
+.SH "USING \-\-INDEX\-INFO"
+\-\-index\-info is a more powerful mechanism that lets you feed multiple entry definitions from the standard input, and designed specifically for scripts. It can take inputs of three formats:
+.sp
.TP 3
1.
mode SP sha1 TAB path
-
-The first format is what "git\-apply \-\-index\-info" reports, and used to reconstruct a partial tree that is used for phony merge base tree when falling back on 3\-way merge\&.
+.sp
+The first format is what "git\-apply \-\-index\-info" reports, and used to reconstruct a partial tree that is used for phony merge base tree when falling back on 3\-way merge.
.TP
2.
mode SP type SP sha1 TAB path
-
-The second format is to stuff git\-ls\-tree output into the index file\&.
+.sp
+The second format is to stuff git\-ls\-tree output into the index file.
.TP
3.
mode SP sha1 SP stage TAB path
-
-This format is to put higher order stages into the index file and matches git\-ls\-files \-\-stage output\&.
-.LP
-
-
-To place a higher stage entry to the index, the path should first be removed by feeding a mode=0 entry for the path, and then feeding necessary input lines in the third format\&.
-
-
+.sp
+This format is to put higher order stages into the index file and matches git\-ls\-files \-\-stage output.
+To place a higher stage entry to the index, the path should first be removed by feeding a mode=0 entry for the path, and then feeding necessary input lines in the third format.
+.sp
For example, starting with this index:
-
+.sp
+.sp
.nf
$ git ls\-files \-s
100644 8a1218a1024a212bb3db30becd860315f9f3ac52 0 frotz
.fi
-
-
you can feed the following input to \-\-index\-info:
-
+.sp
+.sp
.nf
$ git update\-index \-\-index\-info
0 0000000000000000000000000000000000000000 frotz
100644 8a1218a1024a212bb3db30becd860315f9f3ac52 1 frotz
100755 8a1218a1024a212bb3db30becd860315f9f3ac52 2 frotz
.fi
-
-
-The first line of the input feeds 0 as the mode to remove the path; the SHA1 does not matter as long as it is well formatted\&. Then the second and third line feeds stage 1 and stage 2 entries for that path\&. After the above, we would end up with this:
-
+The first line of the input feeds 0 as the mode to remove the path; the SHA1 does not matter as long as it is well formatted. Then the second and third line feeds stage 1 and stage 2 entries for that path. After the above, we would end up with this:
+.sp
+.sp
.nf
$ git ls\-files \-s
100644 8a1218a1024a212bb3db30becd860315f9f3ac52 1 frotz
100755 8a1218a1024a212bb3db30becd860315f9f3ac52 2 frotz
.fi
-
.SH "USING "ASSUME UNCHANGED" BIT"
-
-
-Many operations in git depend on your filesystem to have an efficient lstat(2) implementation, so that st_mtime information for working tree files can be cheaply checked to see if the file contents have changed from the version recorded in the index file\&. Unfortunately, some filesystems have inefficient lstat(2)\&. If your filesystem is one of them, you can set "assume unchanged" bit to paths you have not changed to cause git not to do this check\&. Note that setting this bit on a path does not mean git will check the contents of the file to see if it has changed -- it makes git to omit any checking and assume it has \fInot\fR changed\&. When you make changes to working tree files, you have to explicitly tell git about it by dropping "assume unchanged" bit, either before or after you modify them\&.
-
-
-In order to set "assume unchanged" bit, use \-\-assume\-unchanged option\&. To unset, use \-\-no\-assume\-unchanged\&.
-
-
-The command looks at core\&.ignorestat configuration variable\&. When this is true, paths updated with git\-update\-index paths... and paths updated with other git commands that update both index and working tree (e\&.g\&. git\-apply \-\-index, git\-checkout\-index \-u, and git\-read\-tree \-u) are automatically marked as "assume unchanged"\&. Note that "assume unchanged" bit is \fInot\fR set if git\-update\-index \-\-refresh finds the working tree file matches the index (use git\-update\-index \-\-really\-refresh if you want to mark them as "assume unchanged")\&.
-
+Many operations in git depend on your filesystem to have an efficient lstat(2) implementation, so that st_mtime information for working tree files can be cheaply checked to see if the file contents have changed from the version recorded in the index file. Unfortunately, some filesystems have inefficient lstat(2). If your filesystem is one of them, you can set "assume unchanged" bit to paths you have not changed to cause git not to do this check. Note that setting this bit on a path does not mean git will check the contents of the file to see if it has changed \(em it makes git to omit any checking and assume it has \fBnot\fR changed. When you make changes to working tree files, you have to explicitly tell git about it by dropping "assume unchanged" bit, either before or after you modify them.
+.sp
+In order to set "assume unchanged" bit, use \-\-assume\-unchanged option. To unset, use \-\-no\-assume\-unchanged.
+.sp
+The command looks at core.ignorestat configuration variable. When this is true, paths updated with git\-update\-index paths\&... and paths updated with other git commands that update both index and working tree (e.g. git\-apply \-\-index, git\-checkout\-index \-u, and git\-read\-tree \-u) are automatically marked as "assume unchanged". Note that "assume unchanged" bit is \fBnot\fR set if git\-update\-index \-\-refresh finds the working tree file matches the index (use git\-update\-index \-\-really\-refresh if you want to mark them as "assume unchanged").
+.sp
.SH "EXAMPLES"
-
-
To update and refresh only the files already checked out:
-
+.sp
+.sp
.nf
$ git\-checkout\-index \-n \-f \-a && git\-update\-index \-\-ignore\-missing \-\-refresh
.fi
-
.TP
-On an inefficient filesystem with core\&.ignorestat set
-
+On an inefficient filesystem with core.ignorestat set
+.sp
.nf
$ git update\-index \-\-really\-refresh \fB(1)\fR
-$ git update\-index \-\-no\-assume\-unchanged foo\&.c \fB(2)\fR
+$ git update\-index \-\-no\-assume\-unchanged foo.c \fB(2)\fR
$ git diff \-\-name\-only \fB(3)\fR
-$ edit foo\&.c
+$ edit foo.c
$ git diff \-\-name\-only \fB(4)\fR
-M foo\&.c
-$ git update\-index foo\&.c \fB(5)\fR
+M foo.c
+$ git update\-index foo.c \fB(5)\fR
$ git diff \-\-name\-only \fB(6)\fR
-$ edit foo\&.c
+$ edit foo.c
$ git diff \-\-name\-only \fB(7)\fR
-$ git update\-index \-\-no\-assume\-unchanged foo\&.c \fB(8)\fR
+$ git update\-index \-\-no\-assume\-unchanged foo.c \fB(8)\fR
$ git diff \-\-name\-only \fB(9)\fR
-M foo\&.c
+M foo.c
.fi
.sp
-\fB1. \fRforces lstat(2) to set "assume unchanged" bits for paths that match index\&.
+\fB1. \fRforces lstat(2) to set "assume unchanged" bits for paths that match index.
.br
-\fB2. \fRmark the path to be edited\&.
+\fB2. \fRmark the path to be edited.
.br
-\fB3. \fRthis does lstat(2) and finds index matches the path\&.
+\fB3. \fRthis does lstat(2) and finds index matches the path.
.br
-\fB4. \fRthis does lstat(2) and finds index does \fInot\fR match the path\&.
+\fB4. \fRthis does lstat(2) and finds index does
+\fBnot\fR
+match the path.
.br
-\fB5. \fRregistering the new version to index sets "assume unchanged" bit\&.
+\fB5. \fRregistering the new version to index sets "assume unchanged" bit.
.br
-\fB6. \fRand it is assumed unchanged\&.
+\fB6. \fRand it is assumed unchanged.
.br
-\fB7. \fReven after you edit it\&.
+\fB7. \fReven after you edit it.
.br
-\fB8. \fRyou can tell about the change after the fact\&.
+\fB8. \fRyou can tell about the change after the fact.
.br
-\fB9. \fRnow it checks with lstat(2) and finds it has been changed\&.
+\fB9. \fRnow it checks with lstat(2) and finds it has been changed.
.br
-
-
.SH "CONFIGURATION"
-
-
-The command honors core\&.filemode configuration variable\&. If your repository is on an filesystem whose executable bits are unreliable, this should be set to \fIfalse\fR (see \fBgit\-repo\-config\fR(1))\&. This causes the command to ignore differences in file modes recorded in the index and the file mode on the filesystem if they differ only on executable bit\&. On such an unfortunate filesystem, you may need to use git\-update\-index \-\-chmod=\&.
-
-
-The command looks at core\&.ignorestat configuration variable\&. See \fIUsing "assume unchanged" bit\fR section above\&.
-
+The command honors core.filemode configuration variable. If your repository is on an filesystem whose executable bits are unreliable, this should be set to \fIfalse\fR (see \fBgit\-repo\-config\fR(1)). This causes the command to ignore differences in file modes recorded in the index and the file mode on the filesystem if they differ only on executable bit. On such an unfortunate filesystem, you may need to use git\-update\-index \-\-chmod=.
+.sp
+The command looks at core.ignorestat configuration variable. See \fIUsing "assume unchanged" bit\fR section above.
+.sp
.SH "SEE ALSO"
-
-
\fBgit\-repo\-config\fR(1)
-
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+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>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-UPDATE-REF" 1 "" "" ""
-.SH NAME
-git-update-ref \- update the object name stored in a ref safely
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-update\-ref \- update the object name stored in a ref safely
.SH "SYNOPSIS"
-
-
\fIgit\-update\-ref\fR [\-m <reason>] <ref> <newvalue> [<oldvalue>]
-
+.sp
.SH "DESCRIPTION"
-
-
-Given two arguments, stores the <newvalue> in the <ref>, possibly dereferencing the symbolic refs\&. E\&.g\&. git\-update\-ref HEAD <newvalue> updates the current branch head to the new object\&.
-
-
-Given three arguments, stores the <newvalue> in the <ref>, possibly dereferencing the symbolic refs, after verifying that the current value of the <ref> matches <oldvalue>\&. E\&.g\&. git\-update\-ref refs/heads/master <newvalue> <oldvalue> updates the master branch head to <newvalue> only if its current value is <oldvalue>\&.
-
-
-It also allows a "ref" file to be a symbolic pointer to another ref file by starting with the four\-byte header sequence of "ref:"\&.
-
-
-More importantly, it allows the update of a ref file to follow these symbolic pointers, whether they are symlinks or these "regular file symbolic refs"\&. It follows \fIreal\fR symlinks only if they start with "refs/": otherwise it will just try to read them and update them as a regular file (i\&.e\&. it will allow the filesystem to follow them, but will overwrite such a symlink to somewhere else with a regular filename)\&.
-
-
+Given two arguments, stores the <newvalue> in the <ref>, possibly dereferencing the symbolic refs. E.g. git\-update\-ref HEAD <newvalue> updates the current branch head to the new object.
+.sp
+Given three arguments, stores the <newvalue> in the <ref>, possibly dereferencing the symbolic refs, after verifying that the current value of the <ref> matches <oldvalue>. E.g. git\-update\-ref refs/heads/master <newvalue> <oldvalue> updates the master branch head to <newvalue> only if its current value is <oldvalue>.
+.sp
+It also allows a "ref" file to be a symbolic pointer to another ref file by starting with the four\-byte header sequence of "ref:".
+.sp
+More importantly, it allows the update of a ref file to follow these symbolic pointers, whether they are symlinks or these "regular file symbolic refs". It follows \fBreal\fR symlinks only if they start with "refs/": otherwise it will just try to read them and update them as a regular file (i.e. it will allow the filesystem to follow them, but will overwrite such a symlink to somewhere else with a regular filename).
+.sp
In general, using
-
+.sp
+.sp
.nf
git\-update\-ref HEAD "$head"
.fi
-
-
should be a _lot_ safer than doing
-
+.sp
+.sp
.nf
echo "$head" > "$GIT_DIR/HEAD"
.fi
-
-
-both from a symlink following standpoint \fIand\fR an error checking standpoint\&. The "refs/" rule for symlinks means that symlinks that point to "outside" the tree are safe: they'll be followed for reading but not for writing (so we'll never write through a ref symlink to some other tree, if you have copied a whole archive by creating a symlink tree)\&.
-
+both from a symlink following standpoint \fBand\fR an error checking standpoint. The "refs/" rule for symlinks means that symlinks that point to "outside" the tree are safe: they'll be followed for reading but not for writing (so we'll never write through a ref symlink to some other tree, if you have copied a whole archive by creating a symlink tree).
+.sp
.SH "LOGGING UPDATES"
-
-
-If config parameter "core\&.logAllRefUpdates" is true or the file "$GIT_DIR/logs/<ref>" exists then git\-update\-ref will append a line to the log file "$GIT_DIR/logs/<ref>" (dereferencing all symbolic refs before creating the log name) describing the change in ref value\&. Log lines are formatted as:
-
+If config parameter "core.logAllRefUpdates" is true or the file "$GIT_DIR/logs/<ref>" exists then git\-update\-ref will append a line to the log file "$GIT_DIR/logs/<ref>" (dereferencing all symbolic refs before creating the log name) describing the change in ref value. Log lines are formatted as:
+.sp
.TP 3
1.
oldsha1 SP newsha1 SP committer LF
-
-Where "oldsha1" is the 40 character hexadecimal value previously stored in <ref>, "newsha1" is the 40 character hexadecimal value of <newvalue> and "committer" is the committer's name, email address and date in the standard GIT committer ident format\&.
-.LP
-
-
+.sp
+Where "oldsha1" is the 40 character hexadecimal value previously stored in <ref>, "newsha1" is the 40 character hexadecimal value of <newvalue> and "committer" is the committer's name, email address and date in the standard GIT committer ident format.
Optionally with \-m:
-
+.sp
.TP 3
1.
oldsha1 SP newsha1 SP committer TAB message LF
-
-Where all fields are as described above and "message" is the value supplied to the \-m option\&.
-.LP
-
-
-An update will fail (without changing <ref>) if the current user is unable to create a new log file, append to the existing log file or does not have committer information available\&.
-
+.sp
+Where all fields are as described above and "message" is the value supplied to the \-m option.
+An update will fail (without changing <ref>) if the current user is unable to create a new log file, append to the existing log file or does not have committer information available.
+.sp
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>\&.
-
+Written by Linus Torvalds <torvalds@osdl.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-UPDATE-SERVER" 1 "" "" ""
-.SH NAME
-git-update-server-info \- Update auxiliary info file to help dumb servers
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+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\&.
-
+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\&.
-
+Update the info files from scratch.
.SH "OUTPUT"
-
-
-Currently the command updates the following files\&. Please see repository\-layout: \fIrepository-layout.html\fR for description of what they are for:
-
+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
.TP
\(bu
info/refs
-.LP
-
.SH "BUGS"
-
-
-When you remove an existing ref, the command fails to update info/refs file unless \-\-force flag is given\&.
-
+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>
-
+Written by Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano\&.
-
+Documentation by Junio C Hamano.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
+.SH "REFERENCES"
+.TP 3
+1.\ repository\-layout
+\%repository\-layout.html
.\" 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" "09/17/2006" "" ""
+.TH "GIT\-UPLOAD\-ARCHIVE" "1" "10/03/2006" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-UPLOAD-PACK" 1 "" "" ""
-.SH NAME
-git-upload-pack \- Send missing objects packed
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-upload\-pack \- Send missing objects packed
.SH "SYNOPSIS"
-
-
\fIgit\-upload\-pack\fR <directory>
-
+.sp
.SH "DESCRIPTION"
-
-
-Invoked by \fIgit\-fetch\-pack\fR, learns what objects the other side is missing, and sends them after packing\&.
-
-
-This command is usually not invoked directly by the end user\&. The UI for the protocol is on the \fIgit\-fetch\-pack\fR side, and the program pair is meant to be used to pull updates from a remote repository\&. For push operations, see \fIgit\-send\-pack\fR\&.
-
+Invoked by \fIgit\-fetch\-pack\fR, learns what objects the other side is missing, and sends them after packing.
+.sp
+This command is usually not invoked directly by the end user. The UI for the protocol is on the \fIgit\-fetch\-pack\fR side, and the program pair is meant to be used to pull updates from a remote repository. For push operations, see \fIgit\-send\-pack\fR.
+.sp
.SH "OPTIONS"
-
.TP
<directory>
-The repository to sync from\&.
-
+The repository to sync from.
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+Written by Linus Torvalds <torvalds@osdl.org>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Junio C Hamano\&.
-
+Documentation by Junio C Hamano.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-VAR" 1 "" "" ""
-.SH NAME
-git-var \- Print the git users identity
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-var \- Print the git users identity
.SH "SYNOPSIS"
-
-
\fIgit\-var\fR [ \-l | <variable> ]
-
+.sp
.SH "DESCRIPTION"
-
-
-Prints a git logical variable\&.
-
+Prints a git logical variable.
+.sp
.SH "OPTIONS"
-
.TP
\-l
-Cause the logical variables to be listed\&. In addition, all the variables of the git configuration file \&.git/config are listed as well\&. (However, the configuration variables listing functionality is deprecated in favor of git\-repo\-config \-l\&.)
-
+Cause the logical variables to be listed. In addition, all the variables of the git configuration file .git/config are listed as well. (However, the configuration variables listing functionality is deprecated in favor of
+git\-repo\-config \-l.)
.SH "EXAMPLE"
-
+.sp
.nf
$ git\-var GIT_AUTHOR_IDENT
-Eric W\&. Biederman <ebiederm@lnxi\&.com> 1121223278 \-0600
+Eric W. Biederman <ebiederm@lnxi.com> 1121223278 \-0600
.fi
-
.SH "VARIABLES"
-
.TP
GIT_AUTHOR_IDENT
-The author of a piece of code\&.
-
+The author of a piece of code.
.TP
GIT_COMMITTER_IDENT
-The person who put a piece of code into git\&.
-
+The person who put a piece of code into git.
.SH "DIAGNOSTICS"
-
.TP
-You don't exist\&. Go away!
+You don't exist. Go away!
The passwd(5) gecos field couldn't be read
-
.TP
Your parents must have hated you!
-The password(5) gecos field is longer than a giant static buffer\&.
-
+The password(5) gecos field is longer than a giant static buffer.
.TP
Your sysadmin must hate you!
-The password(5) name field is longer than a giant static buffer\&.
-
+The password(5) name field is longer than a giant static buffer.
.SH "SEE ALSO"
-
-
\fBgit\-commit\-tree\fR(1) \fBgit\-tag\fR(1) \fBgit\-repo\-config\fR(1)
-
+.sp
.SH "AUTHOR"
-
-
-Written by Eric Biederman <ebiederm@xmission\&.com>
-
+Written by Eric Biederman <ebiederm@xmission.com>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by Eric Biederman and the git\-list <git@vger\&.kernel\&.org>\&.
-
+Documentation by Eric Biederman and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-VERIFY-PACK" 1 "" "" ""
-.SH NAME
-git-verify-pack \- Validate packed git archive files
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-verify\-pack \- Validate packed git archive files
.SH "SYNOPSIS"
-
-
-\fIgit\-verify\-pack\fR [\-v] [\-\-] <pack>\&.idx ...
-
+\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\&.
-
+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 ...
-The idx files to verify\&.
-
+<pack>.idx \&...
+The idx files to verify.
.TP
\-v
-After verifying the pack, show list of objects contained in the pack\&.
-
+After verifying the pack, show list of objects contained in the pack.
.TP
\-\-
-Do not interpret any more arguments as options\&.
-
+Do not interpret any more arguments as options.
.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\&.
-
+for objects that are deltified.
+.sp
.SH "AUTHOR"
-
-
-Written by Junio C Hamano <junkio@cox\&.net>
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-VERIFY-TAG" 1 "" "" ""
-.SH NAME
-git-verify-tag \- Check the GPG signature of tag
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+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\&.
-
+Validates the gpg signature created by git\-tag.
+.sp
.SH "OPTIONS"
-
.TP
<tag>
-SHA1 identifier of a git tag object\&.
-
+SHA1 identifier of a git tag object.
.SH "AUTHOR"
-
-
-Written by Jan Harkes <jaharkes@cs\&.cmu\&.edu> and Eric W\&. Biederman <ebiederm@xmission\&.com>
-
+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>\&.
-
+Documentation by Junio C Hamano and the git\-list <git@vger.kernel.org>.
+.sp
.SH "GIT"
-
-
Part of the \fBgit\fR(7) suite
-
+.sp
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-WHATCHANGED" 1 "" "" ""
-.SH NAME
-git-whatchanged \- Show logs with difference each commit introduces
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-whatchanged \- Show logs with difference each commit introduces
.SH "SYNOPSIS"
-
-
-\fIgit\-whatchanged\fR <option>...
-
+\fIgit\-whatchanged\fR <option>\&...
+.sp
.SH "DESCRIPTION"
-
-
-Shows commit logs and diff output each commit introduces\&. The command internally invokes \fIgit\-rev\-list\fR piped to \fIgit\-diff\-tree\fR, and takes command line options for both of these commands\&.
-
-
-This manual page describes only the most frequently used options\&.
-
+Shows commit logs and diff output each commit introduces. The command internally invokes \fIgit\-rev\-list\fR piped to \fIgit\-diff\-tree\fR, and takes command line options for both of these commands.
+.sp
+This manual page describes only the most frequently used options.
+.sp
.SH "OPTIONS"
-
.TP
\-p
-Show textual diffs, instead of the git internal diff output format that is useful only to tell the changed paths and their nature of changes\&.
-
+Show textual diffs, instead of the git internal diff output format that is useful only to tell the changed paths and their nature of changes.
.TP
\-\-max\-count=<n>
-Limit output to <n> commits\&.
-
+Limit output to <n> commits.
.TP
-<since>\&.\&.<until>
-Limit output to between the two named commits (bottom exclusive, top inclusive)\&.
-
+<since>..<until>
+Limit output to between the two named commits (bottom exclusive, top inclusive).
.TP
\-r
-Show git internal diff output, but for the whole tree, not just the top level\&.
-
+Show git internal diff output, but for the whole tree, not just the top level.
.TP
\-\-pretty=<format>
-Controls the output format for the commit logs\&. <format> can be one of \fIraw\fR, \fImedium\fR, \fIshort\fR, \fIfull\fR, and \fIoneline\fR\&.
-
+Controls the output format for the commit logs. <format> can be one of
+\fIraw\fR,
+\fImedium\fR,
+\fIshort\fR,
+\fIfull\fR, and
+\fIoneline\fR.
.TP
\-m
-By default, differences for merge commits are not shown\&. With this flag, show differences to that commit from all of its parents\&.
-
-However, it is not very useful in general, although it \fIis\fR useful on a file\-by\-file basis\&.
-
+By default, differences for merge commits are not shown. With this flag, show differences to that commit from all of its parents.
+.sp
+However, it is not very useful in general, although it
+\fBis\fR
+useful on a file\-by\-file basis.
.SH "EXAMPLES"
-
.TP
-git\-whatchanged \-p v2\&.6\&.12\&.\&. include/scsi drivers/scsi
-Show as patches the commits since version \fIv2\&.6\&.12\fR that changed any file in the include/scsi or drivers/scsi subdirectories
-
+git\-whatchanged \-p v2.6.12.. include/scsi drivers/scsi
+Show as patches the commits since version
+\fIv2.6.12\fR
+that changed any file in the include/scsi or drivers/scsi subdirectories
.TP
git\-whatchanged \-\-since="2 weeks ago" \-\- gitk
-Show the changes during the last two weeks to the file \fIgitk\fR\&. The "\-\-" is necessary to avoid confusion with the \fIbranch\fR named \fIgitk\fR
-
+Show the changes during the last two weeks to the file
+\fIgitk\fR. The "\-\-" is necessary to avoid confusion with the
+\fBbranch\fR
+named
+\fIgitk\fR
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org> and Junio C Hamano <junkio@cox\&.net>
-
+Written by Linus Torvalds <torvalds@osdl.org> and Junio C Hamano <junkio@cox.net>
+.sp
.SH "DOCUMENTATION"
-
-
-Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
-
+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
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GIT-WRITE-TREE" 1 "" "" ""
-.SH NAME
-git-write-tree \- Creates a tree object from the current index
+.\" ** You probably do not want to edit this file directly **
+.\" 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" "10/03/2006" "" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+git\-write\-tree \- Creates a tree object from the current index
.SH "SYNOPSIS"
-
-
\fIgit\-write\-tree\fR [\-\-missing\-ok] [\-\-prefix=<prefix>/]
-
+.sp
.SH "DESCRIPTION"
-
-
-Creates a tree object using the current index\&.
-
-
-The index must be in a fully merged state\&.
-
-
-Conceptually, git\-write\-tree sync()s the current index contents into a set of tree files\&. In order to have that match what is actually in your directory right now, you need to have done a git\-update\-index phase before you did the git\-write\-tree\&.
-
+Creates a tree object using the current index.
+.sp
+The index must be in a fully merged state.
+.sp
+Conceptually, git\-write\-tree sync()s the current index contents into a set of tree files. In order to have that match what is actually in your directory right now, you need to have done a git\-update\-index phase before you did the git\-write\-tree.
+.sp
.SH "OPTIONS"
-
.TP
\-\-missing\-ok
-Normally git\-write\-tree ensures that the objects referenced by the directory exist in the object database\&. This option disables this check\&.
-
+Normally
+git\-write\-tree
+ensures that the objects referenced by the directory exist in the object database. This option disables this check.
.TP
\-\-prefix=<prefix>/
-Writes a tree object that represents a subdirectory <prefix>\&. This can be used to write the tree object for a subproject that is in the named subdirectory\&.
-
+Writes a tree object that represents a subdirectory
+<prefix>. This can be used to write the tree object for a subproject that is in the named subdirectory.
.SH "AUTHOR"
-
-
-Written by Linus Torvalds <torvalds@osdl\&.org>
-
+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>\&.
-
+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 "GITK" "1" "09/20/2006" "" ""
+.TH "GITK" "1" "10/03/2006" "" ""
.\" 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" "09/26/2006" "" ""
+.TH "GIT" "7" "10/03/2006" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)