{"thread":{"id":"55248","subject":"git pull unclear manual","startedAt":"2021-03-04T00:23:31Z","lastAt":"2021-03-07T18:58:33Z","messageCount":5,"participants":["Sergey Organov","Junio C Hamano"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"418162","messageId":"874khsqq0o.fsf@osv.gnss.ru","threadId":"55248","inReplyTo":null,"subject":"git pull unclear manual","fromName":"Sergey Organov","fromEmail":"sorganov@gmail.com","sentAt":"2021-03-03T14:18:47Z","receivedAt":"2021-03-04T00:23:31Z","isPatch":false,"sender":{"key":"sorganov@gmail.com","avatar":"https://avatars.githubusercontent.com/u/8501568?v=4"},"body":"Hello,\n\nHere is how \"git help pull\" begins:\n\n\nNAME\n git-pull - Fetch from and integrate with another repository or a local\n branch\n\nSYNOPSIS\n git pull [] [ [...]]\n
\n\nFrom this, how do one figures how to \"integrate with ... local branch\"?\n\nIs \"git pull\" useful to integrate with a local branch at all?\n\nThanks,\n-- Sergey\n"},{"id":"418201","messageId":"xmqqv9a7emx6.fsf@gitster.c.googlers.com","threadId":"55248","inReplyTo":"874khsqq0o.fsf@osv.gnss.ru","subject":"Re: git pull unclear manual","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2021-03-04T01:18:45Z","receivedAt":"2021-03-04T01:20:13Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Sergey Organov writes:\n\n> Here is how \"git help pull\" begins:\n>\n> \n> NAME\n> git-pull - Fetch from and integrate with another repository or a local\n> branch\n>\n> SYNOPSIS\n> git pull [] [ [...]]\n>
\n>\n> From this, how do one figures how to \"integrate with ... local branch\"?\n>\n> Is \"git pull\" useful to integrate with a local branch at all?\n\nYes, you can refer to your local repository as \".\", so\n\n\tgit pull . another-branch\n\nwill integrate the history of your local \"another-branch\" into\nthe history of the branch you have currently checked out.\n\n\n"},{"id":"418227","messageId":"87blbzm901.fsf@osv.gnss.ru","threadId":"55248","inReplyTo":"xmqqv9a7emx6.fsf@gitster.c.googlers.com","subject":"Re: git pull unclear manual","fromName":"Sergey Organov","fromEmail":"sorganov@gmail.com","sentAt":"2021-03-04T11:52:14Z","receivedAt":"2021-03-04T11:54:08Z","isPatch":false,"sender":{"key":"sorganov@gmail.com","avatar":"https://avatars.githubusercontent.com/u/8501568?v=4"},"body":"Junio C Hamano writes:\n\n> Sergey Organov writes:\n>\n>> Here is how \"git help pull\" begins:\n>>\n>> \n>> NAME\n>> git-pull - Fetch from and integrate with another repository or a local\n>> branch\n>>\n>> SYNOPSIS\n>> git pull [] [ [...]]\n>>
\n>>\n>> From this, how do one figures how to \"integrate with ... local branch\"?\n>>\n>> Is \"git pull\" useful to integrate with a local branch at all?\n>\n> Yes, you can refer to your local repository as \".\", so\n>\n> \tgit pull . another-branch\n>\n> will integrate the history of your local \"another-branch\" into\n> the history of the branch you have currently checked out.\n\nNice, thanks!\n\nDo you think the manual needs some improvement still?\n\nI mean, I'd then expect something like this as the SYNOPSIS:\n\n\"git-pull - Fetch from and integrate with another or current repository\"\n\nwith further clarification in the DESCRIPTION of how integration with\ncurrent repository could be useful.\n\nThe present description, if we drop \"another repository\" for the sake of\nthe argument, reads:\n\n\"git-pull - Fetch from and integrate with a local branch\"\n\nthat sounds plain wrong to me.\n\nAlso, I got confused further as the manual consistently uses \"remote\nrepository\" to describe , and that doesn't easily maps to\n\"current repository\" in my mind.\n\nFurther, the manual says that is simply passed to the \"git\nfetch\", and \"git help fetch\" adds to the confusion, as it says:\n\n git-fetch - Download objects and refs from *another repository*\n \n Fetch branches and/or tags (collectively, \"refs\") from one or more\n *other repositories*, along with the objects necessary to complete\n their histories.\n\nthat doesn't suggest \"current repository\" in some form is allowed\neither.\n\nBTW, why are these \"other\", \"remote\", \"another\" attributes there in\nthe manual in the first place? Why don't just say:\n\n git-fetch - Download objects and refs from repositories\n \n Fetch branches and/or tags (collectively, \"refs\") from one or more\n repositories, along with the objects necessary to complete their\n histories, into the current repository.\n\nThanks,\n-- Sergey\n"},{"id":"418273","messageId":"xmqqy2f2biz5.fsf@gitster.c.googlers.com","threadId":"55248","inReplyTo":"87blbzm901.fsf@osv.gnss.ru","subject":"Re: git pull unclear manual","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2021-03-04T23:24:30Z","receivedAt":"2021-03-04T23:24:36Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Sergey Organov writes:\n\n> Do you think the manual needs some improvement still?\n\nMy reading is already tainted by using Git for a long time, so I\nwon't be the best person to judge what's missing in the manual.\n\n> I mean, I'd then expect something like this as the SYNOPSIS:\n>\n> \"git-pull - Fetch from and integrate with another or current repository\"\n> ...\n> git-fetch - Download objects and refs from *another repository*\n\nJust replacing \"another repository\" with \"a repository\", the latter\nof which includes the current one, would be sufficient, perhaps?\n\n"},{"id":"418419","messageId":"87y2eyg5b6.fsf@osv.gnss.ru","threadId":"55248","inReplyTo":"xmqqy2f2biz5.fsf@gitster.c.googlers.com","subject":"Re: git pull unclear manual","fromName":"Sergey Organov","fromEmail":"sorganov@gmail.com","sentAt":"2021-03-07T18:57:33Z","receivedAt":"2021-03-07T18:58:33Z","isPatch":false,"sender":{"key":"sorganov@gmail.com","avatar":"https://avatars.githubusercontent.com/u/8501568?v=4"},"body":"Junio C Hamano writes:\n\n> Sergey Organov writes:\n>\n>> Do you think the manual needs some improvement still?\n>\n> My reading is already tainted by using Git for a long time, so I\n> won't be the best person to judge what's missing in the manual.\n>\n>> I mean, I'd then expect something like this as the SYNOPSIS:\n>>\n>> \"git-pull - Fetch from and integrate with another or current repository\"\n>> ...\n>> git-fetch - Download objects and refs from *another repository*\n>\n> Just replacing \"another repository\" with \"a repository\", the latter\n> of which includes the current one, would be sufficient, perhaps?\n\nYeah, just \"a repository\" is fine with me, perhaps followed by a note in\nthe DESCRIPTION that the current one is indeed included.\n\n-- Sergey\n"}]}