{"thread":{"id":"10848","subject":"[PATCH] user-manual.txt: fix a few mistakes","startedAt":"2007-11-13T18:19:39Z","lastAt":"2007-11-16T11:34:22Z","messageCount":10,"participants":["Sergei Organov","Junio C Hamano","J. Bruce Fields"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"59708","messageId":"87bq9x7w4d.fsf@osv.gnss.ru","threadId":"10848","inReplyTo":null,"subject":"[PATCH] user-manual.txt: fix a few mistakes","fromName":"Sergei Organov","fromEmail":"osv@javad.com","sentAt":"2007-11-13T18:19:39Z","receivedAt":"2007-11-13T18:19:39Z","isPatch":true,"sender":{"key":"osv@javad.com","avatar":null},"body":"\nSigned-off-by: Sergei Organov <osv@javad.com>\n---\n Documentation/user-manual.txt |    8 ++++----\n 1 files changed, 4 insertions(+), 4 deletions(-)\n\ndiff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\nindex d99adc6..a169ef0 100644\n--- a/Documentation/user-manual.txt\n+++ b/Documentation/user-manual.txt\n@@ -475,7 +475,7 @@ Bisecting: 3537 revisions left to test after this\n If you run \"git branch\" at this point, you'll see that git has\n temporarily moved you to a new branch named \"bisect\".  This branch\n points to a commit (with commit id 65934...) that is reachable from\n-v2.6.19 but not from v2.6.18.  Compile and test it, and see whether\n+\"master\" but not from v2.6.18.  Compile and test it, and see whether\n it crashes.  Assume it does crash.  Then:\n \n -------------------------------------------------\n@@ -1367,7 +1367,7 @@ If you make a commit that you later wish you hadn't, there are two\n fundamentally different ways to fix the problem:\n \n \t1. You can create a new commit that undoes whatever was done\n-\tby the previous commit.  This is the correct thing if your\n+\tby the old commit.  This is the correct thing if your\n \tmistake has already been made public.\n \n \t2. You can go back and modify the old commit.  You should\n@@ -1567,8 +1567,8 @@ old history using, for example,\n $ git log master@{1}\n -------------------------------------------------\n \n-This lists the commits reachable from the previous version of the head.\n-This syntax can be used to with any git command that accepts a commit,\n+This lists the commits reachable from the previous version of the branch.\n+This syntax can be used with any git command that accepts a commit,\n not just with git log.  Some other examples:\n \n -------------------------------------------------\n-- \n1.5.3.4\n"},{"id":"59819","messageId":"7vlk91mgz6.fsf@gitster.siamese.dyndns.org","threadId":"10848","inReplyTo":"87bq9x7w4d.fsf@osv.gnss.ru","subject":"Re: [PATCH] user-manual.txt: fix a few mistakes","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2007-11-14T07:19:41Z","receivedAt":"2007-11-14T07:19:41Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Sergei Organov <osv@javad.com> writes:\n\n> Signed-off-by: Sergei Organov <osv@javad.com>\n> ---\n>  Documentation/user-manual.txt |    8 ++++----\n>  1 files changed, 4 insertions(+), 4 deletions(-)\n>\n> diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\n> index d99adc6..a169ef0 100644\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -475,7 +475,7 @@ Bisecting: 3537 revisions left to test after this\n>  If you run \"git branch\" at this point, you'll see that git has\n>  temporarily moved you to a new branch named \"bisect\".  This branch\n>  points to a commit (with commit id 65934...) that is reachable from\n> -v2.6.19 but not from v2.6.18.  Compile and test it, and see whether\n> +\"master\" but not from v2.6.18.  Compile and test it, and see whether\n>  it crashes.  Assume it does crash.  Then:\n>  \n>  -------------------------------------------------\n\nThanks.\n\nThis hunk and the last hunk I do not have any problem with.\n\n> @@ -1367,7 +1367,7 @@ If you make a commit that you later wish you hadn't, there are two\n>  fundamentally different ways to fix the problem:\n>  \n>  \t1. You can create a new commit that undoes whatever was done\n> -\tby the previous commit.  This is the correct thing if your\n> +\tby the old commit.  This is the correct thing if your\n>  \tmistake has already been made public.\n>  \n>  \t2. You can go back and modify the old commit.  You should\n\nBut is this an improvement or just a churn?\n\n> @@ -1567,8 +1567,8 @@ old history using, for example,\n>  $ git log master@{1}\n>  -------------------------------------------------\n>  \n> -This lists the commits reachable from the previous version of the head.\n> -This syntax can be used to with any git command that accepts a commit,\n> +This lists the commits reachable from the previous version of the branch.\n> +This syntax can be used with any git command that accepts a commit,\n>  not just with git log.  Some other examples:\n>  \n>  -------------------------------------------------\n"},{"id":"59847","messageId":"87ir455713.fsf@osv.gnss.ru","threadId":"10848","inReplyTo":"7vlk91mgz6.fsf@gitster.siamese.dyndns.org","subject":"Re: [PATCH] user-manual.txt: fix a few mistakes","fromName":"Sergei Organov","fromEmail":"osv@javad.com","sentAt":"2007-11-14T12:46:32Z","receivedAt":"2007-11-14T12:46:32Z","isPatch":true,"sender":{"key":"osv@javad.com","avatar":null},"body":"Junio C Hamano <gitster@pobox.com> writes:\n\n> Sergei Organov <osv@javad.com> writes:\n>\n>> Signed-off-by: Sergei Organov <osv@javad.com>\n>> ---\n>>  Documentation/user-manual.txt |    8 ++++----\n>>  1 files changed, 4 insertions(+), 4 deletions(-)\n>>\n>> diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\n>> index d99adc6..a169ef0 100644\n>> --- a/Documentation/user-manual.txt\n>> +++ b/Documentation/user-manual.txt\n>> @@ -475,7 +475,7 @@ Bisecting: 3537 revisions left to test after this\n>>  If you run \"git branch\" at this point, you'll see that git has\n>>  temporarily moved you to a new branch named \"bisect\".  This branch\n>>  points to a commit (with commit id 65934...) that is reachable from\n>> -v2.6.19 but not from v2.6.18.  Compile and test it, and see whether\n>> +\"master\" but not from v2.6.18.  Compile and test it, and see whether\n>>  it crashes.  Assume it does crash.  Then:\n>>  \n>>  -------------------------------------------------\n>\n> Thanks.\n>\n> This hunk and the last hunk I do not have any problem with.\n>\n>> @@ -1367,7 +1367,7 @@ If you make a commit that you later wish you hadn't, there are two\n>>  fundamentally different ways to fix the problem:\n>>  \n>>  \t1. You can create a new commit that undoes whatever was done\n>> -\tby the previous commit.  This is the correct thing if your\n>> +\tby the old commit.  This is the correct thing if your\n>>  \tmistake has already been made public.\n>>  \n>>  \t2. You can go back and modify the old commit.  You should\n>\n> But is this an improvement or just a churn?\n\nI believe this is an improvement. It's more precise. With this change\nit's crystal clear that both (1) and (2) above mean the same commit by\ncalling it \"the old commit\". Before the change, when I read this the\nfirst time, I've got the term \"previous\" here literally, i.e., as the\nlast commit made, and I thought that if the commit in question is the\nlast one, I should do (1), otherwise -- (2). This confusion admittedly\nvanished rather quickly, but it did happen.\n\nIf I didn't manage to express my first impression clearly (English is\nnot my mothers' tongue), try to read this to get similar impression:\n\n  1. You can create a new commit that undoes whatever was done\n     by the previous commit.\n\n  2. You can go back and modify the old commit.\n\nDo you see the problem?\n\n-- \nSergei.\n"},{"id":"59858","messageId":"20071114181337.GG14254@fieldses.org","threadId":"10848","inReplyTo":"87ir455713.fsf@osv.gnss.ru","subject":"Re: [PATCH] user-manual.txt: fix a few mistakes","fromName":"J. Bruce Fields","fromEmail":"bfields@fieldses.org","sentAt":"2007-11-14T18:13:37Z","receivedAt":"2007-11-14T18:13:37Z","isPatch":true,"sender":{"key":"bfields@citi.umich.edu","avatar":null},"body":"On Wed, Nov 14, 2007 at 03:46:32PM +0300, Sergei Organov wrote:\n> Junio C Hamano <gitster@pobox.com> writes:\n> \n> > Sergei Organov <osv@javad.com> writes:\n> >\n> >> Signed-off-by: Sergei Organov <osv@javad.com>\n> >> ---\n> >>  Documentation/user-manual.txt |    8 ++++----\n> >>  1 files changed, 4 insertions(+), 4 deletions(-)\n> >>\n> >> diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\n> >> index d99adc6..a169ef0 100644\n> >> --- a/Documentation/user-manual.txt\n> >> +++ b/Documentation/user-manual.txt\n> >> @@ -475,7 +475,7 @@ Bisecting: 3537 revisions left to test after this\n> >>  If you run \"git branch\" at this point, you'll see that git has\n> >>  temporarily moved you to a new branch named \"bisect\".  This branch\n> >>  points to a commit (with commit id 65934...) that is reachable from\n> >> -v2.6.19 but not from v2.6.18.  Compile and test it, and see whether\n> >> +\"master\" but not from v2.6.18.  Compile and test it, and see whether\n> >>  it crashes.  Assume it does crash.  Then:\n> >>  \n> >>  -------------------------------------------------\n> >\n> > Thanks.\n> >\n> > This hunk and the last hunk I do not have any problem with.\n> >\n> >> @@ -1367,7 +1367,7 @@ If you make a commit that you later wish you hadn't, there are two\n> >>  fundamentally different ways to fix the problem:\n> >>  \n> >>  \t1. You can create a new commit that undoes whatever was done\n> >> -\tby the previous commit.  This is the correct thing if your\n> >> +\tby the old commit.  This is the correct thing if your\n> >>  \tmistake has already been made public.\n> >>  \n> >>  \t2. You can go back and modify the old commit.  You should\n> >\n> > But is this an improvement or just a churn?\n> \n> I believe this is an improvement. It's more precise. With this change\n> it's crystal clear that both (1) and (2) above mean the same commit by\n> calling it \"the old commit\". Before the change, when I read this the\n> first time, I've got the term \"previous\" here literally, i.e., as the\n> last commit made, and I thought that if the commit in question is the\n> last one, I should do (1), otherwise -- (2). This confusion admittedly\n> vanished rather quickly, but it did happen.\n\nI think it's a good fix, yes, thanks.--b.\n"},{"id":"59859","messageId":"20071114181858.GH14254@fieldses.org","threadId":"10848","inReplyTo":"87bq9x7w4d.fsf@osv.gnss.ru","subject":"Re: [PATCH] user-manual.txt: fix a few mistakes","fromName":"J. Bruce Fields","fromEmail":"bfields@fieldses.org","sentAt":"2007-11-14T18:18:58Z","receivedAt":"2007-11-14T18:18:58Z","isPatch":true,"sender":{"key":"bfields@citi.umich.edu","avatar":null},"body":"On Tue, Nov 13, 2007 at 09:19:39PM +0300, Sergei Organov wrote:\n> \n> Signed-off-by: Sergei Organov <osv@javad.com>\n> ---\n>  Documentation/user-manual.txt |    8 ++++----\n>  1 files changed, 4 insertions(+), 4 deletions(-)\n> \n> diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\n> index d99adc6..a169ef0 100644\n> --- a/Documentation/user-manual.txt\n> +++ b/Documentation/user-manual.txt\n> @@ -475,7 +475,7 @@ Bisecting: 3537 revisions left to test after this\n>  If you run \"git branch\" at this point, you'll see that git has\n>  temporarily moved you to a new branch named \"bisect\".  This branch\n>  points to a commit (with commit id 65934...) that is reachable from\n> -v2.6.19 but not from v2.6.18.  Compile and test it, and see whether\n> +\"master\" but not from v2.6.18.  Compile and test it, and see whether\n>  it crashes.  Assume it does crash.  Then:\n>  \n>  -------------------------------------------------\n> @@ -1367,7 +1367,7 @@ If you make a commit that you later wish you hadn't, there are two\n>  fundamentally different ways to fix the problem:\n>  \n>  \t1. You can create a new commit that undoes whatever was done\n> -\tby the previous commit.  This is the correct thing if your\n> +\tby the old commit.  This is the correct thing if your\n>  \tmistake has already been made public.\n>  \n>  \t2. You can go back and modify the old commit.  You should\n> @@ -1567,8 +1567,8 @@ old history using, for example,\n>  $ git log master@{1}\n>  -------------------------------------------------\n>  \n> -This lists the commits reachable from the previous version of the head.\n> -This syntax can be used to with any git command that accepts a commit,\n\nI actually prefer \"head\" here.  On something like:\n\n\t\t A--B--C\n\t\t/\n\to--o--o\n\t\t\\\n\t\t o--o--o\n\n\nThe term \"branch\" could be used to refer to the whole line of\ndevelopment consisting of A, B, and C.  The term \"head\", on the other\nhand, refers to either C or a ref that points to it.  We also use the\nterms \"branch head\" or just \"branch\" for that case, but I think \"head\"\nis more precise.\n\n> +This lists the commits reachable from the previous version of the branch.\n> +This syntax can be used with any git command that accepts a commit,\n>  not just with git log.  Some other examples:\n\n(Otherwise looks fine, thanks!)\n\n--b.\n"},{"id":"297500","messageId":"7v8x50hawk.fsf@gitster.siamese.dyndns.org","threadId":"10848","inReplyTo":"20071114181858.GH14254@fieldses.org","subject":"Re: [PATCH] user-manual.txt: fix a few mistakes","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2007-11-14T19:42:03Z","receivedAt":"2007-11-14T19:42:03Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"\"J. Bruce Fields\" <bfields@fieldses.org> writes:\n\n> I actually prefer \"head\" here.  On something like:\n>\n> \t\t A--B--C\n> \t\t/\n> \to--o--o\n> \t\t\\\n> \t\t o--o--o\n>\n>\n> The term \"branch\" could be used to refer to the whole line of\n> development consisting of A, B, and C.  The term \"head\", on the other\n> hand, refers to either C or a ref that points to it.  We also use the\n> terms \"branch head\" or just \"branch\" for that case, but I think \"head\"\n> is more precise.\n>\n>> +This lists the commits reachable from the previous version of the branch.\n>> +This syntax can be used with any git command that accepts a commit,\n>>  not just with git log.  Some other examples:\n>\n> (Otherwise looks fine, thanks!)\n\nOops, I think I skipped the hunk #2 and applied hunk #3.  Will\nfix-up with:\n\n-- >8 --\nFrom: Sergei Organov <osv@javad.com>\nSubject: user-manual: minor rewording for clarity.\n\nJunio screwed up when applying the previous round of the patch;\nrewording from \"previous\" to \"old\" does make the description\nclearer.\n\nAlso revert the rewording from head to branch.  The description\nis talking about the branch's tip commit and using the word head\nis clearer.\n\nBased on input from Sergei and Bruce.\n\nSigned-off-by: Junio C Hamano <gitster@pobox.com>\n\n---\n Documentation/user-manual.txt |    4 ++--\n 1 files changed, 2 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\nindex 60e1385..c7cfbbc 100644\n--- a/Documentation/user-manual.txt\n+++ b/Documentation/user-manual.txt\n@@ -1367,7 +1367,7 @@ If you make a commit that you later wish you hadn't, there are two\n fundamentally different ways to fix the problem:\n \n \t1. You can create a new commit that undoes whatever was done\n-\tby the previous commit.  This is the correct thing if your\n+\tby the old commit.  This is the correct thing if your\n \tmistake has already been made public.\n \n \t2. You can go back and modify the old commit.  You should\n@@ -1567,7 +1567,7 @@ old history using, for example,\n $ git log master@{1}\n -------------------------------------------------\n \n-This lists the commits reachable from the previous version of the branch.\n+This lists the commits reachable from the previous version of the head.\n This syntax can be used with any git command that accepts a commit,\n not just with git log.  Some other examples:\n \n-- \n1.5.3.5.1746.g62954\n"},{"id":"59864","messageId":"20071114194431.GO14254@fieldses.org","threadId":"10848","inReplyTo":"7v8x50hawk.fsf@gitster.siamese.dyndns.org","subject":"Re: [PATCH] user-manual.txt: fix a few mistakes","fromName":"J. Bruce Fields","fromEmail":"bfields@fieldses.org","sentAt":"2007-11-14T19:44:31Z","receivedAt":"2007-11-14T19:44:31Z","isPatch":true,"sender":{"key":"bfields@citi.umich.edu","avatar":null},"body":"On Wed, Nov 14, 2007 at 11:42:03AM -0800, Junio C Hamano wrote:\n> \"J. Bruce Fields\" <bfields@fieldses.org> writes:\n> \n> > I actually prefer \"head\" here.  On something like:\n> >\n> > \t\t A--B--C\n> > \t\t/\n> > \to--o--o\n> > \t\t\\\n> > \t\t o--o--o\n> >\n> >\n> > The term \"branch\" could be used to refer to the whole line of\n> > development consisting of A, B, and C.  The term \"head\", on the other\n> > hand, refers to either C or a ref that points to it.  We also use the\n> > terms \"branch head\" or just \"branch\" for that case, but I think \"head\"\n> > is more precise.\n> >\n> >> +This lists the commits reachable from the previous version of the branch.\n> >> +This syntax can be used with any git command that accepts a commit,\n> >>  not just with git log.  Some other examples:\n> >\n> > (Otherwise looks fine, thanks!)\n> \n> Oops, I think I skipped the hunk #2 and applied hunk #3.  Will\n> fix-up with:\n\nOK, thanks Junio!\n\n--b.\n"},{"id":"59970","messageId":"87lk8z3idj.fsf@osv.gnss.ru","threadId":"10848","inReplyTo":"20071114181858.GH14254@fieldses.org","subject":"Re: [PATCH] user-manual.txt: fix a few mistakes","fromName":"Sergei Organov","fromEmail":"osv@javad.com","sentAt":"2007-11-15T10:36:40Z","receivedAt":"2007-11-15T10:36:40Z","isPatch":true,"sender":{"key":"osv@javad.com","avatar":null},"body":"\"J. Bruce Fields\" <bfields@fieldses.org> writes:\n\n> On Tue, Nov 13, 2007 at 09:19:39PM +0300, Sergei Organov wrote:\n>> \n>> Signed-off-by: Sergei Organov <osv@javad.com>\n>> ---\n>>  Documentation/user-manual.txt |    8 ++++----\n>>  1 files changed, 4 insertions(+), 4 deletions(-)\n>> \n>> diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\n>> index d99adc6..a169ef0 100644\n>> --- a/Documentation/user-manual.txt\n>> +++ b/Documentation/user-manual.txt\n>> @@ -475,7 +475,7 @@ Bisecting: 3537 revisions left to test after this\n>>  If you run \"git branch\" at this point, you'll see that git has\n>>  temporarily moved you to a new branch named \"bisect\".  This branch\n>>  points to a commit (with commit id 65934...) that is reachable from\n>> -v2.6.19 but not from v2.6.18.  Compile and test it, and see whether\n>> +\"master\" but not from v2.6.18.  Compile and test it, and see whether\n>>  it crashes.  Assume it does crash.  Then:\n>>  \n>>  -------------------------------------------------\n>> @@ -1367,7 +1367,7 @@ If you make a commit that you later wish you hadn't, there are two\n>>  fundamentally different ways to fix the problem:\n>>  \n>>  \t1. You can create a new commit that undoes whatever was done\n>> -\tby the previous commit.  This is the correct thing if your\n>> +\tby the old commit.  This is the correct thing if your\n>>  \tmistake has already been made public.\n>>  \n>>  \t2. You can go back and modify the old commit.  You should\n>> @@ -1567,8 +1567,8 @@ old history using, for example,\n>>  $ git log master@{1}\n>>  -------------------------------------------------\n>>  \n>> -This lists the commits reachable from the previous version of the head.\n>> -This syntax can be used to with any git command that accepts a commit,\n>\n> I actually prefer \"head\" here.  On something like:\n>\n> \t\t A--B--C\n> \t\t/\n> \to--o--o\n> \t\t\\\n> \t\t o--o--o\n>\n>\n> The term \"branch\" could be used to refer to the whole line of\n> development consisting of A, B, and C.  The term \"head\", on the other\n> hand, refers to either C or a ref that points to it.  We also use the\n> terms \"branch head\" or just \"branch\" for that case, but I think \"head\"\n> is more precise.\n\nThen I'd suggest to be precise here, e.g.:\n\n\"This lists the commits reachable from the previous version of the\n\"master\" branch head.\"\n\nThe real reason for me to replacing \"head\" with \"branch\" in the first\nplace was that a few lines below there is example for HEAD, and I wanted\nto make it more obvious that those is entirely different.\n\n-- \nSergei.\n"},{"id":"60049","messageId":"20071116035416.GF18909@fieldses.org","threadId":"10848","inReplyTo":"87lk8z3idj.fsf@osv.gnss.ru","subject":"Re: [PATCH] user-manual.txt: fix a few mistakes","fromName":"J. Bruce Fields","fromEmail":"bfields@fieldses.org","sentAt":"2007-11-16T03:54:16Z","receivedAt":"2007-11-16T03:54:16Z","isPatch":true,"sender":{"key":"bfields@citi.umich.edu","avatar":null},"body":"On Thu, Nov 15, 2007 at 01:36:40PM +0300, Sergei Organov wrote:\n> \"J. Bruce Fields\" <bfields@fieldses.org> writes:\n> \n> > On Tue, Nov 13, 2007 at 09:19:39PM +0300, Sergei Organov wrote:\n> >> \n> >> Signed-off-by: Sergei Organov <osv@javad.com>\n> >> ---\n> >>  Documentation/user-manual.txt |    8 ++++----\n> >>  1 files changed, 4 insertions(+), 4 deletions(-)\n> >> \n> >> diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt\n> >> index d99adc6..a169ef0 100644\n> >> --- a/Documentation/user-manual.txt\n> >> +++ b/Documentation/user-manual.txt\n> >> @@ -475,7 +475,7 @@ Bisecting: 3537 revisions left to test after this\n> >>  If you run \"git branch\" at this point, you'll see that git has\n> >>  temporarily moved you to a new branch named \"bisect\".  This branch\n> >>  points to a commit (with commit id 65934...) that is reachable from\n> >> -v2.6.19 but not from v2.6.18.  Compile and test it, and see whether\n> >> +\"master\" but not from v2.6.18.  Compile and test it, and see whether\n> >>  it crashes.  Assume it does crash.  Then:\n> >>  \n> >>  -------------------------------------------------\n> >> @@ -1367,7 +1367,7 @@ If you make a commit that you later wish you hadn't, there are two\n> >>  fundamentally different ways to fix the problem:\n> >>  \n> >>  \t1. You can create a new commit that undoes whatever was done\n> >> -\tby the previous commit.  This is the correct thing if your\n> >> +\tby the old commit.  This is the correct thing if your\n> >>  \tmistake has already been made public.\n> >>  \n> >>  \t2. You can go back and modify the old commit.  You should\n> >> @@ -1567,8 +1567,8 @@ old history using, for example,\n> >>  $ git log master@{1}\n> >>  -------------------------------------------------\n> >>  \n> >> -This lists the commits reachable from the previous version of the head.\n> >> -This syntax can be used to with any git command that accepts a commit,\n> >\n> > I actually prefer \"head\" here.  On something like:\n> >\n> > \t\t A--B--C\n> > \t\t/\n> > \to--o--o\n> > \t\t\\\n> > \t\t o--o--o\n> >\n> >\n> > The term \"branch\" could be used to refer to the whole line of\n> > development consisting of A, B, and C.  The term \"head\", on the other\n> > hand, refers to either C or a ref that points to it.  We also use the\n> > terms \"branch head\" or just \"branch\" for that case, but I think \"head\"\n> > is more precise.\n> \n> Then I'd suggest to be precise here, e.g.:\n> \n> \"This lists the commits reachable from the previous version of the\n> \"master\" branch head.\"\n\nThat sounds sensible to me, sure.\n\n> \n> The real reason for me to replacing \"head\" with \"branch\" in the first\n> place was that a few lines below there is example for HEAD, and I wanted\n> to make it more obvious that those is entirely different.\n\nOK, sure.  Thanks for the thoughtful editing!\n\n--b.\n"},{"id":"60081","messageId":"87sl361l1d.fsf@osv.gnss.ru","threadId":"10848","inReplyTo":"20071116035416.GF18909@fieldses.org","subject":"Re: [PATCH] user-manual.txt: fix a few mistakes","fromName":"Sergei Organov","fromEmail":"osv@javad.com","sentAt":"2007-11-16T11:34:22Z","receivedAt":"2007-11-16T11:34:22Z","isPatch":true,"sender":{"key":"osv@javad.com","avatar":null},"body":"\"J. Bruce Fields\" <bfields@fieldses.org> writes:\n\n> On Thu, Nov 15, 2007 at 01:36:40PM +0300, Sergei Organov wrote:\n>> \"J. Bruce Fields\" <bfields@fieldses.org> writes:\n[...]\n>> >> @@ -1567,8 +1567,8 @@ old history using, for example,\n>> >>  $ git log master@{1}\n>> >>  -------------------------------------------------\n>> >>  \n>> >> -This lists the commits reachable from the previous version of the head.\n>> >> -This syntax can be used to with any git command that accepts a commit,\n>> >\n>> > I actually prefer \"head\" here.  On something like:\n>> >\n>> > \t\t A--B--C\n>> > \t\t/\n>> > \to--o--o\n>> > \t\t\\\n>> > \t\t o--o--o\n>> >\n>> >\n>> > The term \"branch\" could be used to refer to the whole line of\n>> > development consisting of A, B, and C.  The term \"head\", on the other\n>> > hand, refers to either C or a ref that points to it.  We also use the\n>> > terms \"branch head\" or just \"branch\" for that case, but I think \"head\"\n>> > is more precise.\n>> \n>> Then I'd suggest to be precise here, e.g.:\n>> \n>> \"This lists the commits reachable from the previous version of the\n>> \"master\" branch head.\"\n>\n> That sounds sensible to me, sure.\n\nOK, I've just submitted patch for that.\n\n-- \nSergei.\n"}]}