Autogenerated man pages for v1.4.1-ga3e6
authorJunio C Hamano <junio@hera.kernel.org>
Sat, 15 Jul 2006 01:42:05 +0000 (01:42 +0000)
committerJunio C Hamano <junio@hera.kernel.org>
Sat, 15 Jul 2006 01:42:05 +0000 (01:42 +0000)
26 files changed:
man1/git-applymbox.1
man1/git-bisect.1
man1/git-commit-tree.1
man1/git-convert-objects.1
man1/git-fetch.1
man1/git-fmt-merge-msg.1
man1/git-http-fetch.1
man1/git-index-pack.1
man1/git-local-fetch.1
man1/git-ls-files.1
man1/git-merge-one-file.1
man1/git-mktag.1
man1/git-name-rev.1
man1/git-parse-remote.1
man1/git-pull.1
man1/git-push.1
man1/git-rerere.1
man1/git-resolve.1
man1/git-rev-list.1
man1/git-show-index.1
man1/git-ssh-fetch.1
man1/git-ssh-upload.1
man1/git-symbolic-ref.1
man1/git-unpack-file.1
man1/git-update-server-info.1
man7/git.7

index 498f0302d6b30c53cfc6dbf191a1550fa0f1f0aa..8f4b87c20ec6a75a54c3cb1f5535d30ce4f1a684 100755 (executable)
@@ -23,7 +23,7 @@ git-applymbox \- Apply a series of patches in a mailbox
 .SH "SYNOPSIS"
 
 
-git\-applymbox [\-u] [\-k] [\-q] [\-m] ( \-c \&.dotest/<num> | <mbox> ) [ <signoff> ]
+\fIgit\-applymbox\fR [\-u] [\-k] [\-q] [\-m] ( \-c \&.dotest/<num> | <mbox> ) [ <signoff> ]
 
 .SH "DESCRIPTION"
 
@@ -38,7 +38,7 @@ Apply patches interactively\&. The user will be given opportunity to edit the lo
 
 .TP
 \-k
-Usually the program cleans up the Subject: header line to extract the title line for the commit log message, among which (1) remove Re: or re:, (2) leading whitespaces, (3) [ up to ], typically [PATCH], and then prepends "[PATCH] "\&. This flag forbids this munging, and is most useful when used to read back git format\-patch \-\-mbox 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
@@ -50,15 +50,15 @@ By default, the commit log message, author name and author email are taken from
 
 .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 git applymbox with \-c \&.dotest/<num> flag to restart the process after inspecting and fixing them\&.
+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 SubmittingPatches 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 SubmittingPatches document to learn what "Signed\-off\-by" line means\&. You can also just say yes, true, me, or please 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"
 
index d42f7e92a028b426aab06756e68ab5772affd8de..3d6aed3a801e95fa2c90e846124c1f96ae1ad30c 100755 (executable)
@@ -23,7 +23,7 @@ git-bisect \- Find the change that introduced a bug
 .SH "SYNOPSIS"
 
 
-git bisect <subcommand> <options>
+\fIgit bisect\fR <subcommand> <options>
 
 .SH "DESCRIPTION"
 
@@ -41,31 +41,39 @@ git bisect log
 .fi
 
 
-This command uses git\-rev\-list \-\-bisect 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\&.
 
 
 The way you use it is:
 
-.IP
+.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
                                         # 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:
 
-.IP
+.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
 
-.IP
+.nf
 $ git bisect good                       # this one is good
+.fi
+
 
 which will now say
 
-.IP
+.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\&.
 
@@ -75,44 +83,54 @@ Until you have no more left, and you'll have been left with the first bad kernel
 
 Oh, and then after you want to reset to the original head, do a
 
-.IP
+.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)\&.
 
 
 During the bisection process, you can say
 
-.IP
+.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
 
-.IP
+.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:
 
-.IP
+.nf
 $ 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 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\&.
 
 
 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:
 
-.IP
+.nf
 $ git bisect start arch/i386 include/asm\-i386
+.fi
+
 .SH "AUTHOR"
 
 
index 3129204d6c796534ed8c39042167292a682aeb53..3b688cb2e1a1f59beccf2c0771c7c14722c285d4 100755 (executable)
@@ -23,7 +23,7 @@ git-commit-tree \- Creates a new commit object
 .SH "SYNOPSIS"
 
 
-git\-commit\-tree <tree> [\-p <parent commit>]* < changelog
+\fIgit\-commit\-tree\fR <tree> [\-p <parent commit>]* < changelog
 
 .SH "DESCRIPTION"
 
@@ -47,7 +47,7 @@ An existing tree object
 
 .TP
 \-p <parent commit>
-Each \-p indicates the id of a parent commit object\&.
+Each \fI\-p\fR indicates the id of a parent commit object\&.
 
 .SH "COMMIT INFORMATION"
 
index 6cc4fbe8ce8dd54112f30460c4dc90dfd7d5ff63..a1092a3cf3f444f26889d2f6a5a8a8c91bb22454 100755 (executable)
@@ -23,7 +23,7 @@ git-convert-objects \- Converts old-style git repository
 .SH "SYNOPSIS"
 
 
-git\-convert\-objects
+\fIgit\-convert\-objects\fR
 
 .SH "DESCRIPTION"
 
index 5f357bab94e1c6e452f28020ee9a4040ccf5f463..c8cb223b525047124e70724af29d2f19d4e032cf 100755 (executable)
@@ -128,29 +128,29 @@ git://host\&.xz/path/to/repo\&.git/
 git://host\&.xz/~user/path/to/repo\&.git/
 .TP
 \(bu
-ssh://host\&.xz/path/to/repo\&.git/
+ssh://[user@]host\&.xz/path/to/repo\&.git/
 .TP
 \(bu
-ssh://host\&.xz/~user/path/to/repo\&.git/
+ssh://[user@]host\&.xz/~user/path/to/repo\&.git/
 .TP
 \(bu
-ssh://host\&.xz/~/path/to/repo\&.git
+ssh://[user@]host\&.xz/~/path/to/repo\&.git
 .LP
 
 
-SSH Is the default transport protocol and also supports an scp\-like syntax\&. Both syntaxes support username expansion, as does the native git protocol\&. The following three are identical to the last three above, respectively:
+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:
 
 .IP
 
 .TP 3
 \(bu
-host\&.xz:/path/to/repo\&.git/
+[user@]host\&.xz:/path/to/repo\&.git/
 .TP
 \(bu
-host\&.xz:~user/path/to/repo\&.git/
+[user@]host\&.xz:~user/path/to/repo\&.git/
 .TP
 \(bu
-host\&.xz:path/to/repo\&.git
+[user@]host\&.xz:path/to/repo\&.git
 .LP
 
 
index ed1be8c16a66d779a7236564f5320ae9a6cdd5cf..cb40d83228ef509b4845657ac607a85d13be3423 100755 (executable)
@@ -23,12 +23,12 @@ git-fmt-merge-msg \- Produce a merge commit message
 .SH "SYNOPSIS"
 
 
-git\-fmt\-merge\-msg <$GIT_DIR/FETCH_HEAD
+\fIgit\-fmt\-merge\-msg\fR <$GIT_DIR/FETCH_HEAD
 
 .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 <merge\-message> argument of 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\&.
 
 
 This script is intended mostly for internal use by scripts automatically invoking git\-merge\&.
index f9ffa7167d86a5d56b5dc818c664cbc28f893cd6..9420b843de5c347ac224bd7a7694bd0643e78664 100755 (executable)
@@ -23,7 +23,7 @@ git-http-fetch \- downloads a remote git repository via HTTP
 .SH "SYNOPSIS"
 
 
-git\-http\-fetch [\-c] [\-t] [\-a] [\-d] [\-v] [\-w filename] [\-\-recover] <commit> <url>
+\fIgit\-http\-fetch\fR [\-c] [\-t] [\-a] [\-d] [\-v] [\-w filename] [\-\-recover] <commit> <url>
 
 .SH "DESCRIPTION"
 
index 27bc5d422240f94f74e81f10767a44d070494456..9d9372fbe013a3a747f857fcbd3cba0350da3b75 100755 (executable)
@@ -23,7 +23,7 @@ git-index-pack \- Build pack index file for an existing packed archive
 .SH "SYNOPSIS"
 
 
-git\-index\-pack [\-o <index\-file>] <pack\-file>
+\fIgit\-index\-pack\fR [\-o <index\-file>] <pack\-file>
 
 .SH "DESCRIPTION"
 
index e56df205ef487c97a0dbf61ec326ce7bb944597d..153a2293c389a5d2e08f0cf2795a71d9fff2e29a 100755 (executable)
@@ -23,7 +23,7 @@ git-local-fetch \- Duplicates another git repository on a local system
 .SH "SYNOPSIS"
 
 
-git\-local\-fetch [\-c] [\-t] [\-a] [\-d] [\-v] [\-w filename] [\-\-recover] [\-l] [\-s] [\-n] commit\-id path
+\fIgit\-local\-fetch\fR [\-c] [\-t] [\-a] [\-d] [\-v] [\-w filename] [\-\-recover] [\-l] [\-s] [\-n] commit\-id path
 
 .SH "DESCRIPTION"
 
index b3b20f5d6d1b98d863df4454baa2c4af4a45d000..c8b35d3030c1d8127b1a8b038fd2e49ef17eea7d 100755 (executable)
@@ -229,7 +229,7 @@ otherwise, it is a shell glob pattern, suitable for consumption by fnmatch(3) wi
 An example:
 
 .nf
-    $ cat \&.git/ignore
+    $ cat \&.git/info/exclude
     # ignore objects and archives, anywhere in the tree\&.
     *\&.[oa]
     $ cat Documentation/\&.gitignore
@@ -239,7 +239,7 @@ An example:
     !foo\&.html
     $ git\-ls\-files \-\-ignored \\
         \-\-exclude='Documentation/*\&.[0\-9]' \\
-        \-\-exclude\-from=\&.git/ignore \\
+        \-\-exclude\-from=\&.git/info/exclude \\
         \-\-exclude\-per\-directory=\&.gitignore
 .fi
 
index 9033967513ed4f92d0ff172624abfd92c1e87383..29dc50de4c66995f2b2003e6ff27652b33d05ca2 100755 (executable)
@@ -23,7 +23,7 @@ git-merge-one-file \- The standard helper program to use with "git-merge-index"
 .SH "SYNOPSIS"
 
 
-git\-merge\-one\-file
+\fIgit\-merge\-one\-file\fR
 
 .SH "DESCRIPTION"
 
index 60758bc39a03ca87aad6557bd3d090d3a67d89c2..6a1f0df97c2396c0fd61108d8f289ed8d422edd3 100755 (executable)
@@ -23,7 +23,7 @@ git-mktag \- Creates a tag object
 .SH "SYNOPSIS"
 
 
-git\-mktag < signature_file
+\fIgit\-mktag\fR < signature_file
 
 .SH "DESCRIPTION"
 
@@ -45,7 +45,7 @@ tag <tagname>
 .fi
 
 
-followed by some optional free\-form signature that git itself doesn't care about, but that can be verified with gpg or similar\&.
+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)
index f08a5068dd520f10fb32327dd215e43db100ec97..5347b17c5aaa0134a5ebaae470b3699541024fbf 100755 (executable)
@@ -47,7 +47,7 @@ Read from stdin, append "(<rev_name>)" to all sha1's of nameable commits, and pa
 .SH "EXAMPLE"
 
 
-Given a commit, find out where it is relative to the local refs\&. Say somebody wrote you about that phantastic 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\&.
 
 
 Enter git\-name\-rev:
index de19a93c8be5f6ee0f292e161eca34f03e1ee610..c5544e5b8bcef357c93bbec539c00c3c193e4170 100755 (executable)
@@ -23,7 +23,7 @@ git-parse-remote \- Routines to help parsing $GIT_DIR/remotes/
 .SH "SYNOPSIS"
 
 
-\&. git\-parse\-remote
+\fI\&. git\-parse\-remote\fR
 
 .SH "DESCRIPTION"
 
index ca95476925a837d890a143a0512267d111656653..c9fcdf8b12f03f05eff7e04e30601a74481af6b9 100755 (executable)
@@ -144,29 +144,29 @@ git://host\&.xz/path/to/repo\&.git/
 git://host\&.xz/~user/path/to/repo\&.git/
 .TP
 \(bu
-ssh://host\&.xz/path/to/repo\&.git/
+ssh://[user@]host\&.xz/path/to/repo\&.git/
 .TP
 \(bu
-ssh://host\&.xz/~user/path/to/repo\&.git/
+ssh://[user@]host\&.xz/~user/path/to/repo\&.git/
 .TP
 \(bu
-ssh://host\&.xz/~/path/to/repo\&.git
+ssh://[user@]host\&.xz/~/path/to/repo\&.git
 .LP
 
 
-SSH Is the default transport protocol and also supports an scp\-like syntax\&. Both syntaxes support username expansion, as does the native git protocol\&. The following three are identical to the last three above, respectively:
+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:
 
 .IP
 
 .TP 3
 \(bu
-host\&.xz:/path/to/repo\&.git/
+[user@]host\&.xz:/path/to/repo\&.git/
 .TP
 \(bu
-host\&.xz:~user/path/to/repo\&.git/
+[user@]host\&.xz:~user/path/to/repo\&.git/
 .TP
 \(bu
-host\&.xz:path/to/repo\&.git
+[user@]host\&.xz:path/to/repo\&.git
 .LP
 
 
index 51c83b4b128dc559669574b8c7549cfb6829e919..8ba09e9fa9774519a9c2986b6d3b5fc8d1ddaacc 100755 (executable)
@@ -98,29 +98,29 @@ git://host\&.xz/path/to/repo\&.git/
 git://host\&.xz/~user/path/to/repo\&.git/
 .TP
 \(bu
-ssh://host\&.xz/path/to/repo\&.git/
+ssh://[user@]host\&.xz/path/to/repo\&.git/
 .TP
 \(bu
-ssh://host\&.xz/~user/path/to/repo\&.git/
+ssh://[user@]host\&.xz/~user/path/to/repo\&.git/
 .TP
 \(bu
-ssh://host\&.xz/~/path/to/repo\&.git
+ssh://[user@]host\&.xz/~/path/to/repo\&.git
 .LP
 
 
-SSH Is the default transport protocol and also supports an scp\-like syntax\&. Both syntaxes support username expansion, as does the native git protocol\&. The following three are identical to the last three above, respectively:
+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:
 
 .IP
 
 .TP 3
 \(bu
-host\&.xz:/path/to/repo\&.git/
+[user@]host\&.xz:/path/to/repo\&.git/
 .TP
 \(bu
-host\&.xz:~user/path/to/repo\&.git/
+[user@]host\&.xz:~user/path/to/repo\&.git/
 .TP
 \(bu
-host\&.xz:path/to/repo\&.git
+[user@]host\&.xz:path/to/repo\&.git
 .LP
 
 
index a277d0bc6800ca87e7b6949147d93895e56d1c4e..c56924f34723df26d2c1b7a5f313895ee190e248 100755 (executable)
@@ -46,27 +46,31 @@ You need to create $GIT_DIR/rr\-cache directory to enable this command\&.
 
 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:
 
-.IP
+.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:
 
-.IP
+.nf
         $ git checkout topic
         $ 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:
 
-.IP
+.nf
         $ git checkout topic
         $ git pull \&. master
         $ \&.\&.\&. work on both topic and master branches
@@ -76,13 +80,15 @@ After this test merge, there are two ways to continue your work on the 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"\&.
 
 
 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:
 
-.IP
+.nf
         $ git checkout topic
         $ git pull \&. master
         $ git reset \-\-hard HEAD^ ;# rewind the test merge
@@ -93,6 +99,8 @@ As an alternative, to keep the topic branch clean of test merges, you could blow
               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\&.
 
@@ -111,7 +119,7 @@ In our example, when you did the test merge, the manual resolution is recorded,
 
 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:
 
-.IP
+.nf
               o\-\-\-*\-\-\-o\-\-\-\-\-\-\-o\-\-\-o topic
              /
     o\-\-\-o\-\-\-o\-\-\-*\-\-\-o\-\-\-o\-\-\-o\-\-\-o   master
@@ -121,6 +129,8 @@ The information git\-rerere records is also used when running git\-rebase\&. Aft
                                   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\&.
 
index c3a21007b30db8e690e36a5deebb271e20f43f96..c1e53d15bad9e4f4f2e9ad706c7a1623a2efa8fb 100755 (executable)
@@ -23,7 +23,7 @@ git-resolve \- Merge two commits
 .SH "SYNOPSIS"
 
 
-git\-resolve <current> <merged> <message>
+\fIgit\-resolve\fR <current> <merged> <message>
 
 .SH "DESCRIPTION"
 
index ba4d409d13dffa5abbde987d513edcc997e34350..109ed4ea276a91352fda58e134a2ad5f5e1eab33 100755 (executable)
@@ -68,6 +68,10 @@ Print the contents of the commit changesets in human\-readable form\&.
 \-\-header
 Print the contents of the commit in raw\-format; each record is separated with a NUL character\&.
 
+.TP
+\-\-parents
+Print the parents of the commit\&.
+
 .TP
 \-\-objects
 Print the object IDs of any object referenced by the listed commits\&. \fIgit\-rev\-list \-\-objects foo ^bar\fR thus means "send me all object IDs which I need to download if I have the commit object \fIbar\fR, but not \fIfoo\fR"\&.
@@ -100,6 +104,10 @@ When optional paths are given, the command outputs only the commits that changes
 \-\-remove\-empty
 Stop when a given path disappears from the tree\&.
 
+.TP
+\-\-no\-merges
+Do not print commits with more than one parent\&.
+
 .TP
 \-\-not
 Reverses the meaning of the \fI^\fR prefix (or lack thereof) for all following revision specifiers, up to the next \-\-not\&.
index e807ace5a2ee5404bbd9322a1bcdbd1b56dda99c..f03cca1ec389c397cec2b339be68b9a50a2afac1 100755 (executable)
@@ -23,7 +23,7 @@ git-show-index \- Show packed archive index
 .SH "SYNOPSIS"
 
 
-git\-show\-index < idx\-file
+\fIgit\-show\-index\fR < idx\-file
 
 .SH "DESCRIPTION"
 
@@ -31,7 +31,7 @@ git\-show\-index < idx\-file
 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 git\-verify\-pack \-v; this command only shows the packfile offset and SHA1 of each object\&.
+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\&.
 
 .SH "AUTHOR"
 
index 0eee592e28c96018fa1fe7128d6125ca50ce22fe..30ded8647bbb86cec9ce4536701b7b420333d08f 100755 (executable)
@@ -23,7 +23,7 @@ git-ssh-fetch \- Pulls from a remote repository over ssh connection
 .SH "SYNOPSIS"
 
 
-git\-ssh\-fetch [\-c] [\-t] [\-a] [\-d] [\-v] [\-w filename] [\-\-recover] commit\-id url
+\fIgit\-ssh\-fetch\fR [\-c] [\-t] [\-a] [\-d] [\-v] [\-w filename] [\-\-recover] commit\-id url
 
 .SH "DESCRIPTION"
 
index ec1cc062445a9ee1e960ed2d797610bbcd0bd4a1..6ac58bd3fe2674b95810b2368998983ca8664a34 100755 (executable)
@@ -23,7 +23,7 @@ git-ssh-upload \- Pushes to a remote repository over ssh connection
 .SH "SYNOPSIS"
 
 
-git\-ssh\-upload [\-c] [\-t] [\-a] [\-d] [\-v] [\-w filename] [\-\-recover] commit\-id url
+\fIgit\-ssh\-upload\fR [\-c] [\-t] [\-a] [\-d] [\-v] [\-w filename] [\-\-recover] commit\-id url
 
 .SH "DESCRIPTION"
 
index 430607186aea4f893a091752cc6c3007914dd3de..2161ce9e736294e75a1e6550dbd250907850b671 100755 (executable)
@@ -23,7 +23,7 @@ git-symbolic-ref \- read and modify symbolic refs
 .SH "SYNOPSIS"
 
 
-git\-symbolic\-ref <name> [<ref>]
+\fIgit\-symbolic\-ref\fR <name> [<ref>]
 
 .SH "DESCRIPTION"
 
@@ -37,7 +37,7 @@ Give two arguments, create or update a symbolic ref <name> to point at the given
 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 can 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\&.
+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\&.
index 5d6104b04d8dfb9e90d192af364346a179f0dd15..c5deeded75e94f23345663018166b6cf48777f7b 100755 (executable)
@@ -23,7 +23,7 @@ git-unpack-file \- Creates a temporary file with a blob's contents
 .SH "SYNOPSIS"
 
 
-git\-unpack\-file <blob>
+\fIgit\-unpack\-file\fR <blob>
 
 .SH "DESCRIPTION"
 
index b727b9724f72044bd199a5286e0fa00b0c286fbe..a6ed8029b6c6a5fb880d39014cfe4bafec05ef7e 100755 (executable)
@@ -23,7 +23,7 @@ git-update-server-info \- Update auxiliary info file to help dumb servers
 .SH "SYNOPSIS"
 
 
-git\-update\-server\-info [\-\-force]
+\fIgit\-update\-server\-info\fR [\-\-force]
 
 .SH "DESCRIPTION"
 
index 4ad8b10031b5e3d23d448c19fb9c0506a23d3902..cffff4817757ac12e1355c92c4d0316e491589e1 100755 (executable)
@@ -690,6 +690,12 @@ see \fBgit\-commit\-tree\fR(1)
 \fIGIT_DIFF_OPTS\fR, \fIGIT_EXTERNAL_DIFF\fR
 see the "generating patches" section in : \fBgit\-diff\-index\fR(1); \fBgit\-diff\-files\fR(1); \fBgit\-diff\-tree\fR(1) 
 
+.SS "other"
+
+.TP
+\fIGIT_TRACE\fR
+If this variable is set git will print trace: messages on stderr telling about alias expansion, built\-in command execution and external command execution\&.
+
 .SH "DISCUSSION"