{"thread":{"id":"48298","subject":"man page for \"git remote set-url\" seems confusing/contradictory","startedAt":"2018-04-16T12:44:08Z","lastAt":"2018-04-19T17:32:38Z","messageCount":12,"participants":["Robert P. J. Day","Andreas Schwab","Jacob Keller","Junio C Hamano","Todd Zullinger","Martin Ågren"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"344787","messageId":"alpine.LFD.2.21.1804160538100.3564@localhost.localdomain","threadId":"48298","inReplyTo":null,"subject":"man page for \"git remote set-url\" seems confusing/contradictory","fromName":"Robert P. J. Day","fromEmail":"rpjday@crashcourse.ca","sentAt":"2018-04-16T12:43:59Z","receivedAt":"2018-04-16T12:44:08Z","isPatch":false,"sender":{"key":"rpjday@crashcourse.ca","avatar":"https://avatars.githubusercontent.com/u/226084077?v=4"},"body":"\n  never had cause to examine \"git remote set-url\" before so i'm a bit\npuzzled by this part of the man page:\n\n  set-url\n\n  Changes URLs for the remote. Sets first URL for remote\n  <name> that matches regex <oldurl> ...\n\n  With --push, push URLs are manipulated instead of fetch URLs.\n .. snip ...\n\n  Note that the push URL and the fetch URL, even though they can be\n  set differently, must still refer to the same place. What you pushed to\n  the push URL should be what you would see if you immediately fetched\n  from the fetch URL. If you are trying to fetch from one place (e.g.\n  your upstream) and push to another (e.g. your publishing\n  repository), use two separate remotes.\n\ni don't understand how you can clearly set the fetch and push URLs of\na remote independently, while the man page nonetheless insists that\n\"even though they can be set differently, must still refer to the same\nplace\". how can they be set differently yet still must refer to the\nsame place?\n\n  i suspect i'll have a couple more questions related to this shortly\nafter i do a bit more reading.\n\nrday\n"},{"id":"344801","messageId":"87y3hn5drx.fsf@linux-m68k.org","threadId":"48298","inReplyTo":"alpine.LFD.2.21.1804160538100.3564@localhost.localdomain","subject":"Re: man page for \"git remote set-url\" seems confusing/contradictory","fromName":"Andreas Schwab","fromEmail":"schwab@linux-m68k.org","sentAt":"2018-04-16T16:14:58Z","receivedAt":"2018-04-16T16:15:09Z","isPatch":false,"sender":{"key":"schwab@linux-m68k.org","avatar":"https://avatars.githubusercontent.com/u/2175493?v=4"},"body":"On Apr 16 2018, \"Robert P. J. Day\" <rpjday@crashcourse.ca> wrote:\n\n> i don't understand how you can clearly set the fetch and push URLs of\n> a remote independently, while the man page nonetheless insists that\n> \"even though they can be set differently, must still refer to the same\n> place\". how can they be set differently yet still must refer to the\n> same place?\n\nThey could be using different transport methods.  For example, for\nfetching the unauthenticated git: method could be used, but for pushing\nan authenticated method like ssh: is usually needed.\n\nAndreas.\n\n-- \nAndreas Schwab, schwab@linux-m68k.org\nGPG Key fingerprint = 7578 EB47 D4E5 4D69 2510  2552 DF73 E780 A9DA AEC1\n\"And now for something completely different.\"\n"},{"id":"344803","messageId":"alpine.LFD.2.21.1804160918120.6924@localhost.localdomain","threadId":"48298","inReplyTo":"87y3hn5drx.fsf@linux-m68k.org","subject":"Re: man page for \"git remote set-url\" seems confusing/contradictory","fromName":"Robert P. J. Day","fromEmail":"rpjday@crashcourse.ca","sentAt":"2018-04-16T16:19:50Z","receivedAt":"2018-04-16T16:20:04Z","isPatch":false,"sender":{"key":"rpjday@crashcourse.ca","avatar":"https://avatars.githubusercontent.com/u/226084077?v=4"},"body":"On Mon, 16 Apr 2018, Andreas Schwab wrote:\n\n> On Apr 16 2018, \"Robert P. J. Day\" <rpjday@crashcourse.ca> wrote:\n>\n> > i don't understand how you can clearly set the fetch and push URLs\n> > of a remote independently, while the man page nonetheless insists\n> > that \"even though they can be set differently, must still refer to\n> > the same place\". how can they be set differently yet still must\n> > refer to the same place?\n>\n> They could be using different transport methods.  For example, for\n> fetching the unauthenticated git: method could be used, but for\n> pushing an authenticated method like ssh: is usually needed.\n\n  ok, point taken, but does that mean the two must actually refer to\nthe same \"place\"? it seems that i'm perfectly free to use this command\nto set the push and fetch URLs to totally different locations.\n\nrday\n"},{"id":"344811","messageId":"CA+P7+xrDsPXA6Bq77gYwWtc16Dz4drg+CHA80=vBNB9-NhxHVg@mail.gmail.com","threadId":"48298","inReplyTo":"alpine.LFD.2.21.1804160918120.6924@localhost.localdomain","subject":"Re: man page for \"git remote set-url\" seems confusing/contradictory","fromName":"Jacob Keller","fromEmail":"jacob.keller@gmail.com","sentAt":"2018-04-16T18:20:03Z","receivedAt":"2018-04-16T18:20:31Z","isPatch":false,"sender":{"key":"jacob.keller@gmail.com","avatar":"https://avatars.githubusercontent.com/u/874719?v=4"},"body":"On Mon, Apr 16, 2018 at 9:19 AM, Robert P. J. Day <rpjday@crashcourse.ca> wrote:\n> On Mon, 16 Apr 2018, Andreas Schwab wrote:\n>\n>> On Apr 16 2018, \"Robert P. J. Day\" <rpjday@crashcourse.ca> wrote:\n>>\n>> > i don't understand how you can clearly set the fetch and push URLs\n>> > of a remote independently, while the man page nonetheless insists\n>> > that \"even though they can be set differently, must still refer to\n>> > the same place\". how can they be set differently yet still must\n>> > refer to the same place?\n>>\n>> They could be using different transport methods.  For example, for\n>> fetching the unauthenticated git: method could be used, but for\n>> pushing an authenticated method like ssh: is usually needed.\n>\n>   ok, point taken, but does that mean the two must actually refer to\n> the same \"place\"? it seems that i'm perfectly free to use this command\n> to set the push and fetch URLs to totally different locations.\n>\n> rday\n\nThings won't work so well if you set the push url and fetch url to\ndifferent repositories. Git assumes that refs updated by \"push\" will\nalso be reflected via \"fetch\".\n\nI don't know offhand what will break, but likely something will. For\none, when you fetch again it will rewind your remotes after the push.\n\nThe URLs could be different for lots of reasons, but they need to\nultimately link to the same remote repository. As Andreas said, the\nmost likely reason is differing transport protocols.\n\nThanks,\nJake\n"},{"id":"344848","messageId":"xmqqefjewxr4.fsf@gitster-ct.c.googlers.com","threadId":"48298","inReplyTo":"CA+P7+xrDsPXA6Bq77gYwWtc16Dz4drg+CHA80=vBNB9-NhxHVg@mail.gmail.com","subject":"Re: man page for \"git remote set-url\" seems confusing/contradictory","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2018-04-16T23:13:35Z","receivedAt":"2018-04-16T23:13:42Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Jacob Keller <jacob.keller@gmail.com> writes:\n\n> Things won't work so well if you set the push url and fetch url to\n> different repositories. Git assumes that refs updated by \"push\" will\n> also be reflected via \"fetch\".\n>\n> I don't know offhand what will break, but likely something will. For\n> one, when you fetch again it will rewind your remotes after the push.\n\nExactly.  I still haven't fully embraced it myself, but for a long\ntime, \"git push\" pretends as if it fetched from that remote and\nupdates the corresponding remote tracking branches (if you have\nany), so you'll be inviting inconsistent behaviour if you set your\nfetch and push URLs pointing at two logically separate places.\n\nThis is a tangent, but there probably should be a boolean that\ndisables this feature in \"git push\" per destination repository,\ni.e. \"when pushing into this repository, pretend that we immediately\nfetched from the refs we just pushed to and update the remote\ntracking branches we have for them: yes/no\".  It is not entirely\nimplausible to envision an overly smart remote repository that turns\na non-fast-forward push into an automatic rebase when it is safe to\ndo so, instead of failing such a push, and you'd disable the \"assume\nwhat we pushed would appear there\" when talking to such a remote.\n\n"},{"id":"344853","messageId":"CA+P7+xrY83CM6WYoxio2nPGzeg1YNGbptM52Opu2UBgdk9Y-4A@mail.gmail.com","threadId":"48298","inReplyTo":"xmqqefjewxr4.fsf@gitster-ct.c.googlers.com","subject":"Re: man page for \"git remote set-url\" seems confusing/contradictory","fromName":"Jacob Keller","fromEmail":"jacob.keller@gmail.com","sentAt":"2018-04-17T01:01:33Z","receivedAt":"2018-04-17T01:01:59Z","isPatch":false,"sender":{"key":"jacob.keller@gmail.com","avatar":"https://avatars.githubusercontent.com/u/874719?v=4"},"body":"On Mon, Apr 16, 2018 at 4:13 PM, Junio C Hamano <gitster@pobox.com> wrote:\n> Jacob Keller <jacob.keller@gmail.com> writes:\n>\n>> Things won't work so well if you set the push url and fetch url to\n>> different repositories. Git assumes that refs updated by \"push\" will\n>> also be reflected via \"fetch\".\n>>\n>> I don't know offhand what will break, but likely something will. For\n>> one, when you fetch again it will rewind your remotes after the push.\n>\n> Exactly.  I still haven't fully embraced it myself, but for a long\n> time, \"git push\" pretends as if it fetched from that remote and\n> updates the corresponding remote tracking branches (if you have\n> any), so you'll be inviting inconsistent behaviour if you set your\n> fetch and push URLs pointing at two logically separate places.\n>\n> This is a tangent, but there probably should be a boolean that\n> disables this feature in \"git push\" per destination repository,\n> i.e. \"when pushing into this repository, pretend that we immediately\n> fetched from the refs we just pushed to and update the remote\n> tracking branches we have for them: yes/no\".  It is not entirely\n> implausible to envision an overly smart remote repository that turns\n> a non-fast-forward push into an automatic rebase when it is safe to\n> do so, instead of failing such a push, and you'd disable the \"assume\n> what we pushed would appear there\" when talking to such a remote.\n>\n\nNot to mention something like gerrit which uses magical references\n\"refs/publish/branchname\" which don't actually get generated on the\nserver.\n\nThanks,\nJake\n"},{"id":"344870","messageId":"alpine.LFD.2.21.1804170831190.6019@localhost.localdomain","threadId":"48298","inReplyTo":"xmqqefjewxr4.fsf@gitster-ct.c.googlers.com","subject":"Re: man page for \"git remote set-url\" seems confusing/contradictory","fromName":"Robert P. J. Day","fromEmail":"rpjday@crashcourse.ca","sentAt":"2018-04-17T15:34:20Z","receivedAt":"2018-04-17T15:34:44Z","isPatch":false,"sender":{"key":"rpjday@crashcourse.ca","avatar":"https://avatars.githubusercontent.com/u/226084077?v=4"},"body":"On Tue, 17 Apr 2018, Junio C Hamano wrote:\n\n> Jacob Keller <jacob.keller@gmail.com> writes:\n>\n> > Things won't work so well if you set the push url and fetch url to\n> > different repositories. Git assumes that refs updated by \"push\"\n> > will also be reflected via \"fetch\".\n> >\n> > I don't know offhand what will break, but likely something will.\n> > For one, when you fetch again it will rewind your remotes after\n> > the push.\n>\n> Exactly.  I still haven't fully embraced it myself, but for a long\n> time, \"git push\" pretends as if it fetched from that remote and\n> updates the corresponding remote tracking branches (if you have\n> any), so you'll be inviting inconsistent behaviour if you set your\n> fetch and push URLs pointing at two logically separate places.\n\n  ... snip ...\n\n  oh, i totally buy all that now, i'm just suggesting that the man\npage might be tweaked to make that more obvious. in \"man git-remote\",\nunder \"set-url\", remember that it reads:\n\n\"Note that the push URL and the fetch URL, even though they can be set\ndifferently, must still refer to the same place.\"\n\n  i think it would be useful to be more specific about what \"can be\nset differently\" means, since a lot of readers might not immediately\nappreciate that it means just, say, the transport protocols. it never\nhurts to add that little bit of detail.\n\nrday\n\n\n"},{"id":"344898","messageId":"CA+P7+xrebnWe_6P0uGu2yEmXZ0+qjpykjrv39Nhd2hUPzO_96g@mail.gmail.com","threadId":"48298","inReplyTo":"alpine.LFD.2.21.1804170831190.6019@localhost.localdomain","subject":"Re: man page for \"git remote set-url\" seems confusing/contradictory","fromName":"Jacob Keller","fromEmail":"jacob.keller@gmail.com","sentAt":"2018-04-17T17:41:05Z","receivedAt":"2018-04-17T17:41:32Z","isPatch":false,"sender":{"key":"jacob.keller@gmail.com","avatar":"https://avatars.githubusercontent.com/u/874719?v=4"},"body":"On Tue, Apr 17, 2018 at 8:34 AM, Robert P. J. Day <rpjday@crashcourse.ca> wrote:\n> On Tue, 17 Apr 2018, Junio C Hamano wrote:\n>\n>> Jacob Keller <jacob.keller@gmail.com> writes:\n>>\n>> > Things won't work so well if you set the push url and fetch url to\n>> > different repositories. Git assumes that refs updated by \"push\"\n>> > will also be reflected via \"fetch\".\n>> >\n>> > I don't know offhand what will break, but likely something will.\n>> > For one, when you fetch again it will rewind your remotes after\n>> > the push.\n>>\n>> Exactly.  I still haven't fully embraced it myself, but for a long\n>> time, \"git push\" pretends as if it fetched from that remote and\n>> updates the corresponding remote tracking branches (if you have\n>> any), so you'll be inviting inconsistent behaviour if you set your\n>> fetch and push URLs pointing at two logically separate places.\n>\n>   ... snip ...\n>\n>   oh, i totally buy all that now, i'm just suggesting that the man\n> page might be tweaked to make that more obvious. in \"man git-remote\",\n> under \"set-url\", remember that it reads:\n>\n> \"Note that the push URL and the fetch URL, even though they can be set\n> differently, must still refer to the same place.\"\n>\n>   i think it would be useful to be more specific about what \"can be\n> set differently\" means, since a lot of readers might not immediately\n> appreciate that it means just, say, the transport protocols. it never\n> hurts to add that little bit of detail.\n>\n> rday\n>\n>\n\nMaybe something like:\n\n\"Note that the push URL and the fetch URL, even though they can be set\ndifferently, are expected to refer to the same repository. For\nexample, the fetch URL might use an unauthenticated transport, while\nthe push URL generally requires authentication\" Then follow this bit\nwith the mention of multiple remotes.\n\n(I think \"repository\" conveys the meaning better than \"place\".\nTechnically, the URLs can be completely different as long as they end\nup contacting the same real server repository.)\n\nThanks,\nJake\n"},{"id":"344957","messageId":"xmqqd0yxl6n9.fsf@gitster-ct.c.googlers.com","threadId":"48298","inReplyTo":"CA+P7+xrebnWe_6P0uGu2yEmXZ0+qjpykjrv39Nhd2hUPzO_96g@mail.gmail.com","subject":"Re: man page for \"git remote set-url\" seems confusing/contradictory","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2018-04-18T00:06:50Z","receivedAt":"2018-04-18T00:06:58Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Jacob Keller <jacob.keller@gmail.com> writes:\n\n> Maybe something like:\n>\n> \"Note that the push URL and the fetch URL, even though they can be set\n> differently, are expected to refer to the same repository. For\n> example, the fetch URL might use an unauthenticated transport, while\n> the push URL generally requires authentication\" Then follow this bit\n> with the mention of multiple remotes.\n>\n> (I think \"repository\" conveys the meaning better than \"place\".\n> Technically, the URLs can be completely different as long as they end\n> up contacting the same real server repository.)\n\nSounds sensible.  Let's see if there is any further input and then\nsomebody pleaes wrap this up in a final patch ;-)\n"},{"id":"345010","messageId":"20180418205635.GU29831@zaya.teonanacatl.net","threadId":"48298","inReplyTo":"xmqqd0yxl6n9.fsf@gitster-ct.c.googlers.com","subject":"Re: man page for \"git remote set-url\" seems confusing/contradictory","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2018-04-18T20:56:35Z","receivedAt":"2018-04-18T20:56:43Z","isPatch":false,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"Junio C Hamano wrote:\n> Jacob Keller <jacob.keller@gmail.com> writes:\n> \n>> Maybe something like:\n>>\n>> \"Note that the push URL and the fetch URL, even though they can be set\n>> differently, are expected to refer to the same repository. For\n>> example, the fetch URL might use an unauthenticated transport, while\n>> the push URL generally requires authentication\" Then follow this bit\n>> with the mention of multiple remotes.\n>>\n>> (I think \"repository\" conveys the meaning better than \"place\".\n>> Technically, the URLs can be completely different as long as they end\n>> up contacting the same real server repository.)\n> \n> Sounds sensible.  Let's see if there is any further input and then\n> somebody pleaes wrap this up in a final patch ;-)\n\nA pointer to the \"GIT URLS\" section in git-fetch(1) might\nalso be useful?  That section is provided via urls.txt and\nurls-remotes.txt and is included the git-clone, git-fetch,\ngit-pull, and git-push man pages.\n\nWe could also include urls-remotes.txt in git-remote, though\nthat seems like a lot of text to add to yet another man\npage.  Maybe a giturls.txt could be created and referenced\n(as a further enhancement if someone is inclined).\n\nTangentially (and I don't know if it's worth fixing), while\npoking around the documentation which includes urls.txt I\nnoticed that git-clone.txt refers readers to the \"URLS\nsection below\" when the name of the section is \"GIT URLS\".\n\nI doubt any readers would be confused, but it would be\nconsistent with the other files which include urls.txt to\nuse \"GIT URLS\" as the referenced section name.\n\n-- >& --\nSubject: [PATCH] doc/clone: update caption for GIT URLS cross-reference\n\nThe description of the <repository> argument directs readers to \"See the\nURLS section below\".  When generating HTML this becomes a link to the\n\"GIT URLS\" section.  When reading the man page in a terminal, the\ncaption is slightly misleading.  Use \"GIT URLS\" as the caption to avoid\nan confusion.\n\nThe man page produced by asciidoc doesn't include hyperlinks.  The\ndescription of the <repository> argument simply\n\nSigned-off-by: Todd Zullinger <tmz@pobox.com>\n---\n Documentation/git-clone.txt | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt\nindex 42ca7b5095..b844b9957c 100644\n--- a/Documentation/git-clone.txt\n+++ b/Documentation/git-clone.txt\n@@ -260,7 +260,7 @@ or `--mirror` is given)\n \n <repository>::\n \tThe (possibly remote) repository to clone from.  See the\n-\t<<URLS,URLS>> section below for more information on specifying\n+\t<<URLS,GIT URLS>> section below for more information on specifying\n \trepositories.\n \n <directory>::\n-- \n2.17.0\n\n-- \nTodd\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\nThe ultimate result of shielding men from the effects of folly is to\nfill the world with fools.\n    -- Herbert Spencer\n\n"},{"id":"345059","messageId":"CAN0heSrrpvRXGi1hzUuRqXcQCOJQcBcLWAWQKXrivx6tkxAsBw@mail.gmail.com","threadId":"48298","inReplyTo":"20180418205635.GU29831@zaya.teonanacatl.net","subject":"Re: man page for \"git remote set-url\" seems confusing/contradictory","fromName":"Martin Ågren","fromEmail":"martin.agren@gmail.com","sentAt":"2018-04-19T04:17:57Z","receivedAt":"2018-04-19T04:18:02Z","isPatch":false,"sender":{"key":"martin.agren@gmail.com","avatar":null},"body":"On 18 April 2018 at 22:56, Todd Zullinger <tmz@pobox.com> wrote:\n> Tangentially (and I don't know if it's worth fixing), while\n> poking around the documentation which includes urls.txt I\n> noticed that git-clone.txt refers readers to the \"URLS\n> section below\" when the name of the section is \"GIT URLS\".\n>\n> I doubt any readers would be confused, but it would be\n> consistent with the other files which include urls.txt to\n> use \"GIT URLS\" as the referenced section name.\n>\n> -- >& --\n> Subject: [PATCH] doc/clone: update caption for GIT URLS cross-reference\n>\n> The description of the <repository> argument directs readers to \"See the\n> URLS section below\".  When generating HTML this becomes a link to the\n> \"GIT URLS\" section.  When reading the man page in a terminal, the\n> caption is slightly misleading.  Use \"GIT URLS\" as the caption to avoid\n> an confusion.\n\ns/an/any/?\n\n>\n> The man page produced by asciidoc doesn't include hyperlinks.  The\n> description of the <repository> argument simply\n>\n\nAbandoned first attempt at log message? ;-)\n\n> Signed-off-by: Todd Zullinger <tmz@pobox.com>\n> ---\n>  Documentation/git-clone.txt | 2 +-\n>  1 file changed, 1 insertion(+), 1 deletion(-)\n>\n> diff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt\n> index 42ca7b5095..b844b9957c 100644\n> --- a/Documentation/git-clone.txt\n> +++ b/Documentation/git-clone.txt\n> @@ -260,7 +260,7 @@ or `--mirror` is given)\n>\n>  <repository>::\n>         The (possibly remote) repository to clone from.  See the\n> -       <<URLS,URLS>> section below for more information on specifying\n> +       <<URLS,GIT URLS>> section below for more information on specifying\n>         repositories.\n\nIndeed. Matches urls.txt and the others who refer there.\n\nMartin\n"},{"id":"345115","messageId":"20180419173230.GZ29831@zaya.teonanacatl.net","threadId":"48298","inReplyTo":"CAN0heSrrpvRXGi1hzUuRqXcQCOJQcBcLWAWQKXrivx6tkxAsBw@mail.gmail.com","subject":"[PATCH] doc/clone: update caption for GIT URLS cross-reference","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2018-04-19T17:32:30Z","receivedAt":"2018-04-19T17:32:38Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"The description of the <repository> argument directs readers to \"See the\nURLS section below\".  When generating HTML this becomes a link to the\n\"GIT URLS\" section.  When reading the man page in a terminal, the\ncaption is slightly misleading.  Use \"GIT URLS\" as the caption to avoid\nany confusion.\n\nSigned-off-by: Todd Zullinger <tmz@pobox.com>\n---\nMartin Ågren wrote:\n> On 18 April 2018 at 22:56, Todd Zullinger <tmz@pobox.com> wrote:\n>> Subject: [PATCH] doc/clone: update caption for GIT URLS cross-reference\n>>\n>> The description of the <repository> argument directs readers to \"See the\n>> URLS section below\".  When generating HTML this becomes a link to the\n>> \"GIT URLS\" section.  When reading the man page in a terminal, the\n>> caption is slightly misleading.  Use \"GIT URLS\" as the caption to avoid\n>> an confusion.\n> \n> s/an/any/?\n\nIndeed, thanks.\n\n>> The man page produced by asciidoc doesn't include hyperlinks.  The\n>> description of the <repository> argument simply\n> \n> Abandoned first attempt at log message? ;-)\n\nThat or it was when a squirrel ran by my window. ;)\n\nThanks for catching both of these mistakes.\n\n Documentation/git-clone.txt | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt\nindex 42ca7b5095..b844b9957c 100644\n--- a/Documentation/git-clone.txt\n+++ b/Documentation/git-clone.txt\n@@ -260,7 +260,7 @@ or `--mirror` is given)\n \n <repository>::\n \tThe (possibly remote) repository to clone from.  See the\n-\t<<URLS,URLS>> section below for more information on specifying\n+\t<<URLS,GIT URLS>> section below for more information on specifying\n \trepositories.\n \n <directory>::\n-- \n2.17.0\n\n-- \nTodd\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\nWhenever you find yourself on the side of the majority, it is time to\npause and reflect.\n    -- Mark Twain\n\n"}]}