Autogenerated man pages for v1.3.3-g16a4
authorJunio C Hamano <junio@hera.kernel.org>
Sun, 4 Jun 2006 07:25:36 +0000 (07:25 +0000)
committerJunio C Hamano <junio@hera.kernel.org>
Sun, 4 Jun 2006 07:25:36 +0000 (07:25 +0000)
24 files changed:
man1/git-apply.1
man1/git-blame.1
man1/git-branch.1
man1/git-checkout.1
man1/git-commit.1
man1/git-cvsserver.1
man1/git-daemon.1
man1/git-diff-index.1
man1/git-diff-tree.1
man1/git-diff.1
man1/git-format-patch.1
man1/git-fsck-objects.1
man1/git-grep.1
man1/git-merge-index.1
man1/git-patch-id.1
man1/git-read-tree.1
man1/git-repo-config.1
man1/git-reset.1
man1/git-rev-parse.1
man1/git-send-email.1
man1/git-send-pack.1
man1/git-sh-setup.1
man1/git-update-index.1
man1/git-update-ref.1

index e447ce59d5a6da85f76a53a47f00091c68bb7d95..fd3db6531d71e7fb621765c0387c067cd11491a3 100755 (executable)
@@ -90,7 +90,7 @@ When applying a patch, which is a git\-enhanced patch that was prepared to recor
 
 .TP
 \-\-whitespace=<option>
-When applying a patch, detect a new or modified line that ends with trailing whitespaces (this includes a line that solely consists of whitespaces)\&. By default, the command outputs warning messages and applies the patch\&. When git\-apply is used for statistics and not applying a patch, it defaults to nowarn\&. You can use different <option> to control this behaviour:
+When applying a patch, detect a new or modified line that ends with trailing whitespaces (this includes a line that solely consists of whitespaces)\&. By default, the command outputs warning messages and applies the patch\&. When git\-apply is used for statistics and not applying a patch, it defaults to nowarn\&. You can use different <option> to control this behavior:
 
 .RS
 .TP 3
index c38a3ca6a797bd7128b9c86b7ae9393aec4247f7..b14826fd3955d6f0d7e16d490bd0265a42de33de 100755 (executable)
@@ -33,7 +33,7 @@ Annotates each line in the given file with information from the commit which int
 .SH "OPTIONS"
 
 .TP
-\-c, \-\-compability
+\-c, \-\-compatibility
 Use the same output mode as git\-annotate (Default: off)\&.
 
 .TP
index d6f66de28962be20f20abe2fcfb27ea044407a0e..b6ac7a0cd39cd62894af27c38a76181860bf485f 100755 (executable)
@@ -24,7 +24,7 @@ git-branch \- List, create, or delete branches.
 
 .nf
 \fIgit\-branch\fR [\-r]
-\fIgit\-branch\fR [\-f] <branchname> [<start\-point>]
+\fIgit\-branch\fR [\-l] [\-f] <branchname> [<start\-point>]
 \fIgit\-branch\fR (\-d | \-D) <branchname>...
 .fi
 
@@ -37,7 +37,7 @@ With no arguments given (or just \-r) a list of available branches will be shown
 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\&.
+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\&.
 
 .SH "OPTIONS"
 
@@ -49,6 +49,10 @@ Delete a branch\&. The branch must be fully merged\&.
 \-D
 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
+
 .TP
 \-f
 Force the creation of a new branch even if it means deleting a branch that already exists with the same name\&.
index fdb0f47bc175b1ce8bfaf49cb7badddd3bd1e26c..9bdafa51cc22d4e84896d25967cf1acb6a9efa9c 100755 (executable)
@@ -23,7 +23,7 @@ git-checkout \- Checkout and switch to a branch
 .SH "SYNOPSIS"
 
 .nf
-\fIgit\-checkout\fR [\-f] [\-b <new_branch>] [\-m] [<branch>]
+\fIgit\-checkout\fR [\-f] [\-b <new_branch> [\-l]] [\-m] [<branch>]
 \fIgit\-checkout\fR [\-m] [<branch>] <paths>...
 .fi
 
@@ -45,6 +45,10 @@ Force a re\-read of everything\&.
 \-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\&.
 
+.TP
+\-l
+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\&.
index 7faec2341506c6b995cf257b485d15f58199502d..5eaf9a8f21fad5b73b3a4fa63a929fce272deacf 100755 (executable)
@@ -94,7 +94,7 @@ 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 behaviour\&.
+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
index 78626e19c76cf723fdb70f52324e31e50de1f94e..e5ab988ff56c8585a1733e16aa634709fb073033 100755 (executable)
@@ -135,7 +135,7 @@ Pick \fIHEAD\fR when it asks what branch/tag to check out\&. Untick the "launch
 .LP
 
 
-Protocol notes: If you are using anonymous acces 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\&.
+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\&.
index e1a31af563b45984fafb4eb692ebebb53acc69c1..5c833fc36558107e5e035ad34b435d754c7b9a84 100755 (executable)
@@ -35,13 +35,13 @@ git-daemon \- A really simple server for git repositories
 A really simple TCP git daemon that normally listens on port "DEFAULT_GIT_PORT" aka 9418\&. It waits for a connection, and will just execute "git\-upload\-pack" when it gets one\&.
 
 
-It's careful in that there's a magic request\-line that gives the command and what directory to upload, and it verifies that the directory is ok\&.
+It's careful in that there's a magic request\-line that gives the command and what directory to upload, and it verifies that the directory is OK\&.
 
 
 It verifies that the directory has the magic file "git\-daemon\-export\-ok", and it will refuse to export any git directory that hasn't explicitly been marked for export this way (unless the \fI\-\-export\-all\fR parameter is specified)\&. If you pass some directory paths as \fIgit\-daemon\fR arguments, you can further restrict the offers to a whitelist comprising of those\&.
 
 
-This is ideally suited for read\-only updates, ie pulling from git repositories\&.
+This is ideally suited for read\-only updates, i\&.e\&., pulling from git repositories\&.
 
 .SH "OPTIONS"
 
index 786b5c627a03ae10080586379ebdba0e02ccfe1d..2eb28bbdbdf26b719b30734d70542888316da445 100755 (executable)
@@ -418,7 +418,7 @@ torvalds@ppc970:~/v2\&.6/linux> git\-diff\-index HEAD
 .fi
 
 
-ie it shows that the tree has changed, and that kernel/sched\&.c has is not up\-to\-date and may contain new stuff\&. The all\-zero sha1 means that to get the real diff, you need to look at the object in the working directory directly rather than do an object\-to\-object diff\&.
+i\&.e\&., it shows that the tree has changed, and that kernel/sched\&.c has is not up\-to\-date and may contain new stuff\&. The all\-zero sha1 means that to get the real diff, you need to look at the object in the working directory directly rather than do an object\-to\-object diff\&.
 
 .RS
 .Sh "Note"
index 6357b8e996961d94a234b26f720458400dd21957..5cf9afdeb3b76f6c279e6102697b7aa84c2b95e7 100755 (executable)
@@ -138,7 +138,7 @@ The id of a tree object\&.
 
 .TP
 <path>...
-If provided, the results are limited to a subset of files matching one of these prefix strings\&. ie file matches /^<pattern1>|<pattern2>|.../ Note that this parameter does not provide any wildcard or regexp features\&.
+If provided, the results are limited to a subset of files matching one of these prefix strings\&. i\&.e\&., file matches /^<pattern1>|<pattern2>|.../ Note that this parameter does not provide any wildcard or regexp features\&.
 
 .TP
 \-r
@@ -156,7 +156,7 @@ When \fI\-\-root\fR is specified the initial commit will be showed as a big crea
 \-\-stdin
 When \fI\-\-stdin\fR is specified, the command does not take <tree\-ish> arguments from the command line\&. Instead, it reads either one <commit> or a pair of <tree\-ish> separated with a single space from its standard input\&.
 
-When a single commit is given on one line of such input, it compares the commit with its parents\&. The following flags further affects its behaviour\&. This does not apply to the case where two <tree\-ish> separated with a single space are given\&.
+When a single commit is given on one line of such input, it compares the commit with its parents\&. The following flags further affects its behavior\&. This does not apply to the case where two <tree\-ish> separated with a single space are given\&.
 
 .TP
 \-m
index 86567ac317bb87dbe7821ae0e952db6c1fe2a06a..e4e9f4d08e3622e017d53b7abc828fa10ae543e7 100755 (executable)
@@ -98,7 +98,7 @@ $ git diff arch/i386 include/asm\-i386   \fB(3)\fR
 .sp
 \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 behaviour, 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\&.
 .br
index ed3409b152427497a16fe06b4e047f7e4b75a56e..f2f7c373adab1432b0796324cf4bb2dfe2a76370 100755 (executable)
@@ -23,34 +23,42 @@ git-format-patch \- Prepare patches for e-mail submission
 .SH "SYNOPSIS"
 
 .nf
-\fIgit\-format\-patch\fR [\-n | \-k] [\-o <dir> | \-\-stdout] [\-\-attach] [\-s] [\-c]
-                 [\-\-diff\-options] <his> [<mine>]
+\fIgit\-format\-patch\fR [\-n | \-k] [\-o <dir> | \-\-stdout] [\-\-attach]
+                   [\-s | \-\-signoff] [\-\-diff\-options] [\-\-start\-number <n>]
+                   <since>[\&.\&.<until>]
 .fi
 
 .SH "DESCRIPTION"
 
 
-Prepare each commit with its patch since <mine> head forked from <his> head, one file per patch formatted to resemble UNIX mailbox format, for e\-mail submission or use with \fBgit\-am\fR(1)\&.
+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\&.
 
 
-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 output of this command is convenient for e\-mail submission or for use with \fBgit\-am\fR(1)\&.
 
 
-When \-o is specified, output files are created in <dir>; otherwise they are created in the current working directory\&. This option is ignored if \-\-stdout is specified\&.
+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\&.
 
 
-When \-n is specified, instead of "[PATCH] Subject", the first line is formatted as "[PATCH N/M] Subject", unless you have only one patch\&.
+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"\&.
 
 .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\&. This option is ignored if \-\-stdout is specified\&.
 
 .TP
 \-n|\-\-numbered
 Name output in \fI[PATCH n/m]\fR format\&.
 
+.TP
+\-\-start\-number <n>
+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\&.
@@ -59,13 +67,9 @@ Do not strip/add \fI[PATCH]\fR from the first line of the commit log message\&.
 \-s|\-\-signoff
 Add Signed\-off\-by: line to the commit message, using the committer identity of yourself\&.
 
-.TP
-\-c|\-\-check
-Display suspicious lines in the patch\&. 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\&.
-
 .TP
 \-\-stdout
-This flag generates the mbox formatted output to the standard output, instead of saving them into a file per patch and implies \-\-mbox\&.
+Print all commits to the standard output in mbox format, instead of creating a file for each one\&.
 
 .TP
 \-\-attach
@@ -88,11 +92,11 @@ Extract commits between revisions R1 and R2, and apply them on top of the curren
 
 .TP
 git\-format\-patch origin
-Extract commits the current branch accumulated since it pulled from origin the last time in a patch form for e\-mail submission\&.
+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, except detect and handle renames and complete rewrites intelligently to produce 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 patch well, 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"
 
index 9fc961a286284eb3c9df8ba1105e38073c061d84..c5bbfc0b3d13f62942d43ced91a1e07c5ae5f1c4 100755 (executable)
@@ -78,7 +78,7 @@ git\-fsck\-objects \-\-unreachable HEAD $(cat \&.git/refs/heads/*)
 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 (ie 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)\&.
+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 ;)
index 8d0b7202b3f35a1f67fd1c8459378af80372ce04..496f6322d87c719556a44437e9eb776977aaac54 100755 (executable)
@@ -44,7 +44,7 @@ Look for specified patterns in the working tree files, blobs registered in the i
 
 .TP
 \-\-cached
-Instead of searching in the working tree files, check the blobs registerd in the index file\&.
+Instead of searching in the working tree files, check the blobs registered in the index file\&.
 
 .TP
 \-a | \-\-text
@@ -80,7 +80,7 @@ Instead of showing every matched line, show the number of lines that match\&.
 
 .TP
 \-[ABC] <context>
-Show context trailing (A -- after), or leading (B -- before), or both (C -- context) lines, and place a line containing \-\- between continguous groups of matches\&.
+Show context trailing (A -- after), or leading (B -- before), or both (C -- context) lines, and place a line containing \-\- between contiguous groups of matches\&.
 
 .TP
 \-f <file>
index 7bef26b7a786c7f9b3b7aa1d0e5d846b06eeb184..df27f7dd19733a97805f79a5971c2e99b0d42b53 100755 (executable)
@@ -84,7 +84,7 @@ 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 (ie "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)\&.
 
 .SH "AUTHOR"
 
index 878aa2f0bf9c3ac35ef8acb841002a97a701a028..8b85a55adf78206125fd2186704cdb2166094985 100755 (executable)
@@ -28,7 +28,7 @@ git-patch-id \- Generate a patch ID
 .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, ie two patches that have the same "patch ID" are almost guaranteed to be the same thing\&.
+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\&.
index 10a7c236a9e29bf2064406acd52ed34c4195f72d..c3662f5455affe4aa1984890a5964f1bc769c01d 100755 (executable)
@@ -176,8 +176,10 @@ However, when you do git\-read\-tree with three trees, the "stage" starts out at
 
 This means that you can do
 
-.IP
+.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>\&.
 
@@ -199,7 +201,7 @@ stage 1 and stage 3 are the same and stage 2 is different take stage 2 (we did s
 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)\&.
+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:
@@ -212,7 +214,7 @@ if a file exists in identical format in all three trees, it will automatically c
 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 (ie "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
@@ -238,23 +240,29 @@ When you start a 3\-way merge with an index file that is already populated, it i
 
 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 commited last to your repository:
 
-.IP
+.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:
 
-.IP
+.nf
 $ 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:
 
-.IP
+.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\&.
 
index fa5f183b366645222b5814810c6ca2c5681d48fe..a3bdc4e2085875fcc616cdb3659fcf941e8b343d 100755 (executable)
@@ -70,7 +70,7 @@ you try to unset/set an option for which multiple lines match\&.
 
 .TP
 \-\-replace\-all
-Default behaviour is to replace at most one line\&. This replaces all lines matching the key (and optionally the value_regex)\&.
+Default behavior is to replace at most one line\&. This replaces all lines matching the key (and optionally the value_regex)\&.
 
 .TP
 \-\-get
@@ -211,7 +211,7 @@ To actually match only values with an exclamation mark, you have to
 .SH "CONFIGURATION FILE"
 
 
-The git configuration file contains a number of variables that affect the git commands behaviour\&. They can be used by both the git plumbing and the porcelains\&. The variables are divided to sections, where in the fully qualified variable name the variable itself is the last dot\-separated segment and the section name is everything before the last dot\&. The variable names are case\-insensitive and only alphanumeric characters are allowed\&. Some variables may appear multiple times\&.
+The git configuration file contains a number of variables that affect the git commands behavior\&. They can be used by both the git plumbing and the porcelains\&. The variables are divided to sections, where in the fully qualified variable name the variable itself is the last dot\-separated segment and the section name is everything before the last dot\&. The variable names are case\-insensitive and only alphanumeric characters are allowed\&. Some variables may appear multiple times\&.
 
 
 The syntax is fairly flexible and permissive; whitespaces are mostly ignored\&. The \fI#\fR and \fI;\fR characters begin commends to the end of line, blank lines are ignored, lines containing strings enclosed in square brackets start sections and all the other lines are recognized as setting variables, in the form \fIname = value\fR\&. If there is no equal sign on the line, the entire line is taken as \fIname\fR and the variable is recognized as boolean "true"\&. String values may be entirely or partially enclosed in double quotes; some variables may require special value format\&.
@@ -246,7 +246,7 @@ core\&.gitProxy
 A "proxy command" to execute (as \fIcommand host port\fR) instead of establishing direct connection to the remote server when using the git protocol for fetching\&. If the variable value is in the "COMMAND for DOMAIN" format, the command is applied only on hostnames ending with the specified domain string\&. This variable may be set multiple times and is matched in the given order; the first match wins\&.
 
 .nf
-Can be overriden by the 'GIT_PROXY_COMMAND' environment variable
+Can be overridden by the 'GIT_PROXY_COMMAND' environment variable
 (which always applies universally, without the special "for"
 handling)\&.
 .fi
@@ -259,6 +259,10 @@ The working copy files are assumed to stay unchanged until you mark them otherwi
 core\&.preferSymlinkRefs
 Instead of the default "symref" format for HEAD and other symbolic reference files, use symbolic links\&. This is sometimes needed to work with old scripts that expect HEAD to be a symbolic link\&.
 
+.TP
+core\&.logAllRefUpdates
+If true, git\-update\-ref will append a line to "$GIT_DIR/logs/<ref>" listing the new SHA1 and the date/time of the update\&. If the file does not exist it will be created automatically\&. This information can be used to determine what commit was the tip of a branch "2 days ago"\&. This value is false by default (no logging)\&.
+
 .TP
 core\&.repositoryFormatVersion
 Internal variable identifying the repository format and layout version\&.
@@ -301,11 +305,11 @@ File containing the SSL certificate when fetching or pushing over HTTPS\&. Can b
 
 .TP
 http\&.sslKey
-File containing the SSL private key when fetching or pushing over HTTPS\&. Can be overriden by the \fIGIT_SSL_KEY\fR environment variable\&.
+File containing the SSL private key when fetching or pushing over HTTPS\&. Can be overridden by the \fIGIT_SSL_KEY\fR environment variable\&.
 
 .TP
 http\&.sslCAInfo
-File containing the certificates to verify the peer with when fetching or pushing over HTTPS\&. Can be overriden by the \fIGIT_SSL_CAINFO\fR environment variable\&.
+File containing the certificates to verify the peer with when fetching or pushing over HTTPS\&. Can be overridden by the \fIGIT_SSL_CAINFO\fR environment variable\&.
 
 .TP
 http\&.sslCAPath
@@ -313,11 +317,11 @@ Path containing files with the CA certificates to verify the peer with when fetc
 
 .TP
 http\&.maxRequests
-How many HTTP requests to launch in parallel\&. Can be overriden by the \fIGIT_HTTP_MAX_REQUESTS\fR environment variable\&. Default is 5\&.
+How many HTTP requests to launch in parallel\&. Can be overridden by the \fIGIT_HTTP_MAX_REQUESTS\fR environment variable\&. Default is 5\&.
 
 .TP
 http\&.lowSpeedLimit, http\&.lowSpeedTime
-If the HTTP transfer speed is less than \fIhttp\&.lowSpeedLimit\fR for longer than \fIhttp\&.lowSpeedTime\fR seconds, the transfer is aborted\&. Can be overriden by the \fIGIT_HTTP_LOW_SPEED_LIMIT\fR and \fIGIT_HTTP_LOW_SPEED_TIME\fR environment variables\&.
+If the HTTP transfer speed is less than \fIhttp\&.lowSpeedLimit\fR for longer than \fIhttp\&.lowSpeedTime\fR seconds, the transfer is aborted\&. Can be overridden by the \fIGIT_HTTP_LOW_SPEED_LIMIT\fR and \fIGIT_HTTP_LOW_SPEED_TIME\fR environment variables\&.
 
 .TP
 i18n\&.commitEncoding
@@ -345,11 +349,11 @@ The default set of branches for \fBgit\-show\-branch\fR(1)\&. See \fBgit\-show\-
 
 .TP
 user\&.email
-Your email address to be recorded in any newly created commits\&. Can be overriden by the \fIGIT_AUTHOR_EMAIL\fR and \fIGIT_COMMITTER_EMAIL\fR environment variables\&. See \fBgit\-commit\-tree\fR(1)\&.
+Your email address to be recorded in any newly created commits\&. Can be overridden by the \fIGIT_AUTHOR_EMAIL\fR and \fIGIT_COMMITTER_EMAIL\fR environment variables\&. See \fBgit\-commit\-tree\fR(1)\&.
 
 .TP
 user\&.name
-Your full name to be recorded in any newly created commits\&. Can be overriden by the \fIGIT_AUTHOR_NAME\fR and \fIGIT_COMMITTER_NAME\fR environment variables\&. See \fBgit\-commit\-tree\fR(1)\&.
+Your full name to be recorded in any newly created commits\&. Can be overridden by the \fIGIT_AUTHOR_NAME\fR and \fIGIT_COMMITTER_NAME\fR environment variables\&. See \fBgit\-commit\-tree\fR(1)\&.
 
 .TP
 whatchanged\&.difftree
index eccf1fac6bfc6cae61ae3a7b1aae3eb3c2d0774b..60fd328c75ddfba1e1257e08be48288e6a37c84f 100755 (executable)
@@ -40,7 +40,7 @@ If you want to undo a commit other than the latest on a branch, \fBgit\-revert\f
 
 .TP
 \-\-mixed
-Resets the index but not the working tree (ie, 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
index cd19ed8d6ee845c007e5c14ee341f71eb319045c..5ad557cbaee223c73b98299b70f2d0f3871c6959 100755 (executable)
@@ -28,7 +28,7 @@ git-rev-parse \- Pick out and massage parameters
 .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\&.
 
 .SH "OPTIONS"
 
@@ -98,7 +98,7 @@ 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 abbriviate 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
@@ -125,6 +125,9 @@ The full SHA1 object name (40\-byte hexadecimal string), or a substring of such
 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>)\&.
+.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\&.
 .TP
 \(bu
index 95350e223dcfee0bad425d80d5fe5e668ab1d675..49489857598a4845d95671804dfbdaf55d6ee65d 100755 (executable)
@@ -60,7 +60,7 @@ Specify the contents of the first In\-Reply\-To header\&. Subsequent emails will
 
 .TP
 \-\-no\-signed\-off\-by\-cc
-Do not add emails foudn 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
index 6c88fdcaf8a1fa968814ad1d7562c725e30e035c..ad7bdf52c589964ee39ceb4d9c94575f94411e3b 100755 (executable)
@@ -61,7 +61,7 @@ The repository to update\&.
 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 transfered to the remote side\&. You cannot specify any \fI<ref>\fR if you use this flag\&.
+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\&.
index e0975d42c2d210df963cf5614104dc10434ffb7e..8a50c214dc722bcd317cfd1b9fd6d1b25f595653 100755 (executable)
@@ -28,7 +28,7 @@ git-sh-setup \- Common git shell script setup code
 .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:
 
 .nf
 \&. git\-sh\-setup || die "Not a git archive"
index b5cc1d49ce2262efe1fba7a56409f05817a59c5e..49ae3352f6afac655e173dbb29de638b10c05bb4 100755 (executable)
@@ -52,7 +52,7 @@ If a specified file isn't in the index already then it's added\&. Default behavi
 
 .TP
 \-\-remove
-If a specified file is in the index but is missing then it's removed\&. Default behaviour 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
index fd4e3de53753e0be87f23b14758ea2b60427f6a5..4ea91972191f02a0f40f68e3f779268c83eda09e 100755 (executable)
@@ -23,7 +23,7 @@ git-update-ref \- update the object name stored in a ref safely
 .SH "SYNOPSIS"
 
 
-\fIgit\-update\-ref\fR <ref> <newvalue> [<oldvalue>]
+\fIgit\-update\-ref\fR [\-m <reason>] <ref> <newvalue> [<oldvalue>]
 
 .SH "DESCRIPTION"
 
@@ -56,6 +56,31 @@ echo "$head" > "$GIT_DIR/HEAD"
 
 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)\&.
 
+.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:
+
+.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
+
+
+Optionally with \-m:
+
+.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\&.
+
 .SH "AUTHOR"