From 4fe702c74eccd3fa52f0c5f39e017635b638a33e Mon Sep 17 00:00:00 2001 From: Junio C Hamano Date: Sat, 15 Jul 2006 01:42:05 +0000 Subject: [PATCH] Autogenerated man pages for v1.4.1-ga3e6 --- man1/git-applymbox.1 | 10 ++++----- man1/git-bisect.1 | 40 +++++++++++++++++++++++++---------- man1/git-commit-tree.1 | 4 ++-- man1/git-convert-objects.1 | 2 +- man1/git-fetch.1 | 14 ++++++------ man1/git-fmt-merge-msg.1 | 4 ++-- man1/git-http-fetch.1 | 2 +- man1/git-index-pack.1 | 2 +- man1/git-local-fetch.1 | 2 +- man1/git-ls-files.1 | 4 ++-- man1/git-merge-one-file.1 | 2 +- man1/git-mktag.1 | 4 ++-- man1/git-name-rev.1 | 2 +- man1/git-parse-remote.1 | 2 +- man1/git-pull.1 | 14 ++++++------ man1/git-push.1 | 14 ++++++------ man1/git-rerere.1 | 20 +++++++++++++----- man1/git-resolve.1 | 2 +- man1/git-rev-list.1 | 8 +++++++ man1/git-show-index.1 | 4 ++-- man1/git-ssh-fetch.1 | 2 +- man1/git-ssh-upload.1 | 2 +- man1/git-symbolic-ref.1 | 4 ++-- man1/git-unpack-file.1 | 2 +- man1/git-update-server-info.1 | 2 +- man7/git.7 | 6 ++++++ 26 files changed, 108 insertions(+), 66 deletions(-) diff --git a/man1/git-applymbox.1 b/man1/git-applymbox.1 index 498f0302d..8f4b87c20 100755 --- a/man1/git-applymbox.1 +++ b/man1/git-applymbox.1 @@ -23,7 +23,7 @@ git-applymbox \- Apply a series of patches in a mailbox .SH "SYNOPSIS" -git\-applymbox [\-u] [\-k] [\-q] [\-m] ( \-c \&.dotest/ | ) [ ] +\fIgit\-applymbox\fR [\-u] [\-k] [\-q] [\-m] ( \-c \&.dotest/ | ) [ ] .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/ -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/ 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/\fR flag to restart the process after inspecting and fixing them\&. .TP -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 -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" diff --git a/man1/git-bisect.1 b/man1/git-bisect.1 index d42f7e92a..3d6aed3a8 100755 --- a/man1/git-bisect.1 +++ b/man1/git-bisect.1 @@ -23,7 +23,7 @@ git-bisect \- Find the change that introduced a bug .SH "SYNOPSIS" -git bisect +\fIgit bisect\fR .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" diff --git a/man1/git-commit-tree.1 b/man1/git-commit-tree.1 index 3129204d6..3b688cb2e 100755 --- a/man1/git-commit-tree.1 +++ b/man1/git-commit-tree.1 @@ -23,7 +23,7 @@ git-commit-tree \- Creates a new commit object .SH "SYNOPSIS" -git\-commit\-tree [\-p ]* < changelog +\fIgit\-commit\-tree\fR [\-p ]* < changelog .SH "DESCRIPTION" @@ -47,7 +47,7 @@ An existing tree object .TP \-p -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" diff --git a/man1/git-convert-objects.1 b/man1/git-convert-objects.1 index 6cc4fbe8c..a1092a3cf 100755 --- a/man1/git-convert-objects.1 +++ b/man1/git-convert-objects.1 @@ -23,7 +23,7 @@ git-convert-objects \- Converts old-style git repository .SH "SYNOPSIS" -git\-convert\-objects +\fIgit\-convert\-objects\fR .SH "DESCRIPTION" diff --git a/man1/git-fetch.1 b/man1/git-fetch.1 index 5f357bab9..c8cb223b5 100755 --- a/man1/git-fetch.1 +++ b/man1/git-fetch.1 @@ -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 diff --git a/man1/git-fmt-merge-msg.1 b/man1/git-fmt-merge-msg.1 index ed1be8c16..cb40d8322 100755 --- a/man1/git-fmt-merge-msg.1 +++ b/man1/git-fmt-merge-msg.1 @@ -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 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\fR argument of git\-merge\&. This script is intended mostly for internal use by scripts automatically invoking git\-merge\&. diff --git a/man1/git-http-fetch.1 b/man1/git-http-fetch.1 index f9ffa7167..9420b843d 100755 --- a/man1/git-http-fetch.1 +++ b/man1/git-http-fetch.1 @@ -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] +\fIgit\-http\-fetch\fR [\-c] [\-t] [\-a] [\-d] [\-v] [\-w filename] [\-\-recover] .SH "DESCRIPTION" diff --git a/man1/git-index-pack.1 b/man1/git-index-pack.1 index 27bc5d422..9d9372fbe 100755 --- a/man1/git-index-pack.1 +++ b/man1/git-index-pack.1 @@ -23,7 +23,7 @@ git-index-pack \- Build pack index file for an existing packed archive .SH "SYNOPSIS" -git\-index\-pack [\-o ] +\fIgit\-index\-pack\fR [\-o ] .SH "DESCRIPTION" diff --git a/man1/git-local-fetch.1 b/man1/git-local-fetch.1 index e56df205e..153a2293c 100755 --- a/man1/git-local-fetch.1 +++ b/man1/git-local-fetch.1 @@ -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" diff --git a/man1/git-ls-files.1 b/man1/git-ls-files.1 index b3b20f5d6..c8b35d303 100755 --- a/man1/git-ls-files.1 +++ b/man1/git-ls-files.1 @@ -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 diff --git a/man1/git-merge-one-file.1 b/man1/git-merge-one-file.1 index 903396751..29dc50de4 100755 --- a/man1/git-merge-one-file.1 +++ b/man1/git-merge-one-file.1 @@ -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" diff --git a/man1/git-mktag.1 b/man1/git-mktag.1 index 60758bc39..6a1f0df97 100755 --- a/man1/git-mktag.1 +++ b/man1/git-mktag.1 @@ -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 .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) diff --git a/man1/git-name-rev.1 b/man1/git-name-rev.1 index f08a5068d..5347b17c5 100755 --- a/man1/git-name-rev.1 +++ b/man1/git-name-rev.1 @@ -47,7 +47,7 @@ Read from stdin, append "()" 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: diff --git a/man1/git-parse-remote.1 b/man1/git-parse-remote.1 index de19a93c8..c5544e5b8 100755 --- a/man1/git-parse-remote.1 +++ b/man1/git-parse-remote.1 @@ -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" diff --git a/man1/git-pull.1 b/man1/git-pull.1 index ca9547692..c9fcdf8b1 100755 --- a/man1/git-pull.1 +++ b/man1/git-pull.1 @@ -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 diff --git a/man1/git-push.1 b/man1/git-push.1 index 51c83b4b1..8ba09e9fa 100755 --- a/man1/git-push.1 +++ b/man1/git-push.1 @@ -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 diff --git a/man1/git-rerere.1 b/man1/git-rerere.1 index a277d0bc6..c56924f34 100755 --- a/man1/git-rerere.1 +++ b/man1/git-rerere.1 @@ -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\&. diff --git a/man1/git-resolve.1 b/man1/git-resolve.1 index c3a21007b..c1e53d15b 100755 --- a/man1/git-resolve.1 +++ b/man1/git-resolve.1 @@ -23,7 +23,7 @@ git-resolve \- Merge two commits .SH "SYNOPSIS" -git\-resolve +\fIgit\-resolve\fR .SH "DESCRIPTION" diff --git a/man1/git-rev-list.1 b/man1/git-rev-list.1 index ba4d409d1..109ed4ea2 100755 --- a/man1/git-rev-list.1 +++ b/man1/git-rev-list.1 @@ -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\&. diff --git a/man1/git-show-index.1 b/man1/git-show-index.1 index e807ace5a..f03cca1ec 100755 --- a/man1/git-show-index.1 +++ b/man1/git-show-index.1 @@ -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" diff --git a/man1/git-ssh-fetch.1 b/man1/git-ssh-fetch.1 index 0eee592e2..30ded8647 100755 --- a/man1/git-ssh-fetch.1 +++ b/man1/git-ssh-fetch.1 @@ -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" diff --git a/man1/git-ssh-upload.1 b/man1/git-ssh-upload.1 index ec1cc0624..6ac58bd3f 100755 --- a/man1/git-ssh-upload.1 +++ b/man1/git-ssh-upload.1 @@ -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" diff --git a/man1/git-symbolic-ref.1 b/man1/git-symbolic-ref.1 index 430607186..2161ce9e7 100755 --- a/man1/git-symbolic-ref.1 +++ b/man1/git-symbolic-ref.1 @@ -23,7 +23,7 @@ git-symbolic-ref \- read and modify symbolic refs .SH "SYNOPSIS" -git\-symbolic\-ref [] +\fIgit\-symbolic\-ref\fR [] .SH "DESCRIPTION" @@ -37,7 +37,7 @@ Give two arguments, create or update a symbolic ref 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\&. diff --git a/man1/git-unpack-file.1 b/man1/git-unpack-file.1 index 5d6104b04..c5deeded7 100755 --- a/man1/git-unpack-file.1 +++ b/man1/git-unpack-file.1 @@ -23,7 +23,7 @@ git-unpack-file \- Creates a temporary file with a blob's contents .SH "SYNOPSIS" -git\-unpack\-file +\fIgit\-unpack\-file\fR .SH "DESCRIPTION" diff --git a/man1/git-update-server-info.1 b/man1/git-update-server-info.1 index b727b9724..a6ed8029b 100755 --- a/man1/git-update-server-info.1 +++ b/man1/git-update-server-info.1 @@ -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" diff --git a/man7/git.7 b/man7/git.7 index 4ad8b1003..cffff4817 100755 --- a/man7/git.7 +++ b/man7/git.7 @@ -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" -- 2.26.2