{"thread":{"id":"34759","subject":"[PATCH 0/13] Modernize user-manual","startedAt":"2013-08-24T07:22:12Z","lastAt":"2013-08-26T13:51:08Z","messageCount":44,"participants":["Thomas Ackermann","Philip Oakley","Jonathan Nieder","Junio C Hamano","Martin von Zweigbergk","Jon Loeliger"],"isPatch":true,"patchVersion":1,"patchTotal":13},"messages":[{"id":"225775","messageId":"282216171.1090748.1377328932833.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"34759","inReplyTo":null,"subject":"[PATCH 0/13] Modernize user-manual","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-24T07:22:12Z","receivedAt":"2013-08-24T07:22:12Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"Hi,\n\ncommand output has changed for some commands in the last years,\nso reflect this also in the user-manual. While doing so, fix some minor \nspelling, formatting and wording issues.\n\nFurther, some references and recommendations which nowadays might \nonly confuse and not help new Git users where removed. Also some \nexplanations where rephrased to IMHO make them easier to understand\nfor new users.\n\nThe last patch removes a lengthy paragraph which states that \"git prune\" \n(and \"git fsck\") should only be used in a quiescent repository. The \nman-page for \"git prune\" tells nothing about this. So either the \nremoval should be OK or we have to duplicate the warning paragraph \nin the man-page of \"git prune\"?\n\n[PATCH 01/13] Call it \"Git User Manual\" and remove reference to very old Git version\n[PATCH 02/13] Use current \"detached HEAD\" message\n[PATCH 03/13] Use current output for \"git repack\"\n[PATCH 04/13] Use \"git merge\" instead of \"git pull .\"\n[PATCH 05/13] Fix some typos\n[PATCH 06/13] Simplify \"How to make a commit\"\n[PATCH 07/13] Improve description in \"How to merge\"\n[PATCH 08/13] Improve section \"Manipulating branches\"\n[PATCH 09/13] Improve section \"Merge multiple trees\"\n[PATCH 10/13] Remove unnecessary historical note from \"Object storage format\"\n[PATCH 11/13] Remove obscure reference from \"Examples\"\n[PATCH 12/13] Remove irrelevant reference from \"Tying it all together\"\n[PATCH 13/13] \"git prune\" is safe now\n\nSigned-off-by: Thomas Ackermann \n\n\n---\nThomas\n"},{"id":"225776","messageId":"119602113.1090836.1377329085278.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"34759","inReplyTo":"282216171.1090748.1377328932833.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[PATCH 01/13] Call it \"Git User Manual\" and remove reference to very old Git version","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-24T07:24:45Z","receivedAt":"2013-08-24T07:24:45Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\nSigned-off-by: Thomas Ackermann \n---\n Documentation/user-manual.txt | 5 ++---\n 1 file changed, 2 insertions(+), 3 deletions(-)\n\ndiff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\nindex fe723e4..103ec9a 100644\n--- a/Documentation/user-manual.txt\n+++ b/Documentation/user-manual.txt\n@@ -1,6 +1,5 @@\n-Git User's Manual (for version 1.5.3 or newer)\n-______________________________________________\n-\n+Git User Manual\n+_______________\n \n Git is a fast distributed revision control system.\n \n-- \n1.8.3.msysgit.0\n\n\n---\nThomas\n"},{"id":"225777","messageId":"1667680014.1090850.1377329140347.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"34759","inReplyTo":"282216171.1090748.1377328932833.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[PATCH 02/13] Use current \"detached HEAD\" message","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-24T07:25:40Z","receivedAt":"2013-08-24T07:25:40Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\nSigned-off-by: Thomas Ackermann \n---\n Documentation/user-manual.txt | 17 ++++++++++++-----\n 1 file changed, 12 insertions(+), 5 deletions(-)\n\ndiff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\nindex 103ec9a..cb30929 100644\n--- a/Documentation/user-manual.txt\n+++ b/Documentation/user-manual.txt\n@@ -312,10 +312,17 @@ referenced by a tag:\n \n ------------------------------------------------\n $ git checkout v2.6.17\n-Note: moving to \"v2.6.17\" which isn't a local branch\n-If you want to create a new branch from this checkout, you may do so\n-(now or later) by using -b with the checkout command again. Example:\n- git checkout -b \n+Note: checking out 'v2.6.17'.\n+\n+You are in 'detached HEAD' state. You can look around, make experimental\n+changes and commit them, and you can discard any commits you make in this\n+state without impacting any branches by performing another checkout.\n+\n+If you want to create a new branch to retain commits you create, you may\n+do so (now or later) by using -b with the checkout command again. Example:\n+\n+ git checkout -b new_branch_name\n+\n HEAD is now at 427abfa... Linux v2.6.17\n ------------------------------------------------\n \n@@ -326,7 +333,7 @@ and git branch shows that you are no longer on a branch:\n $ cat .git/HEAD\n 427abfa28afedffadfca9dd8b067eb6d36bac53f\n $ git branch\n-* (no branch)\n+* (detached from v2.6.17)\n master\n ------------------------------------------------\n \n-- \n1.8.3.msysgit.0\n\n\n---\nThomas\n"},{"id":"225778","messageId":"1172777180.1090921.1377329200690.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"34759","inReplyTo":"282216171.1090748.1377328932833.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[PATCH 03/13] Use current output for \"git repack\"","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-24T07:26:40Z","receivedAt":"2013-08-24T07:26:40Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\nSigned-off-by: Thomas Ackermann \n---\n Documentation/user-manual.txt | 13 +++++--------\n 1 file changed, 5 insertions(+), 8 deletions(-)\n\ndiff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\nindex cb30929..b450980 100644\n--- a/Documentation/user-manual.txt\n+++ b/Documentation/user-manual.txt\n@@ -3203,14 +3203,11 @@ To put the loose objects into a pack, just run git repack:\n \n ------------------------------------------------\n $ git repack\n-Generating pack...\n-Done counting 6020 objects.\n-Deltifying 6020 objects.\n- 100% (6020/6020) done\n-Writing 6020 objects.\n- 100% (6020/6020) done\n-Total 6020, written 6020 (delta 4070), reused 0 (delta 0)\n-Pack pack-3e54ad29d5b2e05838c75df582c65257b8d08e1c created.\n+Counting objects: 6020, done.\n+Delta compression using up to 4 threads.\n+Compressing objects: 100% (6020/6020), done.\n+Writing objects: 100% (6020/6020), done.\n+Total 6020 (delta 4070), reused 0 (delta 0)\n ------------------------------------------------\n \n You can then run\n-- \n1.8.3.msysgit.0\n\n\n---\nThomas\n"},{"id":"225779","messageId":"694030462.1090937.1377329263413.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"34759","inReplyTo":"282216171.1090748.1377328932833.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[PATCH 04/13] Use \"git merge\" instead of \"git pull .\"","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-24T07:27:43Z","receivedAt":"2013-08-24T07:27:43Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\n\"git pull .\" works, but \"git merge\" is the recommended\nway for new users to do things. (The old description \nalso should have read \"The former is actually *not* very\ncommonly used\".)\n\nSigned-off-by: Thomas Ackermann \n---\n Documentation/user-manual.txt | 15 ++-------------\n 1 file changed, 2 insertions(+), 13 deletions(-)\n\ndiff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\nindex b450980..8a1a441 100644\n--- a/Documentation/user-manual.txt\n+++ b/Documentation/user-manual.txt\n@@ -1784,17 +1784,6 @@ repository that you pulled from.\n <>; instead, your branch will just be\n updated to point to the latest commit from the upstream branch.)\n \n-The `git pull` command can also be given `.` as the \"remote\" repository,\n-in which case it just merges in a branch from the current repository; so\n-the commands\n-\n--------------------------------------------------\n-$ git pull . branch\n-$ git merge branch\n--------------------------------------------------\n-\n-are roughly equivalent. The former is actually very commonly used.\n-\n [[submitting-patches]]\n Submitting patches to a project\n -------------------------------\n@@ -2259,7 +2248,7 @@ When you are happy with the state of this change, you can pull it into the\n \"test\" branch in preparation to make it public:\n \n -------------------------------------------------\n-$ git checkout test && git pull . speed-up-spinlocks\n+$ git checkout test && git merge speed-up-spinlocks\n -------------------------------------------------\n \n It is unlikely that you would have any conflicts here ... but you might if you\n@@ -2271,7 +2260,7 @@ see the value of keeping each patch (or patch series) in its own branch. It\n means that the patches can be moved into the `release` tree in any order.\n \n -------------------------------------------------\n-$ git checkout release && git pull . speed-up-spinlocks\n+$ git checkout release && git merge speed-up-spinlocks\n -------------------------------------------------\n \n After a while, you will have a number of branches, and despite the\n-- \n1.8.3.msysgit.0\n\n\n---\nThomas\n"},{"id":"225780","messageId":"1171853844.1090991.1377329328622.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"34759","inReplyTo":"282216171.1090748.1377328932833.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[PATCH 05/13] Fix some typos","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-24T07:28:48Z","receivedAt":"2013-08-24T07:28:48Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\nSigned-off-by: Thomas Ackermann \n---\n Documentation/user-manual.txt | 10 +++++-----\n 1 file changed, 5 insertions(+), 5 deletions(-)\n\ndiff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\nindex ca78333..ccbddc7 100644\n--- a/Documentation/user-manual.txt\n+++ b/Documentation/user-manual.txt\n@@ -219,7 +219,7 @@ of development leading to that point.\n \n The best way to see how this works is using the linkgit:gitk[1]\n command; running gitk now on a Git repository and looking for merge\n-commits will help understand how the Git organizes history.\n+commits will help understand how Git organizes history.\n \n In the following, we say that commit X is \"reachable\" from commit Y\n if commit X is an ancestor of commit Y. Equivalently, you could say\n@@ -793,7 +793,7 @@ e05db0fd4f31dde7005f075a84f96b360d05984b\n -------------------------------------------------\n \n Or you could recall that the `...` operator selects all commits\n-contained reachable from either one reference or the other but not\n+reachable from either one reference or the other but not\n both; so\n \n -------------------------------------------------\n@@ -820,7 +820,7 @@ You could just visually inspect the commits since e05db0fd:\n $ gitk e05db0fd..\n -------------------------------------------------\n \n-Or you can use linkgit:git-name-rev[1], which will give the commit a\n+or you can use linkgit:git-name-rev[1], which will give the commit a\n name based on any tag it finds pointing to one of the commit's\n descendants:\n \n@@ -3525,7 +3525,7 @@ with Git 1.5.2 can look up the submodule commits in the repository and\n manually check them out; earlier versions won't recognize the submodules at\n all.\n \n-To see how submodule support works, create (for example) four example\n+To see how submodule support works, create four example\n repositories that can be used later as a submodule:\n \n -------------------------------------------------\n@@ -3897,7 +3897,7 @@ fact that such a commit brings together (\"merges\") two or more\n previous states represented by other commits.\n \n In other words, while a \"tree\" represents a particular directory state\n-of a working directory, a \"commit\" represents that state in \"time\",\n+of a working directory, a \"commit\" represents that state in time,\n and explains how we got there.\n \n You create a commit object by giving it the tree that describes the\n-- \n1.8.3.msysgit.0\n\n\n---\nThomas\n"},{"id":"225781","messageId":"1687455733.1090999.1377329376866.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"34759","inReplyTo":"282216171.1090748.1377328932833.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[PATCH 06/13] Simplify \"How to make a commit\"","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-24T07:29:36Z","receivedAt":"2013-08-24T07:29:36Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\nCombine the two cases for \"git add\" into one.\nAdd verb \"use\" to \"git rm\" case.\n\nSigned-off-by: Thomas Ackermann \n---\n Documentation/user-manual.txt | 11 +++--------\n 1 file changed, 3 insertions(+), 8 deletions(-)\n\ndiff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\nindex 8a1a441..ca78333 100644\n--- a/Documentation/user-manual.txt\n+++ b/Documentation/user-manual.txt\n@@ -1080,19 +1080,14 @@ produce no output at that point.\n \n Modifying the index is easy:\n \n-To update the index with the new contents of a modified file, use\n+To add the contents of a new file to the index or update the index \n+with the new contents of a modified file, use\n \n -------------------------------------------------\n $ git add path/to/file\n -------------------------------------------------\n \n-To add the contents of a new file to the index, use\n-\n--------------------------------------------------\n-$ git add path/to/file\n--------------------------------------------------\n-\n-To remove a file from the index and from the working tree,\n+To remove a file from the index and from the working tree, use\n \n -------------------------------------------------\n $ git rm path/to/file\n-- \n1.8.3.msysgit.0\n\n\n---\nThomas\n"},{"id":"225782","messageId":"8609038.1091034.1377329428557.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"34759","inReplyTo":"282216171.1090748.1377328932833.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[PATCH 07/13] Improve description in \"How to merge\"","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-24T07:30:28Z","receivedAt":"2013-08-24T07:30:28Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\nDescribe the conflict resolution in terms of the\ncommands the user is supposed to use.\n\nSigned-off-by: Thomas Ackermann \n---\n Documentation/user-manual.txt | 6 ++----\n 1 file changed, 2 insertions(+), 4 deletions(-)\n\ndiff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\nindex ccbddc7..0656191 100644\n--- a/Documentation/user-manual.txt\n+++ b/Documentation/user-manual.txt\n@@ -1251,10 +1251,8 @@ Automatic merge failed; fix conflicts and then commit the result.\n -------------------------------------------------\n \n Conflict markers are left in the problematic files, and after\n-you resolve the conflicts manually, you can update the index\n-with the contents and run Git commit, as you normally would when\n-creating a new file.\n-\n+you have resolved the conflicts manually, you can `git add` the\n+new contents and do a `git commit` in the end.\n If you examine the resulting commit using gitk, you will see that it\n has two parents, one pointing to the top of the current branch, and\n one to the top of the other branch.\n-- \n1.8.3.msysgit.0\n\n\n---\nThomas\n"},{"id":"225783","messageId":"1973484790.1091060.1377329493472.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"34759","inReplyTo":"282216171.1090748.1377328932833.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[PATCH 08/13] Improve section \"Manipulating branches\"","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-24T07:31:33Z","receivedAt":"2013-08-24T07:31:33Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\nAdd some missing punctuation.\nSimplify description of \"git branch -d/-D\".\n\nSigned-off-by: Thomas Ackermann \n---\n Documentation/user-manual.txt | 19 +++++++------------\n 1 file changed, 7 insertions(+), 12 deletions(-)\n\ndiff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\nindex 0656191..d5baf03 100644\n--- a/Documentation/user-manual.txt\n+++ b/Documentation/user-manual.txt\n@@ -268,27 +268,22 @@ Creating, deleting, and modifying branches is quick and easy; here's\n a summary of the commands:\n \n `git branch`::\n-\tlist all branches\n+\tlist all branches.\n `git branch `::\n \tcreate a new branch named ``, referencing the same\n-\tpoint in history as the current branch\n+\tpoint in history as the current branch.\n `git branch `::\n \tcreate a new branch named ``, referencing\n \t``, which may be specified any way you like,\n-\tincluding using a branch name or a tag name\n+\tincluding using a branch name or a tag name.\n `git branch -d `::\n-\tdelete the branch ``; if the branch you are deleting\n-\tpoints to a commit which is not reachable from the current\n-\tbranch, this command will fail with a warning.\n+\tdelete the branch ``; if the branch is not fully\n+\tmerged in its upstream branch, this command will fail with a warning.\n `git branch -D `::\n-\teven if the branch points to a commit not reachable\n-\tfrom the current branch, you may know that that commit\n-\tis still reachable from some other branch or tag. In that\n-\tcase it is safe to use this command to force Git to delete\n-\tthe branch.\n+\tdelete the branch `` irrespective of its merged status.\n `git checkout `::\n \tmake the current branch ``, updating the working\n-\tdirectory to reflect the version referenced by ``\n+\tdirectory to reflect the version referenced by ``.\n `git checkout -b `::\n \tcreate a new branch `` referencing ``, and\n \tcheck it out.\n-- \n1.8.3.msysgit.0\n\n\n---\nThomas\n"},{"id":"225784","messageId":"1473018875.1091101.1377329545934.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"34759","inReplyTo":"282216171.1090748.1377328932833.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[PATCH 09/13] Improve section \"Merge multiple trees\"","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-24T07:32:25Z","receivedAt":"2013-08-24T07:32:25Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\nRemove unnecessary quoting.\nSimplify description of three-way merge.\n\nSigned-off-by: Thomas Ackermann \n---\n Documentation/user-manual.txt | 14 +++++++-------\n 1 file changed, 7 insertions(+), 7 deletions(-)\n\ndiff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\nindex d5baf03..f713f26 100644\n--- a/Documentation/user-manual.txt\n+++ b/Documentation/user-manual.txt\n@@ -3992,16 +3992,16 @@ Merging multiple trees\n \n Git helps you do a three-way merge, which you can expand to n-way by\n repeating the merge procedure arbitrary times until you finally\n-\"commit\" the state. The normal situation is that you'd only do one\n+commit the state. The normal situation is that you'd only do one\n three-way merge (two parents), and commit it, but if you like to, you\n can do multiple parents in one go.\n \n-To do a three-way merge, you need the two sets of \"commit\" objects\n+To do a three-way merge, you need the two commit objects\n that you want to merge, use those to find the closest common parent (a\n-third \"commit\" object), and then use those commit objects to find the\n-state of the directory (\"tree\" object) at these points.\n+third commit object: the merge base), and then use those commit objects to find the\n+state of the directory (i.e. tree object) at these points.\n \n-To get the \"base\" for the merge, you first look up the common parent\n+To get the base for the merge, you first look up the common parent\n of two commits with\n \n -------------------------------------------------\n@@ -4009,8 +4009,8 @@ $ git merge-base \n -------------------------------------------------\n \n which will return you the commit they are both based on. You should\n-now look up the \"tree\" objects of those commits, which you can easily\n-do with (for example)\n+now look up the tree objects of those commits, which you can easily\n+do with\n \n -------------------------------------------------\n $ git cat-file commit | head -1\n-- \n1.8.3.msysgit.0\n\n\n---\nThomas\n"},{"id":"225785","messageId":"1339924016.1091137.1377329596491.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"34759","inReplyTo":"282216171.1090748.1377328932833.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[PATCH 10/13] Remove unnecessary historical note from \"Object storage format\"","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-24T07:33:16Z","receivedAt":"2013-08-24T07:33:16Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\nSigned-off-by: Thomas Ackermann \n---\n Documentation/user-manual.txt | 2 --\n 1 file changed, 2 deletions(-)\n\ndiff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\nindex f713f26..aa6bfab 100644\n--- a/Documentation/user-manual.txt\n+++ b/Documentation/user-manual.txt\n@@ -4132,8 +4132,6 @@ about the data in the object. It's worth noting that the SHA-1 hash\n that is used to name the object is the hash of the original data\n plus this header, so `sha1sum` 'file' does not match the object name\n for 'file'.\n-(Historical note: in the dawn of the age of Git the hash\n-was the SHA-1 of the 'compressed' object.)\n \n As a result, the general consistency of an object can always be tested\n independently of the contents or the type of the object: all objects can\n-- \n1.8.3.msysgit.0\n\n\n---\nThomas\n"},{"id":"225786","messageId":"883409466.1091151.1377329645768.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"34759","inReplyTo":"282216171.1090748.1377328932833.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[PATCH 11/13] Remove obscure reference from \"Examples\"","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-24T07:34:05Z","receivedAt":"2013-08-24T07:34:05Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\nSigned-off-by: Thomas Ackermann \n---\n Documentation/user-manual.txt | 2 --\n 1 file changed, 2 deletions(-)\n\ndiff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\nindex aa6bfab..0d3f04e 100644\n--- a/Documentation/user-manual.txt\n+++ b/Documentation/user-manual.txt\n@@ -2131,8 +2131,6 @@ He uses two public branches:\n \n - A \"test\" tree into which patches are initially placed so that they\n can get some exposure when integrated with other ongoing development.\n- This tree is available to Andrew for pulling into -mm whenever he\n- wants.\n \n - A \"release\" tree into which tested patches are moved for final sanity\n checking, and as a vehicle to send them upstream to Linus (by sending\n-- \n1.8.3.msysgit.0\n\n\n---\nThomas\n"},{"id":"225787","messageId":"1749978317.1091238.1377329758522.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"34759","inReplyTo":"282216171.1090748.1377328932833.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[PATCH 12/13] Remove irrelevant reference from \"Tying it all together\"","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-24T07:35:58Z","receivedAt":"2013-08-24T07:35:58Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\nSorry Jon, but this might not be of any help to new Git users ;)\n\nSigned-off-by: Thomas Ackermann \n---\n Documentation/user-manual.txt | 3 +--\n 1 file changed, 1 insertion(+), 2 deletions(-)\n\ndiff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\nindex 0d3f04e..08d8c91 100644\n--- a/Documentation/user-manual.txt\n+++ b/Documentation/user-manual.txt\n@@ -3908,8 +3908,7 @@ save the note about that state, in practice we tend to just write the\n result to the file pointed at by `.git/HEAD`, so that we can always see\n what the last committed state was.\n \n-Here is an ASCII art by Jon Loeliger that illustrates how\n-various pieces fit together.\n+Here is a picture that illustrates how various pieces fit together:\n \n ------------\n \n-- \n1.8.3.msysgit.0\n\n\n---\nThomas\n"},{"id":"225788","messageId":"1590776724.1091303.1377329872606.JavaMail.ngmail@webmail08.arcor-online.net","threadId":"34759","inReplyTo":"282216171.1090748.1377328932833.JavaMail.ngmail@webmail08.arcor-online.net","subject":"[PATCH 13/13] \"git prune\" is safe now","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-24T07:37:52Z","receivedAt":"2013-08-24T07:37:52Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"\nAccording to the man-pages of \"git prune\" and \"git fsck\",\nboth are safe nowadays.\n\nSigned-off-by: Thomas Ackermann \n---\n Documentation/user-manual.txt | 12 +-----------\n 1 file changed, 1 insertion(+), 11 deletions(-)\n\ndiff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\nindex 08d8c91..29945d9 100644\n--- a/Documentation/user-manual.txt\n+++ b/Documentation/user-manual.txt\n@@ -3283,17 +3283,7 @@ state, you can just prune all unreachable objects:\n $ git prune\n ------------------------------------------------\n \n-and they'll be gone. But you should only run `git prune` on a quiescent\n-repository--it's kind of like doing a filesystem fsck recovery: you\n-don't want to do that while the filesystem is mounted.\n-\n-(The same is true of `git fsck` itself, btw, but since\n-`git fsck` never actually *changes* the repository, it just reports\n-on what it found, `git fsck` itself is never 'dangerous' to run.\n-Running it while somebody is actually changing the repository can cause\n-confusing and scary messages, but it won't actually do anything bad. In\n-contrast, running `git prune` while somebody is actively changing the\n-repository is a *BAD* idea).\n+and they'll be gone. \n \n [[recovering-from-repository-corruption]]\n Recovering from repository corruption\n-- \n1.8.3.msysgit.0\n\n\n---\nThomas\n"},{"id":"225795","messageId":"1E7ACF7D33524F728C058D4F850613D1@PhilipOakley","threadId":"34759","inReplyTo":"282216171.1090748.1377328932833.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 0/13] Modernize user-manual","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2013-08-24T19:31:32Z","receivedAt":"2013-08-24T19:31:32Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"From: \"Thomas Ackermann\" \n> Hi,\n>\n> command output has changed for some commands in the last years,\n> so reflect this also in the user-manual. While doing so, fix some\n> minor\n> spelling, formatting and wording issues.\n>\n> Further, some references and recommendations which nowadays might\n> only confuse and not help new Git users where removed. Also some\n> explanations where rephrased to IMHO make them easier to understand\n> for new users.\n\nSince 1.8.3 we have had the ability to list the main Git Guides using\nthe 'git help -g' option, unfortunately the User Manual is not in a man\nformat, so it isn't listed within the help option.\n\nIs it worth adjusting the User Manual formatting such that it could be\ndisplayed as a man page? (which would also require a file name change\nfrom user-manual.txt to git-user-manual.txt). Or create a new man page\nhelper `git-user-manual.txt` that would provide a follow-me link to the\ncurrent user manual?\n\nBack at $gmane/216146 Junio noted that the git(1) man page does contain\nonward links to the user manual, but I believe that users should be able\nto get to it directly from a git command such as 'git help user-manual'.\nEasy access makes it more likely to be read, in the same way that man \npages are checked.\n\nPhilip\n\n>\n> The last patch removes a lengthy paragraph which states that \"git\n> prune\"\n> (and \"git fsck\") should only be used in a quiescent repository. The\n> man-page for \"git prune\" tells nothing about this. So either the\n> removal should be OK or we have to duplicate the warning paragraph\n> in the man-page of \"git prune\"?\n>\n> [PATCH 01/13] Call it \"Git User Manual\" and remove reference to very\n> old Git version\n> [PATCH 02/13] Use current \"detached HEAD\" message\n> [PATCH 03/13] Use current output for \"git repack\"\n> [PATCH 04/13] Use \"git merge\" instead of \"git pull .\"\n> [PATCH 05/13] Fix some typos\n> [PATCH 06/13] Simplify \"How to make a commit\"\n> [PATCH 07/13] Improve description in \"How to merge\"\n> [PATCH 08/13] Improve section \"Manipulating branches\"\n> [PATCH 09/13] Improve section \"Merge multiple trees\"\n> [PATCH 10/13] Remove unnecessary historical note from \"Object storage\n> format\"\n> [PATCH 11/13] Remove obscure reference from \"Examples\"\n> [PATCH 12/13] Remove irrelevant reference from \"Tying it all together\"\n> [PATCH 13/13] \"git prune\" is safe now\n>\n> Signed-off-by: Thomas Ackermann \n>\n>\n> ---\n> Thomas\n"},{"id":"225804","messageId":"20130825030517.GA2882@elie.Belkin","threadId":"34759","inReplyTo":"119602113.1090836.1377329085278.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 01/13] Call it \"Git User Manual\" and remove reference to very old Git version","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2013-08-25T03:05:17Z","receivedAt":"2013-08-25T03:05:17Z","isPatch":true,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Thomas Ackermann wrote:\n\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -1,6 +1,5 @@\n> -Git User's Manual (for version 1.5.3 or newer)\n> +Git User Manual\n\n\"User\" versus \"User's\": why? But I don't care much about this.\n\nDropping the reference to 1.5.3 is very welcome, since it should help\npeople to update the manual without fearing that new sections will\nfail for people with ancient copies of git. For what it's worth,\nReviewed-by: Jonathan Nieder \n"},{"id":"225805","messageId":"xmqq1u5io4cn.fsf@gitster.dls.corp.google.com","threadId":"34759","inReplyTo":"119602113.1090836.1377329085278.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 01/13] Call it \"Git User Manual\" and remove reference to very old Git version","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2013-08-25T03:07:36Z","receivedAt":"2013-08-25T03:07:36Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Thomas Ackermann writes:\n\n> Signed-off-by: Thomas Ackermann \n> ---\n> Documentation/user-manual.txt | 5 ++---\n> 1 file changed, 2 insertions(+), 3 deletions(-)\n>\n> diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\n> index fe723e4..103ec9a 100644\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -1,6 +1,5 @@\n> -Git User's Manual (for version 1.5.3 or newer)\n> -______________________________________________\n> -\n> +Git User Manual\n> +_______________\n> \n> Git is a fast distributed revision control system.\n\nYeah, it is about time.\n"},{"id":"225806","messageId":"xmqqvc2umpbf.fsf@gitster.dls.corp.google.com","threadId":"34759","inReplyTo":"694030462.1090937.1377329263413.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 04/13] Use \"git merge\" instead of \"git pull .\"","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2013-08-25T03:17:40Z","receivedAt":"2013-08-25T03:17:40Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Thomas Ackermann writes:\n\n> \"git pull .\" works, but \"git merge\" is the recommended\n> way for new users to do things. (The old description \n> also should have read \"The former is actually *not* very\n> commonly used\".)\n\nI think it is probably a good idea to replace \"pull .\" in the two\nlater hunks with \"merge\", but the flow of the explanation reads\nbetter if you did not touch the first hunk at all. The section\nintroduced how fully-spelled \"git pull origin master\" works, how its\nparameters can be omitted in a common case of integrating with the\nbranch at a remote repository you usually integrate with, and then\nthe hunk that you touched transitions to the local use, hinting that\nyour local repository is not all that special. It is very commonly\nused among people who grok that fact, and of course it still works\nbecause we do want to support that usage ;-).\n\nOn the other hand, these later two hunks are not about explaining\n\"pull\"; using \"git merge\" in the examples is more appropriate.\n\n> Signed-off-by: Thomas Ackermann \n> ---\n> Documentation/user-manual.txt | 15 ++-------------\n> 1 file changed, 2 insertions(+), 13 deletions(-)\n>\n> diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\n> index b450980..8a1a441 100644\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -1784,17 +1784,6 @@ repository that you pulled from.\n> <>; instead, your branch will just be\n> updated to point to the latest commit from the upstream branch.)\n> \n> -The `git pull` command can also be given `.` as the \"remote\" repository,\n> -in which case it just merges in a branch from the current repository; so\n> -the commands\n> -\n> --------------------------------------------------\n> -$ git pull . branch\n> -$ git merge branch\n> --------------------------------------------------\n> -\n> -are roughly equivalent. The former is actually very commonly used.\n> -\n> [[submitting-patches]]\n> Submitting patches to a project\n> -------------------------------\n> @@ -2259,7 +2248,7 @@ When you are happy with the state of this change, you can pull it into the\n> \"test\" branch in preparation to make it public:\n> \n> -------------------------------------------------\n> -$ git checkout test && git pull . speed-up-spinlocks\n> +$ git checkout test && git merge speed-up-spinlocks\n> -------------------------------------------------\n> \n> It is unlikely that you would have any conflicts here ... but you might if you\n> @@ -2271,7 +2260,7 @@ see the value of keeping each patch (or patch series) in its own branch. It\n> means that the patches can be moved into the `release` tree in any order.\n> \n> -------------------------------------------------\n> -$ git checkout release && git pull . speed-up-spinlocks\n> +$ git checkout release && git merge speed-up-spinlocks\n> -------------------------------------------------\n> \n> After a while, you will have a number of branches, and despite the\n"},{"id":"225807","messageId":"xmqqr4dimp65.fsf@gitster.dls.corp.google.com","threadId":"34759","inReplyTo":"1687455733.1090999.1377329376866.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 06/13] Simplify \"How to make a commit\"","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2013-08-25T03:20:50Z","receivedAt":"2013-08-25T03:20:50Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Thomas Ackermann writes:\n\n> Combine the two cases for \"git add\" into one.\n> Add verb \"use\" to \"git rm\" case.\n>\n> Signed-off-by: Thomas Ackermann \n> ---\n> Documentation/user-manual.txt | 11 +++--------\n> 1 file changed, 3 insertions(+), 8 deletions(-)\n>\n> diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\n> index 8a1a441..ca78333 100644\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -1080,19 +1080,14 @@ produce no output at that point.\n> \n> Modifying the index is easy:\n> \n> -To update the index with the new contents of a modified file, use\n> +To add the contents of a new file to the index or update the index \n> +with the new contents of a modified file, use\n> \n> -------------------------------------------------\n> $ git add path/to/file\n> -------------------------------------------------\n> \n> -To add the contents of a new file to the index, use\n> -\n> --------------------------------------------------\n> -$ git add path/to/file\n> --------------------------------------------------\n\nOK.\n\n> -To remove a file from the index and from the working tree,\n> +To remove a file from the index and from the working tree, use\n> \n> -------------------------------------------------\n> $ git rm path/to/file\n"},{"id":"225808","messageId":"xmqqmwo6mp45.fsf@gitster.dls.corp.google.com","threadId":"34759","inReplyTo":"8609038.1091034.1377329428557.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 07/13] Improve description in \"How to merge\"","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2013-08-25T03:22:02Z","receivedAt":"2013-08-25T03:22:02Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Thomas Ackermann writes:\n\n> Describe the conflict resolution in terms of the\n> commands the user is supposed to use.\n>\n> Signed-off-by: Thomas Ackermann \n> ---\n> Documentation/user-manual.txt | 6 ++----\n> 1 file changed, 2 insertions(+), 4 deletions(-)\n>\n> diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\n> index ccbddc7..0656191 100644\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -1251,10 +1251,8 @@ Automatic merge failed; fix conflicts and then commit the result.\n> -------------------------------------------------\n> \n> Conflict markers are left in the problematic files, and after\n> -you resolve the conflicts manually, you can update the index\n> -with the contents and run Git commit, as you normally would when\n> -creating a new file.\n> -\n> +you have resolved the conflicts manually, you can `git add` the\n> +new contents and do a `git commit` in the end.\n\nThis is a slight documentation regression, as there are cases your\nconflict resolution is a removal of the file, isn't it?\n\n> If you examine the resulting commit using gitk, you will see that it\n> has two parents, one pointing to the top of the current branch, and\n> one to the top of the other branch.\n"},{"id":"225809","messageId":"xmqqioyumoxr.fsf@gitster.dls.corp.google.com","threadId":"34759","inReplyTo":"1973484790.1091060.1377329493472.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 08/13] Improve section \"Manipulating branches\"","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2013-08-25T03:25:51Z","receivedAt":"2013-08-25T03:25:51Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Thomas Ackermann writes:\n\n> Add some missing punctuation.\n> Simplify description of \"git branch -d/-D\".\n> ...\n> `git branch -d `::\n> -\tdelete the branch ``; if the branch you are deleting\n> -\tpoints to a commit which is not reachable from the current\n> -\tbranch, this command will fail with a warning.\n> +\tdelete the branch ``; if the branch is not fully\n> +\tmerged in its upstream branch, this command will fail with a warning.\n\nBut is this correct? I somehow thought that we check with the\ncurrent or the upstream.\n\n> `git branch -D `::\n> -\teven if the branch points to a commit not reachable\n> -\tfrom the current branch, you may know that that commit\n> -\tis still reachable from some other branch or tag. In that\n> -\tcase it is safe to use this command to force Git to delete\n> -\tthe branch.\n> +\tdelete the branch `` irrespective of its merged status.\n\nThis is an OK change.\n"},{"id":"225810","messageId":"xmqqeh9imotd.fsf@gitster.dls.corp.google.com","threadId":"34759","inReplyTo":"1339924016.1091137.1377329596491.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 10/13] Remove unnecessary historical note from \"Object storage format\"","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2013-08-25T03:28:30Z","receivedAt":"2013-08-25T03:28:30Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Thomas Ackermann writes:\n\n> Signed-off-by: Thomas Ackermann \n> ---\n> Documentation/user-manual.txt | 2 --\n> 1 file changed, 2 deletions(-)\n>\n> diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\n> index f713f26..aa6bfab 100644\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -4132,8 +4132,6 @@ about the data in the object. It's worth noting that the SHA-1 hash\n> that is used to name the object is the hash of the original data\n> plus this header, so `sha1sum` 'file' does not match the object name\n> for 'file'.\n> -(Historical note: in the dawn of the age of Git the hash\n> -was the SHA-1 of the 'compressed' object.)\n\nAs we no longer are able to read such a historical object, I think\nit is OK to drop the historical note in this particular case.\n\nThanks.\n\n> \n> As a result, the general consistency of an object can always be tested\n> independently of the contents or the type of the object: all objects can\n"},{"id":"225812","messageId":"20130825034916.GB2882@elie.Belkin","threadId":"34759","inReplyTo":"1667680014.1090850.1377329140347.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 02/13] Use current \"detached HEAD\" message","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2013-08-25T03:49:16Z","receivedAt":"2013-08-25T03:49:16Z","isPatch":true,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Thomas Ackermann wrote:\n\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -312,10 +312,17 @@ referenced by a tag:\n> \n> \t------------------------------------------------\n> \t$ git checkout v2.6.17\n> -\tNote: moving to \"v2.6.17\" which isn't a local branch\n> -\tIf you want to create a new branch from this checkout, you may do so\n> -\t(now or later) by using -b with the checkout command again. Example:\n> -\t git checkout -b \n> +\tNote: checking out 'v2.6.17'.\n> +\n> +\tYou are in 'detached HEAD' state. You can look around, make experimental\n> +\tchanges and commit them, and you can discard any commits you make in this\n> +\tstate without impacting any branches by performing another checkout.\n> +\n> +\tIf you want to create a new branch to retain commits you create, you may\n> +\tdo so (now or later) by using -b with the checkout command again. Example:\n> +\n> +\t git checkout -b new_branch_name\n> +\n> \tHEAD is now at 427abfa... Linux v2.6.17\n\nI wonder if this longer wall of text (added in 13be3e31, 2010-01-29)\nis too aggressive.\n\nIt is the only piece of advice that I explicitly disable in\n~/.gitconfig, so I haven't looked at it again for a while. Since\nthen, the usual stream of questions about how to recover from people\nwho accidentally detached HEAD has still been showing up in #git, so I\ndon't think the message succeeded in its purpose.\n\nThat might be partly because it is too long to digest at a glance.\n\nWhen I see this message, what I actually take in is\n\n $ git checkout v1.7.3\n Hmm, capital --->Note: checking out 'v1.7.3'.\n heading before\n lowercase You are in 'detached HEAD' state. You ...\n sentence.\n ... checkout.\n\n If you want ...\n do so (now or later) by using -b .... Example:\n\n git ...\n\n HEAD is ...\n Phew, I can ---->$\n type commands\n again.\n\nWhereas I think the message is just meant to convey the following:\n\n $ git checkout v2.6.17\n note: checking out a tag for inspection and discardable experiments on top\n\n To create a new branch to save your changes:\n\n git checkout -b my-branch-based-on-v2.6.17\n\n HEAD is now at 427abfa... Linux v2.6.17\n $\n\n> ------------------------------------------------\n> \n> @@ -326,7 +333,7 @@ and git branch shows that you are no longer on a branch:\n> $ cat .git/HEAD\n> 427abfa28afedffadfca9dd8b067eb6d36bac53f\n> $ git branch\n> -* (no branch)\n> +* (detached from v2.6.17)\n\n\tgrep \"no branch\" Documentation/user-manual.txt\n\nfinds two other instances of that message, which this branch doesn't\ntouch. One is about a bisection, where (no branch) is pretty close\nto the actual message ('(no branch, bisect started on master)').\nThe other is about submodules. Here's a patch for potential squashing\nin that corrects it.\n\nThanks,\nJonathan\n\ndiff --git i/Documentation/user-manual.txt w/Documentation/user-manual.txt\nindex 3e226190..b76219ee 100644\n--- i/Documentation/user-manual.txt\n+++ w/Documentation/user-manual.txt\n@@ -3647,7 +3647,7 @@ working on a branch.\n \n -------------------------------------------------\n $ git branch\n-* (no branch)\n+* (detached from d266b98)\n master\n -------------------------------------------------\n \n"},{"id":"225814","messageId":"xmqq1u5imnna.fsf@gitster.dls.corp.google.com","threadId":"34759","inReplyTo":"883409466.1091151.1377329645768.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 11/13] Remove obscure reference from \"Examples\"","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2013-08-25T03:53:45Z","receivedAt":"2013-08-25T03:53:45Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Thomas Ackermann writes:\n\n> Signed-off-by: Thomas Ackermann \n> ---\n> Documentation/user-manual.txt | 2 --\n> 1 file changed, 2 deletions(-)\n>\n> diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\n> index aa6bfab..0d3f04e 100644\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -2131,8 +2131,6 @@ He uses two public branches:\n> \n> - A \"test\" tree into which patches are initially placed so that they\n> can get some exposure when integrated with other ongoing development.\n> - This tree is available to Andrew for pulling into -mm whenever he\n> - wants.\n> \n> - A \"release\" tree into which tested patches are moved for final sanity\n> checking, and as a vehicle to send them upstream to Linus (by sending\n\nHmm.... What part is obscure and why does this need to be removed?\n"},{"id":"225815","messageId":"xmqqwqnal8yv.fsf@gitster.dls.corp.google.com","threadId":"34759","inReplyTo":"1749978317.1091238.1377329758522.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 12/13] Remove irrelevant reference from \"Tying it all together\"","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2013-08-25T03:56:08Z","receivedAt":"2013-08-25T03:56:08Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Thomas Ackermann writes:\n\n> Sorry Jon, but this might not be of any help to new Git users ;)\n>\n> Signed-off-by: Thomas Ackermann \n\nYeah, I think this is long overdue. The drawing was taken from an\ne-mail posted in a discussion, and the credit should have been given\nin the commit log message, not in-text.\n\n\n> ---\n> Documentation/user-manual.txt | 3 +--\n> 1 file changed, 1 insertion(+), 2 deletions(-)\n>\n> diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\n> index 0d3f04e..08d8c91 100644\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -3908,8 +3908,7 @@ save the note about that state, in practice we tend to just write the\n> result to the file pointed at by `.git/HEAD`, so that we can always see\n> what the last committed state was.\n> \n> -Here is an ASCII art by Jon Loeliger that illustrates how\n> -various pieces fit together.\n> +Here is a picture that illustrates how various pieces fit together:\n> \n> ------------\n"},{"id":"225816","messageId":"xmqqsixyl8sl.fsf@gitster.dls.corp.google.com","threadId":"34759","inReplyTo":"1590776724.1091303.1377329872606.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 13/13] \"git prune\" is safe now","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2013-08-25T03:59:54Z","receivedAt":"2013-08-25T03:59:54Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Thomas Ackermann writes:\n\n> According to the man-pages of \"git prune\" and \"git fsck\",\n> both are safe nowadays.\n\nSafe does not have much to do with the latter. \"git fsck\" has\nalways been safe in that it would not alter the object store, and if\nyou run it while you are actively creating (or pruning for that\nmatter) objects, it _will_ get confused.\n\nFor that matter, running \"prune\", even though we designed it to be\nsafe from concurrent accesses, deliberately on a non-quiescent\nrepository is not a good idea, either. It may be a good idea to\nweaken the phrasing used to discourage it, but discouraging itself\nis not a bad idea.\n\n> Signed-off-by: Thomas Ackermann \n> ---\n> Documentation/user-manual.txt | 12 +-----------\n> 1 file changed, 1 insertion(+), 11 deletions(-)\n>\n> diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\n> index 08d8c91..29945d9 100644\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -3283,17 +3283,7 @@ state, you can just prune all unreachable objects:\n> $ git prune\n> ------------------------------------------------\n> \n> -and they'll be gone. But you should only run `git prune` on a quiescent\n> -repository--it's kind of like doing a filesystem fsck recovery: you\n> -don't want to do that while the filesystem is mounted.\n> -\n> -(The same is true of `git fsck` itself, btw, but since\n> -`git fsck` never actually *changes* the repository, it just reports\n> -on what it found, `git fsck` itself is never 'dangerous' to run.\n> -Running it while somebody is actually changing the repository can cause\n> -confusing and scary messages, but it won't actually do anything bad. In\n> -contrast, running `git prune` while somebody is actively changing the\n> -repository is a *BAD* idea).\n> +and they'll be gone. \n> \n> [[recovering-from-repository-corruption]]\n> Recovering from repository corruption\n"},{"id":"225818","messageId":"20130825041553.GC2882@elie.Belkin","threadId":"34759","inReplyTo":"1172777180.1090921.1377329200690.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 03/13] Use current output for \"git repack\"","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2013-08-25T04:15:53Z","receivedAt":"2013-08-25T04:15:53Z","isPatch":true,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Thomas Ackermann wrote:\n\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -3203,14 +3203,11 @@ To put the loose objects into a pack, just run git repack:\n> \n> ------------------------------------------------\n> $ git repack\n[...]\n> -Total 6020, written 6020 (delta 4070), reused 0 (delta 0)\n> -Pack pack-3e54ad29d5b2e05838c75df582c65257b8d08e1c created.\n> +Total 6020 (delta 4070), reused 0 (delta 0)\n\nSure. I wonder if there should be some text to replace the output\nthat mentions the pack being created, though. E.g.:\n\n> ------------------------------------------------\n> \n> You can then run\n\n\tTotal 6020 (delta 4070), reused 0 (delta 0)\n\t------------------------------------------------\n\n\tThis creates a single \"pack file\" in .git/objects/pack/ containing\n\tall currently unpacked objects. You can then run\n"},{"id":"225819","messageId":"20130825041912.GD2882@elie.Belkin","threadId":"34759","inReplyTo":"694030462.1090937.1377329263413.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 04/13] Use \"git merge\" instead of \"git pull .\"","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2013-08-25T04:19:12Z","receivedAt":"2013-08-25T04:19:12Z","isPatch":true,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Thomas Ackermann wrote:\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -1784,17 +1784,6 @@ repository that you pulled from.\n> <>; instead, your branch will just be\n> updated to point to the latest commit from the upstream branch.)\n> \n> -The `git pull` command can also be given `.` as the \"remote\" repository,\n> -in which case it just merges in a branch from the current repository; so\n> -the commands\n> -\n> --------------------------------------------------\n> -$ git pull . branch\n> -$ git merge branch\n> --------------------------------------------------\n> -\n> -are roughly equivalent. The former is actually very commonly used.\n> -\n\nI wonder if it would make sense to say they simply *are* equivalent.\nI.e., what differences are there between those two commands, and could\n\"git pull\" be tweaked to eliminate them?\n\nI agree that the historical \"The former is actually very commonly\nused\" ought to go. It wouldn't too relevant for someone learning to\nuse git even if it were still true. ;-)\n\n[...]\n> @@ -2259,7 +2248,7 @@ When you are happy with the state of this change, you can pull it into the\n> \"test\" branch in preparation to make it public:\n> \n> -------------------------------------------------\n> -$ git checkout test && git pull . speed-up-spinlocks\n> +$ git checkout test && git merge speed-up-spinlocks\n> -------------------------------------------------\n\nYes.\n\nHope that helps,\nJonathan\n"},{"id":"225824","messageId":"20130825050159.GH2882@elie.Belkin","threadId":"34759","inReplyTo":"1171853844.1090991.1377329328622.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 05/13] Fix some typos","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2013-08-25T05:01:59Z","receivedAt":"2013-08-25T05:01:59Z","isPatch":true,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Thomas Ackermann wrote:\n\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -219,7 +219,7 @@ of development leading to that point.\n> \n> The best way to see how this works is using the linkgit:gitk[1]\n> command; running gitk now on a Git repository and looking for merge\n> -commits will help understand how the Git organizes history.\n> +commits will help understand how Git organizes history.\n\nHeh. Sure.\n\n[...]\n> @@ -793,7 +793,7 @@ e05db0fd4f31dde7005f075a84f96b360d05984b\n> -------------------------------------------------\n> \n> Or you could recall that the `...` operator selects all commits\n> -contained reachable from either one reference or the other but not\n> +reachable from either one reference or the other but not\n> both; so\n\nYes. Here one of the references is the nickname of a remote and not a\nbranch, so \"reachable from\" reads better than \"contained in\" would.\n\n> @@ -820,7 +820,7 @@ You could just visually inspect the commits since e05db0fd:\n> $ gitk e05db0fd..\n> -------------------------------------------------\n> \n> -Or you can use linkgit:git-name-rev[1], which will give the commit a\n> +or you can use linkgit:git-name-rev[1], which will give the commit a\n\nI think this reads better with a capital 'O'. (The pedant in me\nlikes it, too, since a colon ends a sentence.)\n\nThe lowercase 'but' later in this section should perhaps also be\ncapitalized, since it also starts an independent thought.\n\n\tBut that may sometimes help you guess which tags come after the\n\tgiven commit.\n\nThe sentence \"So, you can run something like ... then search for a\nline that looks like ...\" is a sequence of incomplete thoughts. It\ncould be paraphrased a little to scan better:\n\n\tSo, if you run something like \"git show-branch e05db0fd\n\tv1.5.0-rc0 v1.5.0-rc1 v1.5.0-rc2\"\n\n\t\t$ git show-branch e05db0fd v1.5.0-rc0 v1.5.0-rc1 v1.5.0-rc2\n\t\t! [e05db...\n\n\tthen a line like\n\n\t\t+ ++ [e05db0fd] Fix warnings in ...\n\n\tshows that e05db0fd is reachable from itself, from v1.5.0-rc1,\n\tand from v1.5.0-rc2, and not from v1.5.0-rc0.\n\n[...]\n> @@ -3525,7 +3525,7 @@ with Git 1.5.2 can look up the submodule commits in the repository and\n> manually check them out; earlier versions won't recognize the submodules at\n> all.\n> \n> -To see how submodule support works, create (for example) four example\n> +To see how submodule support works, create four example\n\nI'd keep the joke.\n\n[...]\n> @@ -3897,7 +3897,7 @@ fact that such a commit brings together (\"merges\") two or more\n> previous states represented by other commits.\n> \n> In other words, while a \"tree\" represents a particular directory state\n> -of a working directory, a \"commit\" represents that state in \"time\",\n> +of a working directory, a \"commit\" represents that state in time,\n> and explains how we got there.\n\nIt's not really about time but about (hypothetical, possibly branched)\nhistory, but I think your change makes it about as clear as it can be.\n\nThanks, and hope that helps,\nJonathan\n"},{"id":"225823","messageId":"20130825050527.GI2882@elie.Belkin","threadId":"34759","inReplyTo":"1687455733.1090999.1377329376866.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 06/13] Simplify \"How to make a commit\"","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2013-08-25T05:05:27Z","receivedAt":"2013-08-25T05:05:27Z","isPatch":true,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Thomas Ackermann wrote:\n\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -1080,19 +1080,14 @@ produce no output at that point.\n> \n> Modifying the index is easy:\n> \n> -To update the index with the new contents of a modified file, use\n> +To add the contents of a new file to the index or update the index \n> +with the new contents of a modified file, use\n\nThat's a mouthful. I'd say\n\n\tTo update the index with the contents of a new or modified file, use\n\n[...]\n> -To add the contents of a new file to the index, use\n> -\n> --------------------------------------------------\n> -$ git add path/to/file\n> --------------------------------------------------\n> -\n\n\\o/\n\n> -To remove a file from the index and from the working tree,\n> +To remove a file from the index and from the working tree, use\n> \n> -------------------------------------------------\n> $ git rm path/to/file\n\nIn git 2.0, (plain \"rm\" followed by) \"git add\" should work for this,\ntoo.\n"},{"id":"225825","messageId":"20130825050820.GJ2882@elie.Belkin","threadId":"34759","inReplyTo":"8609038.1091034.1377329428557.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 07/13] Improve description in \"How to merge\"","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2013-08-25T05:08:20Z","receivedAt":"2013-08-25T05:08:20Z","isPatch":true,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Thomas Ackermann wrote:\n\n> Describe the conflict resolution in terms of the\n> commands the user is supposed to use.\n[...]\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -1251,10 +1251,8 @@ Automatic merge failed; fix conflicts and then commit the result.\n> -------------------------------------------------\n> \n> Conflict markers are left in the problematic files, and after\n> -you resolve the conflicts manually, you can update the index\n> -with the contents and run Git commit, as you normally would when\n> -creating a new file.\n\nHm. It's been too long since I was a novice, since I find the above\nclear already.\n\nTo make the text clearer, I think it would be best to *add* an example\ninstead of replacing it by one.\n\nThanks,\nJonathan\n"},{"id":"225827","messageId":"20130825052327.GK2882@elie.Belkin","threadId":"34759","inReplyTo":"1473018875.1091101.1377329545934.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 09/13] Improve section \"Merge multiple trees\"","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2013-08-25T05:23:27Z","receivedAt":"2013-08-25T05:23:27Z","isPatch":true,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Thomas Ackermann wrote:\n\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -3992,16 +3992,16 @@ Merging multiple trees\n> \n> Git helps you do a three-way merge, which you can expand to n-way by\n> repeating the merge procedure arbitrary times until you finally\n> -\"commit\" the state.\n> +commit the state.\n\nThe above sentence is unclear to me both before and after this change.\n\nGit helps me do a three-way merge, but I'm on my own if I want to\nexpand to n-way? Those times I repeat it are arbitrary times, not\narbitrarily many times? Using \"git merge\" I make commits, but I\ndo not finally commit to the result until the (n-1)st? And what is\nthis state I am committing?\n\nMaybe the intent is\n\n\tGit can help you perform a three-way merge, which can in turn be\n\tused for a many-way merge by repeating the merge procedure several\n\ttimes. The usual situation is that you only do one three-way merge\n\t(reconciling two lines of history) and commit the result, but if\n\tyou like to, you can merge several branches in one go.\n\n\tTo perform a three-way merge, you start with the two commits you\n\twant to merge, find their closest common parent (a third commit),\n\tand compare the trees corresponding to these three commits.\n\n\tTo get the \"base\" for the merge, look up the common parent of two\n\tcommits:\n\n\t\t$ git merge-base \n\n\tThis prints the name of a commit they are both based on.\n\t...\n\n[...]\n> -To get the \"base\" for the merge, you first look up the common parent\n> +To get the base for the merge, you first look up the common parent\n\nMerge base hasn't been defined, so this is using quotes to point out\nthat it is defining a new, unfamiliar term.\n\n[...]\n> -now look up the \"tree\" objects of those commits, which you can easily\n> -do with (for example)\n> +now look up the tree objects of those commits, which you can easily\n> +do with\n\nYes.\n"},{"id":"225828","messageId":"20130825052553.GL2882@elie.Belkin","threadId":"34759","inReplyTo":"883409466.1091151.1377329645768.JavaMail.ngmail@webmail08.arcor-online.net","subject":"Re: [PATCH 11/13] Remove obscure reference from \"Examples\"","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2013-08-25T05:25:53Z","receivedAt":"2013-08-25T05:25:53Z","isPatch":true,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Thomas Ackermann wrote:\n\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -2131,8 +2131,6 @@ He uses two public branches:\n> \n> - A \"test\" tree into which patches are initially placed so that they\n> can get some exposure when integrated with other ongoing development.\n> - This tree is available to Andrew for pulling into -mm whenever he\n> - wants.\n\nThis drops useful information (namely, that Tony was publishing\nhistory for two people to consume). Perhaps it should spell out \"the\nbleeding-edge -mm tree\"?\n\nJonathan\n"},{"id":"225830","messageId":"CANiSa6iQKgwbc7bD5+V0XZdqOf=6OvyxO3zay3v87vB3UTLivQ@mail.gmail.com","threadId":"34759","inReplyTo":"20130825041912.GD2882@elie.Belkin","subject":"Re: [PATCH 04/13] Use \"git merge\" instead of \"git pull .\"","fromName":"Martin von Zweigbergk","fromEmail":"martinvonz@gmail.com","sentAt":"2013-08-25T05:26:48Z","receivedAt":"2013-08-25T05:26:48Z","isPatch":true,"sender":{"key":"martinvonz@gmail.com","avatar":"https://avatars.githubusercontent.com/u/891642?v=4"},"body":"On Sat, Aug 24, 2013 at 9:19 PM, Jonathan Nieder wrote:\n> Thomas Ackermann wrote:\n>> --- a/Documentation/user-manual.txt\n>> +++ b/Documentation/user-manual.txt\n>> @@ -1784,17 +1784,6 @@ repository that you pulled from.\n>> <>; instead, your branch will just be\n>> updated to point to the latest commit from the upstream branch.)\n>>\n>> -The `git pull` command can also be given `.` as the \"remote\" repository,\n>> -in which case it just merges in a branch from the current repository; so\n>> -the commands\n>> -\n>> --------------------------------------------------\n>> -$ git pull . branch\n>> -$ git merge branch\n>> --------------------------------------------------\n>> -\n>> -are roughly equivalent. The former is actually very commonly used.\n>> -\n>\n> I wonder if it would make sense to say they simply *are* equivalent.\n> I.e., what differences are there between those two commands, and could\n> \"git pull\" be tweaked to eliminate them?\n\nOne difference is that \"git pull\" can be configured to rebase.\n\n> [...]\n>> @@ -2259,7 +2248,7 @@ When you are happy with the state of this change, you can pull it into the\n>> \"test\" branch in preparation to make it public:\n\nI realize that \"pull\" here is not necessarily about the command, but\nperhaps it would still make sense to change it?\n"},{"id":"225844","messageId":"1764880917.480568.1377418240632.JavaMail.ngmail@webmail16.arcor-online.net","threadId":"34759","inReplyTo":"20130825034916.GB2882@elie.Belkin","subject":"Aw: Re: [PATCH 02/13] Use current \"detached HEAD\" message","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-25T08:10:40Z","receivedAt":"2013-08-25T08:10:40Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":" \n> \n> I wonder if this longer wall of text (added in 13be3e31, 2010-01-29)\n> is too aggressive.\n> \n> It is the only piece of advice that I explicitly disable in\n> ~/.gitconfig, so I haven't looked at it again for a while. Since\n> then, the usual stream of questions about how to recover from people\n> who accidentally detached HEAD has still been showing up in #git, so I\n> don't think the message succeeded in its purpose.\n> \n\nI like the message :-) But of course without really knowing how a\n\"detached HEAD\" looks like in the object store, people might feel\nunsure about what to do next.\n\n> \n> \tgrep \"no branch\" Documentation/user-manual.txt\n> \n> finds two other instances of that message, which this branch doesn't\n> touch. One is about a bisection, where (no branch) is pretty close\n> to the actual message ('(no branch, bisect started on master)').\n> The other is about submodules. Here's a patch for potential squashing\n> in that corrects it.\n> \n\nThanks for spotting this!\n\n\n---\nThomas\n"},{"id":"225845","messageId":"2117090477.480920.1377419868272.JavaMail.ngmail@webmail16.arcor-online.net","threadId":"34759","inReplyTo":"20130825041553.GC2882@elie.Belkin","subject":"Aw: Re: [PATCH 03/13] Use current output for \"git repack\"","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-25T08:37:48Z","receivedAt":"2013-08-25T08:37:48Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":" \n> \n> Sure. I wonder if there should be some text to replace the output\n> that mentions the pack being created, though. E.g.:\n> \n> > ------------------------------------------------\n> > \n> > You can then run\n> \n> \tTotal 6020 (delta 4070), reused 0 (delta 0)\n> \t------------------------------------------------\n> \n> \tThis creates a single \"pack file\" in .git/objects/pack/ containing\n> \tall currently unpacked objects. You can then run\n> \n\nOK; thanks! I will add this.\n\n---\nThomas\n"},{"id":"225850","messageId":"892787868.481320.1377421991470.JavaMail.ngmail@webmail16.arcor-online.net","threadId":"34759","inReplyTo":"20130825050159.GH2882@elie.Belkin","subject":"Aw: Re: [PATCH 05/13] Fix some typos","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-25T09:13:11Z","receivedAt":"2013-08-25T09:13:11Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":" \n> > \n> > -Or you can use linkgit:git-name-rev[1], which will give the commit a\n> > +or you can use linkgit:git-name-rev[1], which will give the commit a\n> \n> I think this reads better with a capital 'O'. (The pedant in me\n> likes it, too, since a colon ends a sentence.)\n> \n> The lowercase 'but' later in this section should perhaps also be\n> capitalized, since it also starts an independent thought.\n> \n> \tBut that may sometimes help you guess which tags come after the\n> \tgiven commit.\n>\n\nI am no native speaker, but I am a little reluctant to start a new sentence\nwith \"But\" or \"Or\". \n\n> The sentence \"So, you can run something like ... then search for a\n> line that looks like ...\" is a sequence of incomplete thoughts. It\n> could be paraphrased a little to scan better:\n> \n> \tSo, if you run something like \"git show-branch e05db0fd\n> \tv1.5.0-rc0 v1.5.0-rc1 v1.5.0-rc2\"\n> \n> \t\t$ git show-branch e05db0fd v1.5.0-rc0 v1.5.0-rc1 v1.5.0-rc2\n> \t\t! [e05db...\n> \n> \tthen a line like\n> \n> \t\t+ ++ [e05db0fd] Fix warnings in ...\n> \n> \tshows that e05db0fd is reachable from itself, from v1.5.0-rc1,\n> \tand from v1.5.0-rc2, and not from v1.5.0-rc0.\n> \n\nOK; thanks! I will add this.\n\n> > \n> > -To see how submodule support works, create (for example) four example\n> > +To see how submodule support works, create four example\n> \n> I'd keep the joke.\n>\n\nI totally missed the joke ...\n\n\n---\nThomas\n"},{"id":"225851","messageId":"397485266.481399.1377422404293.JavaMail.ngmail@webmail16.arcor-online.net","threadId":"34759","inReplyTo":"20130825050527.GI2882@elie.Belkin","subject":"Aw: Re: [PATCH 06/13] Simplify \"How to make a commit\"","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-25T09:20:04Z","receivedAt":"2013-08-25T09:20:04Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":" \n> \n> That's a mouthful. I'd say\n> \n> \tTo update the index with the contents of a new or modified file, use\n> \n\nOK; thanks! I will change this.\n\n\n---\nThomas\n"},{"id":"225852","messageId":"923442091.481498.1377423015102.JavaMail.ngmail@webmail16.arcor-online.net","threadId":"34759","inReplyTo":"20130825052553.GL2882@elie.Belkin","subject":"Aw: Re: [PATCH 11/13] Remove obscure reference from \"Examples\"","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-25T09:30:15Z","receivedAt":"2013-08-25T09:30:15Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":" \n> > \n> > - A \"test\" tree into which patches are initially placed so that they\n> > can get some exposure when integrated with other ongoing development.\n> > - This tree is available to Andrew for pulling into -mm whenever he\n> > - wants.\n> \n> This drops useful information (namely, that Tony was publishing\n> history for two people to consume). Perhaps it should spell out \"the\n> bleeding-edge -mm tree\"?\n> \n\nThis is even worse for me;-) For everyone not involved in Linux kernel development\nthis sentence completely makes no sense. Is there perhaps a more general\ndescription for the situation?\n\n\n---\nThomas\n"},{"id":"225857","messageId":"1995597369.483398.1377430269986.JavaMail.ngmail@webmail16.arcor-online.net","threadId":"34759","inReplyTo":"20130825050820.GJ2882@elie.Belkin","subject":"Aw: Re: [PATCH 07/13] Improve description in \"How to merge\"","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-25T11:31:09Z","receivedAt":"2013-08-25T11:31:09Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":" \n> \n> Hm. It's been too long since I was a novice, since I find the above\n> clear already.\n> \n\nOK; I will drop that patch.\n\n\n---\nThomas\n"},{"id":"225858","messageId":"697469569.483506.1377430865590.JavaMail.ngmail@webmail16.arcor-online.net","threadId":"34759","inReplyTo":"xmqqioyumoxr.fsf@gitster.dls.corp.google.com","subject":"Aw: Re: [PATCH 08/13] Improve section \"Manipulating branches\"","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-25T11:41:05Z","receivedAt":"2013-08-25T11:41:05Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":" \n> \n> But is this correct? I somehow thought that we check with the\n> current or the upstream.\n> \n\nYou are correct. I will add this. Thanks.\n\n\n---\nThomas\n"},{"id":"225859","messageId":"2127851205.483802.1377432379441.JavaMail.ngmail@webmail16.arcor-online.net","threadId":"34759","inReplyTo":"20130825052327.GK2882@elie.Belkin","subject":"Aw: Re: [PATCH 09/13] Improve section \"Merge multiple trees\"","fromName":"Thomas Ackermann","fromEmail":"th.acker@arcor.de","sentAt":"2013-08-25T12:06:19Z","receivedAt":"2013-08-25T12:06:19Z","isPatch":true,"sender":{"key":"th.acker@arcor.de","avatar":"https://avatars.githubusercontent.com/u/1358536?v=4"},"body":"> \n> Maybe the intent is\n> \n> \tGit can help you perform a three-way merge, which can in turn be\n> \tused for a many-way merge by repeating the merge procedure several\n> \ttimes. The usual situation is that you only do one three-way merge\n> \t(reconciling two lines of history) and commit the result, but if\n> \tyou like to, you can merge several branches in one go.\n> \n> \tTo perform a three-way merge, you start with the two commits you\n> \twant to merge, find their closest common parent (a third commit),\n> \tand compare the trees corresponding to these three commits.\n> \n> \tTo get the \"base\" for the merge, look up the common parent of two\n> \tcommits:\n> \n> \t\t$ git merge-base \n> \n> \tThis prints the name of a commit they are both based on.\n> \t...\n> \n\nThanks! Your text is much better than the original one (and my small changes didn't\neven try to improve the text per se). \nIf you don't mind I will use your text and add your sign-off for this patch.\n\n\n\n---\nThomas\n"},{"id":"225873","messageId":"20130825201013.GB2752@elie.Belkin","threadId":"34759","inReplyTo":"2127851205.483802.1377432379441.JavaMail.ngmail@webmail16.arcor-online.net","subject":"Re: Re: [PATCH 09/13] Improve section \"Merge multiple trees\"","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2013-08-25T20:10:13Z","receivedAt":"2013-08-25T20:10:13Z","isPatch":true,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Thomas Ackermann wrote:\n\n>> Maybe the intent is\n>>\n>> \tGit can help you perform a three-way merge, which can in turn be\n[...]\n> If you don't mind I will use your text\n\nNo problem.\nSigned-off-by: Jonathan Nieder \n"},{"id":"225898","messageId":"E1VDxCG-0003Wz-H2@jdl.com","threadId":"34759","inReplyTo":"xmqqwqnal8yv.fsf@gitster.dls.corp.google.com","subject":"Re: [PATCH 12/13] Remove irrelevant reference from \"Tying it all together\"","fromName":"Jon Loeliger","fromEmail":"jdl@jdl.com","sentAt":"2013-08-26T13:51:08Z","receivedAt":"2013-08-26T13:51:08Z","isPatch":true,"sender":{"key":"jdl@jdl.com","avatar":"https://gravatar.com/avatar/75ce9a10b151acd2c28ec4ab2136dba7b2ff1634530bd04b155981a749d08a64?d=mp&s=160"},"body":"> Thomas Ackermann writes:\n> \n> > Sorry Jon, but this might not be of any help to new Git users ;)\n> >\n> > Signed-off-by: Thomas Ackermann \n> \n> Yeah, I think this is long overdue. The drawing was taken from an\n> e-mail posted in a discussion, and the credit should have been given\n> in the commit log message, not in-text.\n> \n> \n> > ---\n> > Documentation/user-manual.txt | 3 +--\n> > 1 file changed, 1 insertion(+), 2 deletions(-)\n> >\n> > diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\n> > index 0d3f04e..08d8c91 100644\n> > --- a/Documentation/user-manual.txt\n> > +++ b/Documentation/user-manual.txt\n> > @@ -3908,8 +3908,7 @@ save the note about that state, in practice we tend t\n> o just write the\n> > result to the file pointed at by `.git/HEAD`, so that we can always see\n> > what the last committed state was.\n> > \n> > -Here is an ASCII art by Jon Loeliger that illustrates how\n> > -various pieces fit together.\n> > +Here is a picture that illustrates how various pieces fit together:\n> > \n> > ------------\n\nHeh. Totally agree. I don't need my name on *that*\nbit of Git documentation. If needed, you can find\nmy name on *other* Git documentation. :-)\n\nAcked-by: Jon Loeliger \n\njdl\n"}]}