{"thread":{"id":"51082","subject":"git --help not actually showing the git(1) help page..","startedAt":"2019-05-13T20:47:30Z","lastAt":"2019-05-16T23:09:46Z","messageCount":19,"participants":["Philip Oakley","Jeff King","Junio C Hamano","Emily Shaffer","Eric Sunshine"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"375416","messageId":"0d37203a-e738-bad3-41e1-05204abc138b@iee.org","threadId":"51082","inReplyTo":null,"subject":"git --help not actually showing the git(1) help page..","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2019-05-13T20:47:27Z","receivedAt":"2019-05-13T20:47:30Z","isPatch":false,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"Is there a cli way, especially on Git for Windows bash, to get the html \nman page of git(1)? I have it on my system, so can go via another page but..\n\nAll the `git --help` appear to work, but I can't determine the \ncorrect invocation for bringing up the stupid content tracker's page in \nthe browser. Previously I'd have expected either `git --help` or `git \ngit --help` to work (can't remember which). The former only produces the \nshort form -h help in the bash window, the latter says 'git' isn't a \ncommand.\n\ncc'ing Dscho and Duy who have had recent contact with that area who may \nknow.\n-- \nPhilip\n\n"},{"id":"375417","messageId":"20190513205301.GA22745@sigill.intra.peff.net","threadId":"51082","inReplyTo":"0d37203a-e738-bad3-41e1-05204abc138b@iee.org","subject":"Re: git --help not actually showing the git(1) help page..","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2019-05-13T20:53:01Z","receivedAt":"2019-05-13T20:53:05Z","isPatch":false,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Mon, May 13, 2019 at 09:47:27PM +0100, Philip Oakley wrote:\n\n> Is there a cli way, especially on Git for Windows bash, to get the html man\n> page of git(1)? I have it on my system, so can go via another page but..\n> \n> All the `git --help` appear to work, but I can't determine the correct\n> invocation for bringing up the stupid content tracker's page in the browser.\n> Previously I'd have expected either `git --help` or `git git --help` to work\n> (can't remember which). The former only produces the short form -h help in\n> the bash window, the latter says 'git' isn't a command.\n\nTry \"git help git\".\n\nIt might be worth mentioning it in the paragraph at the end of \"git\nhelp\".\n\n-Peff\n"},{"id":"375420","messageId":"a0afd3c4-93ff-31e6-a622-5751c6b5a549@iee.org","threadId":"51082","inReplyTo":"20190513205301.GA22745@sigill.intra.peff.net","subject":"Re: git --help not actually showing the git(1) help page..","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2019-05-13T21:55:47Z","receivedAt":"2019-05-13T21:55:50Z","isPatch":false,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"Hi Peff\nOn 13/05/2019 21:53, Jeff King wrote:\n> On Mon, May 13, 2019 at 09:47:27PM +0100, Philip Oakley wrote:\n>\n>> Is there a cli way, especially on Git for Windows bash, to get the html man\n>> page of git(1)? I have it on my system, so can go via another page but..\n>>\n>> All the `git --help` appear to work, but I can't determine the correct\n>> invocation for bringing up the stupid content tracker's page in the browser.\n>> Previously I'd have expected either `git --help` or `git git --help` to work\n>> (can't remember which). The former only produces the short form -h help in\n>> the bash window, the latter says 'git' isn't a command.\n> Try \"git help git\".\nAhh, that's the one. I'd totally forgot about that method.\n>\n> It might be worth mentioning it in the paragraph at the end of \"git\n> help\".\nTrue. I'll stick on my todo list, along with adding to the general usage \nmessage. Possibly \"Or `git help git`.\"\n\nOn GfW I commonly use the `git --help` when things go wrong, so \nmaking the response to that give the right advice would be good. (It's \nalmost the same isue as `git --version`).\n\n> --\nPhilip\n"},{"id":"375430","messageId":"xmqqwoiu9dpb.fsf@gitster-ct.c.googlers.com","threadId":"51082","inReplyTo":"a0afd3c4-93ff-31e6-a622-5751c6b5a549@iee.org","subject":"Re: git --help not actually showing the git(1) help page..","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2019-05-13T22:44:48Z","receivedAt":"2019-05-13T22:44:53Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Philip Oakley writes:\n\n> On GfW I commonly use the `git --help` when things go wrong, so\n> making the response to that give the right advice would be good.\n\nThere are three levels of details ;-) \"git --help\" is meant as a\nshorter and sweeter version of \"git help git\" that is more detailed\nthan \"git -h\".\n\nIt is conceivable for an enterprising developer to write a set of\ndocumentation with medium level details and make \"git add --help\"\ngive such a medium level doc, more detailed than \"git add -h\" but\nmore concice than \"git help add\". Those who did \"git --help\"\ndid not bother doing so.\n\n"},{"id":"375538","messageId":"3cd065d1-9db5-f2e6-ddff-aa539746d45e@iee.org","threadId":"51082","inReplyTo":"xmqqwoiu9dpb.fsf@gitster-ct.c.googlers.com","subject":"Re: git --help not actually showing the git(1) help page..","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2019-05-14T14:05:16Z","receivedAt":"2019-05-14T14:05:19Z","isPatch":false,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"Hi Junio,\nOn 13/05/2019 23:44, Junio C Hamano wrote:\n> Philip Oakley writes:\n>\n>> On GfW I commonly use the `git --help` when things go wrong, so\n>> making the response to that give the right advice would be good.\n> There are three levels of details ;-) \"git --help\" is meant as a\n> shorter and sweeter version of \"git help git\" that is more detailed\n> than \"git -h\".\nThough that's not what happens at the moment. For the plain `git --help` \ncase it simply defaults to the `-h` case, while for any other `git cmd \n--help` it does pop up the git-for-windows configured web browser manual \npage.\n> It is conceivable for an enterprising developer to write a set of\n> documentation with medium level details and make \"git add --help\"\n> give such a medium level doc, more detailed than \"git add -h\" but\n> more concice than \"git help add\".\nI'd agree that there's a need for some typical usage/teaching level \ndocumentation to _complement_ the reference manual nature of the man \npages. It's a chicken - egg situation for some users we/they need the \nbit of education before they can know they need to refer to, and \nunderstand, the respective man pages.\n\n> Those who did \"git --help\"\n> did not bother doing so.\n>\nI tend to go with including the complementary usage/teaching aspects in \na distinct section of the man pages, though some of this is based on \nexamples from other software, e.g. Matlab for design/systems engineers.\n\nA simplistic patch for just the 'usage' message to follow.\n\nPhilip\n"},{"id":"375544","messageId":"20190514152450.15220-1-philipoakley@iee.org","threadId":"51082","inReplyTo":"3cd065d1-9db5-f2e6-ddff-aa539746d45e@iee.org","subject":"[PATCH] git.c: show usage for accessing the git(1) help page","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2019-05-14T15:24:50Z","receivedAt":"2019-05-14T15:24:59Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"It is not immediately obvious how to use the `git help` system\nto show the git(1) page, with all its background and ccordinating\nmaterial, such as environment variables.\n\nLet's simply list it as the last few words of the last usage line.\n\nSigned-off-by: Philip Oakley \n---\nThis follows from the discussion <3cd065d1-9db5-f2e6-ddff-aa539746d45e@iee.org>\n---\n git.c | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/git.c b/git.c\nindex 2324ac0b7e..9a852b09c1 100644\n--- a/git.c\n+++ b/git.c\n@@ -33,7 +33,7 @@ const char git_usage_string[] =\n const char git_more_info_string[] =\n \tN_(\"'git help -a' and 'git help -g' list available subcommands and some\\n\"\n \t \"concept guides. See 'git help ' or 'git help '\\n\"\n-\t \"to read about a specific subcommand or concept.\");\n+\t \"to read about a specific subcommand or concept. Or use 'git help git'.\");\n \n static int use_pager = -1;\n \n-- \n2.21.0.windows.1.1517.gbad5f960a3.dirty\n\n"},{"id":"375572","messageId":"20190515001717.GA138048@google.com","threadId":"51082","inReplyTo":"20190514152450.15220-1-philipoakley@iee.org","subject":"Re: [PATCH] git.c: show usage for accessing the git(1) help page","fromName":"Emily Shaffer","fromEmail":"emilyshaffer@google.com","sentAt":"2019-05-15T00:17:17Z","receivedAt":"2019-05-15T00:17:25Z","isPatch":true,"sender":{"key":"nasamuffin@google.com","avatar":"https://avatars.githubusercontent.com/u/1606826?v=4"},"body":"On Tue, May 14, 2019 at 04:24:50PM +0100, Philip Oakley wrote:\n> It is not immediately obvious how to use the `git help` system\n> to show the git(1) page, with all its background and ccordinating\n> material, such as environment variables.\n> \n> Let's simply list it as the last few words of the last usage line.\n> \n> Signed-off-by: Philip Oakley \n> ---\n> This follows from the discussion <3cd065d1-9db5-f2e6-ddff-aa539746d45e@iee.org>\n> ---\n> git.c | 2 +-\n> 1 file changed, 1 insertion(+), 1 deletion(-)\n> \n> diff --git a/git.c b/git.c\n> index 2324ac0b7e..9a852b09c1 100644\n> --- a/git.c\n> +++ b/git.c\n> @@ -33,7 +33,7 @@ const char git_usage_string[] =\n> const char git_more_info_string[] =\n> \tN_(\"'git help -a' and 'git help -g' list available subcommands and some\\n\"\n> \t \"concept guides. See 'git help ' or 'git help '\\n\"\n> -\t \"to read about a specific subcommand or concept.\");\n> +\t \"to read about a specific subcommand or concept. Or use 'git help git'.\");\n\nI'm not sure the wording makes sense here. It sounds like you're saying,\n\"Or use 'git help git' to read about specific subcommands or concepts.\"\nwhich isn't really what I think you're trying to say.\n\nWhat about, \"Or, use 'git help git' for a detailed guide of the Git\nsystem as a whole.\"\n\n(I'm still not sure that's quite it - since `git help git` mostly\ndetails the flags you can pass to git before invoking a subcommand. But\nI'm not sure that `git --help` is the place to say that...)\n\n> \n> static int use_pager = -1;\n> \n> -- \n> 2.21.0.windows.1.1517.gbad5f960a3.dirty\n> \n"},{"id":"375588","messageId":"20190515015331.GC13255@sigill.intra.peff.net","threadId":"51082","inReplyTo":"20190515001717.GA138048@google.com","subject":"Re: [PATCH] git.c: show usage for accessing the git(1) help page","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2019-05-15T01:53:31Z","receivedAt":"2019-05-15T01:53:34Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Tue, May 14, 2019 at 05:17:17PM -0700, Emily Shaffer wrote:\n\n> > const char git_more_info_string[] =\n> > \tN_(\"'git help -a' and 'git help -g' list available subcommands and some\\n\"\n> > \t \"concept guides. See 'git help ' or 'git help '\\n\"\n> > -\t \"to read about a specific subcommand or concept.\");\n> > +\t \"to read about a specific subcommand or concept. Or use 'git help git'.\");\n> \n> I'm not sure the wording makes sense here. It sounds like you're saying,\n> \"Or use 'git help git' to read about specific subcommands or concepts.\"\n> which isn't really what I think you're trying to say.\n> \n> What about, \"Or, use 'git help git' for a detailed guide of the Git\n> system as a whole.\"\n\nI had a similar reaction on reading Philip's patch. I think your\nsuggestion is better. We could even shorten it to just:\n\n Use 'git help git' for an overview of the system.\n\nLooking at \"git help git\" I actually think the DESCRIPTION section could\ndo a better job of being a first entry-point for new readers of the\ndocumentation. But I don't think that needs to be a blocker for what\nwe're discussing here.\n\n> (I'm still not sure that's quite it - since `git help git` mostly\n> details the flags you can pass to git before invoking a subcommand. But\n> I'm not sure that `git --help` is the place to say that...)\n\nYeah, I almost suggested something like:\n\n Use 'git help git' for options and environment variables that affect\n all subcommands.\n\nI'm not sure if that points people in a useful direction, or if it is\ngetting too much into the weeds (again, probably the description section\nof git(1) could talk about how to find which documentation where.\n\nI also think it should point to git-scm.com for the hyper-linked\ndocumentation, since it's less ugly than the stuff at git.github.io, but\nthat's really getting off-topic. :)\n\n-Peff\n"},{"id":"375601","messageId":"78710149-4e0c-01a1-ccbf-592adadbfd08@iee.org","threadId":"51082","inReplyTo":"20190515001717.GA138048@google.com","subject":"Re: [PATCH] git.c: show usage for accessing the git(1) help page","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2019-05-15T06:36:55Z","receivedAt":"2019-05-15T06:36:58Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"Hi Emily,\n\nOn 15/05/2019 01:17, Emily Shaffer wrote:\n> On Tue, May 14, 2019 at 04:24:50PM +0100, Philip Oakley wrote:\n>> It is not immediately obvious how to use the `git help` system\n>> to show the git(1) page, with all its background and ccordinating\n>> material, such as environment variables.\n>>\n>> Let's simply list it as the last few words of the last usage line.\n>>\n>> Signed-off-by: Philip Oakley \n>> ---\n>> This follows from the discussion <3cd065d1-9db5-f2e6-ddff-aa539746d45e@iee.org>\n>> ---\n>> git.c | 2 +-\n>> 1 file changed, 1 insertion(+), 1 deletion(-)\n>>\n>> diff --git a/git.c b/git.c\n>> index 2324ac0b7e..9a852b09c1 100644\n>> --- a/git.c\n>> +++ b/git.c\n>> @@ -33,7 +33,7 @@ const char git_usage_string[] =\n>> const char git_more_info_string[] =\n>> \tN_(\"'git help -a' and 'git help -g' list available subcommands and some\\n\"\n>> \t \"concept guides. See 'git help ' or 'git help '\\n\"\n>> -\t \"to read about a specific subcommand or concept.\");\n>> +\t \"to read about a specific subcommand or concept. Or use 'git help git'.\");\n> I'm not sure the wording makes sense here. It sounds like you're saying,\n> \"Or use 'git help git' to read about specific subcommands or concepts.\"\n> which isn't really what I think you're trying to say.\nTrue.\n>\n> What about, \"Or, use 'git help git' for a detailed guide of the Git\n> system as a whole.\"\nI had thought about a longer sentence, but was squeezing it in, given \nthat we (I) had to add in the other parts of that help footnote...\n>\n> (I'm still not sure that's quite it - since `git help git` mostly\n> details the flags you can pass to git before invoking a subcommand. But\n> I'm not sure that `git --help` is the place to say that...)\nIt's more that we are updating the system's response to a misunderstood \ncommand, hopefully with something that includes a link to our putative \ntop level man page. It's tricky to get to without already knowing it's \nthere.\n>\n>> \n>> static int use_pager = -1;\n>> \n>> -- \n>> 2.21.0.windows.1.1517.gbad5f960a3.dirty\n>>\nPhilip\n"},{"id":"375602","messageId":"7bd330d7-81f1-52b4-52d3-b74b128af83a@iee.org","threadId":"51082","inReplyTo":"20190515015331.GC13255@sigill.intra.peff.net","subject":"Re: [PATCH] git.c: show usage for accessing the git(1) help page","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2019-05-15T06:43:28Z","receivedAt":"2019-05-15T06:43:30Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"Hi Peff,\n\nOn 15/05/2019 02:53, Jeff King wrote:\n> On Tue, May 14, 2019 at 05:17:17PM -0700, Emily Shaffer wrote:\n>\n>>> const char git_more_info_string[] =\n>>> \tN_(\"'git help -a' and 'git help -g' list available subcommands and some\\n\"\n>>> \t \"concept guides. See 'git help ' or 'git help '\\n\"\n>>> -\t \"to read about a specific subcommand or concept.\");\n>>> +\t \"to read about a specific subcommand or concept. Or use 'git help git'.\");\n>> I'm not sure the wording makes sense here. It sounds like you're saying,\n>> \"Or use 'git help git' to read about specific subcommands or concepts.\"\n>> which isn't really what I think you're trying to say.\n>>\n>> What about, \"Or, use 'git help git' for a detailed guide of the Git\n>> system as a whole.\"\n> I had a similar reaction on reading Philip's patch. I think your\n> suggestion is better. We could even shorten it to just:\n>\n> Use 'git help git' for an overview of the system.\nThat is a lot better. I like it. Concise and effective. I'll create a v2.\n>\n> Looking at \"git help git\" I actually think the DESCRIPTION section could\n> do a better job of being a first entry-point for new readers of the\n> documentation. But I don't think that needs to be a blocker for what\n> we're discussing here.\nI'd agree for both points.\n>\n>> (I'm still not sure that's quite it - since `git help git` mostly\n>> details the flags you can pass to git before invoking a subcommand. But\n>> I'm not sure that `git --help` is the place to say that...)\n> Yeah, I almost suggested something like:\n>\n> Use 'git help git' for options and environment variables that affect\n> all subcommands.\n>\n> I'm not sure if that points people in a useful direction, or if it is\n> getting too much into the weeds (again, probably the description section\n> of git(1) could talk about how to find which documentation where.\n>\n> I also think it should point to git-scm.com for the hyper-linked\n> documentation, since it's less ugly than the stuff at git.github.io, but\n> that's really getting off-topic. :)\n>\n> -Peff\nInterestingly, try seeing if you can use tab completion to type in 'git \nhelp git'. It's nearly as hard to find as the user-manual, which isn't a \nman(1) page ;-)\n\nPhilip\n"},{"id":"375606","messageId":"20190515081112.12340-1-philipoakley@iee.org","threadId":"51082","inReplyTo":"7bd330d7-81f1-52b4-52d3-b74b128af83a@iee.org","subject":"[PATCH v2] git.c: show usage for accessing the git(1) help page","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2019-05-15T08:11:12Z","receivedAt":"2019-05-15T08:11:21Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"It is not immediately obvious how to use the `git help` system to show\nthe git(1) page, with its overview and its background and coordinating\nmaterial, such as environment variables.\n\nLet's simply list it as the last few words of the last usage line.\n\nSigned-off-by: Philip Oakley \n---\nThis follows from the discussion <3cd065d1-9db5-f2e6-ddff-aa539746d45e@iee.org>\n---\n git.c | 3 ++-\n 1 file changed, 2 insertions(+), 1 deletion(-)\n\ndiff --git a/git.c b/git.c\nindex 2324ac0b7e..4797941dfd 100644\n--- a/git.c\n+++ b/git.c\n@@ -33,7 +33,8 @@ const char git_usage_string[] =\n const char git_more_info_string[] =\n \tN_(\"'git help -a' and 'git help -g' list available subcommands and some\\n\"\n \t \"concept guides. See 'git help ' or 'git help '\\n\"\n-\t \"to read about a specific subcommand or concept.\");\n+\t \"to read about a specific subcommand or concept.\\n\"\n+\t \"Use 'git help git' for an overview of the system.\");\n \n static int use_pager = -1;\n \n-- \n2.21.0.windows.1.1517.gbad5f960a3.dirty\n\n"},{"id":"375607","messageId":"CAPig+cQ4FZeOxbVU-5qTrQm8Q-khwHuCwekAr-aGtbLKAVzY0Q@mail.gmail.com","threadId":"51082","inReplyTo":"20190515081112.12340-1-philipoakley@iee.org","subject":"Re: [PATCH v2] git.c: show usage for accessing the git(1) help page","fromName":"Eric Sunshine","fromEmail":"sunshine@sunshineco.com","sentAt":"2019-05-15T08:14:32Z","receivedAt":"2019-05-15T08:14:46Z","isPatch":true,"sender":{"key":"sunshine@sunshineco.com","avatar":"https://avatars.githubusercontent.com/u/163641?v=4"},"body":"On Wed, May 15, 2019 at 4:11 AM Philip Oakley wrote:\n> It is not immediately obvious how to use the `git help` system to show\n> the git(1) page, with its overview and its background and coordinating\n> material, such as environment variables.\n>\n> Let's simply list it as the last few words of the last usage line.\n>\n> Signed-off-by: Philip Oakley \n> ---\n> diff --git a/git.c b/git.c\n> @@ -33,7 +33,8 @@ const char git_usage_string[] =\n> const char git_more_info_string[] =\n> N_(\"'git help -a' and 'git help -g' list available subcommands and some\\n\"\n> \"concept guides. See 'git help ' or 'git help '\\n\"\n> - \"to read about a specific subcommand or concept.\");\n> + \"to read about a specific subcommand or concept.\\n\"\n> + \"Use 'git help git' for an overview of the system.\");\n\nIf you want to be consistent with the wording shown for \"git help\n<...>\", you might want s/Use/See/.\n"},{"id":"375661","messageId":"20190515224709.2936-2-philipoakley@iee.org","threadId":"51082","inReplyTo":"20190515224709.2936-1-philipoakley@iee.org","subject":"[PATCH v3 1/2] git.c: show usage for accessing the git(1) help page","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2019-05-15T22:47:08Z","receivedAt":"2019-05-15T22:47:19Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"It is not immediately obvious how to use the `git help` system to show\nthe git(1) page, with its overview and its background and coordinating\nmaterial, such as environment variables.\n\nLet's simply list it as the last few words of the last usage line.\n\nSigned-off-by: Philip Oakley \n---\nThis follows from the discussion <3cd065d1-9db5-f2e6-ddff-aa539746d45e@iee.org>\n---\n git.c | 3 ++-\n 1 file changed, 2 insertions(+), 1 deletion(-)\n\ndiff --git a/git.c b/git.c\nindex 2324ac0b7e..9e24de43d7 100644\n--- a/git.c\n+++ b/git.c\n@@ -33,7 +33,8 @@ const char git_usage_string[] =\n const char git_more_info_string[] =\n \tN_(\"'git help -a' and 'git help -g' list available subcommands and some\\n\"\n \t \"concept guides. See 'git help ' or 'git help '\\n\"\n-\t \"to read about a specific subcommand or concept.\");\n+\t \"to read about a specific subcommand or concept.\\n\"\n+\t \"See 'git help git' for an overview of the system.\");\n \n static int use_pager = -1;\n \n-- \n2.21.0.windows.1.1517.gbad5f960a3.dirty\n\n"},{"id":"375662","messageId":"20190515224709.2936-1-philipoakley@iee.org","threadId":"51082","inReplyTo":"CAPig+cQ4FZeOxbVU-5qTrQm8Q-khwHuCwekAr-aGtbLKAVzY0Q@mail.gmail.com","subject":"[PATCH v3 0/2] accessing the git(1) help page","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2019-05-15T22:47:07Z","receivedAt":"2019-05-15T22:47:21Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"This hopefully is a final version of the usage message to\nshow how to access the git(1) manual page.\n\nThe V3 change is Eric's suggestion to use 'See'.\n\nI have also taken the opportunity [Patch 2/2] to pick up peff's suggestion\nto include the git-scm doc link, and also correct the mis-quoting\nof a link to the html formatted github doc pages.\n\nPhilip Oakley (2):\n git.c: show usage for accessing the git(1) help page\n Doc: git.txt: remove backticks from link and add git-scm.com/docs\n\n Documentation/git.txt | 3 ++-\n git.c | 3 ++-\n 2 files changed, 4 insertions(+), 2 deletions(-)\n\n-- \n2.21.0.windows.1.1517.gbad5f960a3.dirty\n\n"},{"id":"375663","messageId":"20190515224709.2936-3-philipoakley@iee.org","threadId":"51082","inReplyTo":"20190515224709.2936-1-philipoakley@iee.org","subject":"[PATCH v3 2/2] Doc: git.txt: remove backticks from link and add git-scm.com/docs","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2019-05-15T22:47:09Z","receivedAt":"2019-05-15T22:47:21Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"While checking the html formatted git(1) manual page, it was noted\nthat the link to https://git.github.io/htmldocs/git.html was formatted\nas code. Remove the backticks.\n\nWhile at it, add the https://git-scm.com/docs link which one reviewer\nnoted had linkable section headings.\n\nHelped-by: Jeff King \nSigned-off-by: Philip Oakley \n---\n Documentation/git.txt | 3 ++-\n 1 file changed, 2 insertions(+), 1 deletion(-)\n\ndiff --git a/Documentation/git.txt b/Documentation/git.txt\nindex dbf92f6ac6..edcb9936b5 100644\n--- a/Documentation/git.txt\n+++ b/Documentation/git.txt\n@@ -33,7 +33,8 @@ individual Git commands with \"git help command\". linkgit:gitcli[7]\n manual page gives you an overview of the command-line command syntax.\n \n A formatted and hyperlinked copy of the latest Git documentation\n-can be viewed at `https://git.github.io/htmldocs/git.html`.\n+can be viewed at https://git.github.io/htmldocs/git.html\n+or https://git-scm.com/docs.\n \n \n OPTIONS\n-- \n2.21.0.windows.1.1517.gbad5f960a3.dirty\n\n"},{"id":"375684","messageId":"xmqqbm035fhx.fsf@gitster-ct.c.googlers.com","threadId":"51082","inReplyTo":"20190515224709.2936-3-philipoakley@iee.org","subject":"Re: [PATCH v3 2/2] Doc: git.txt: remove backticks from link and add git-scm.com/docs","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2019-05-16T01:56:26Z","receivedAt":"2019-05-16T01:56:32Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Philip Oakley writes:\n\n> While checking the html formatted git(1) manual page, it was noted\n> that the link to https://git.github.io/htmldocs/git.html was formatted\n> as code. Remove the backticks.\n\nGood. I just ran\n\n\t$ git grep '`https*://' Documentation/\n\nto see if any hits I see are for the real URL the user may want to\nclick on. There are some that are pointing at real sites, but I do\nnot think users would want to clickon many of them while reading the\ndocumentation.\n\nExcept perhaps for these to see what's there:\n\nDocumentation/git-archimport.txt:\tAttempt to auto-register archives at `http://mirrors.sourcecontrol.net`\nDocumentation/git-cvsimport.txt:* cvs2git (part of cvs2svn), `http://subversion.apache.org/`\n\n"},{"id":"375714","messageId":"d79d5e70-ec3a-c6ca-b23d-a44edf2579d2@iee.org","threadId":"51082","inReplyTo":"xmqqbm035fhx.fsf@gitster-ct.c.googlers.com","subject":"Re: [PATCH v3 2/2] Doc: git.txt: remove backticks from link and add git-scm.com/docs","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2019-05-16T11:25:47Z","receivedAt":"2019-05-16T11:25:50Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"On 16/05/2019 02:56, Junio C Hamano wrote:\n> Philip Oakley writes:\n>\n>> While checking the html formatted git(1) manual page, it was noted\n>> that the link to https://git.github.io/htmldocs/git.html was formatted\n>> as code. Remove the backticks.\n> Good. I just ran\n>\n> \t$ git grep '`https*://' Documentation/\n>\n> to see if any hits I see are for the real URL the user may want to\n> click on. There are some that are pointing at real sites, but I do\n> not think users would want to clickon many of them while reading the\n> documentation.\nI'd had a quick brows and mainly found example.com ;-) Any other excepts \nwere at the other end of the doc relative to git(1)...\n>\n> Except perhaps for these to see what's there:\n>\n> Documentation/git-archimport.txt:\tAttempt to auto-register archives at `http://mirrors.sourcecontrol.net`\nThat domain is gone. Whole line should probably be removed.\n\n> Documentation/git-cvsimport.txt:* cvs2git (part of cvs2svn), `http://subversion.apache.org/`\n>\nStill there. Still updated - last news 2019-04-24. Could remove backticks.\n\nPhilip\n"},{"id":"375752","messageId":"20190516222204.GB11784@sigill.intra.peff.net","threadId":"51082","inReplyTo":"d79d5e70-ec3a-c6ca-b23d-a44edf2579d2@iee.org","subject":"Re: [PATCH v3 2/2] Doc: git.txt: remove backticks from link and add git-scm.com/docs","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2019-05-16T22:22:05Z","receivedAt":"2019-05-16T22:23:35Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Thu, May 16, 2019 at 12:25:47PM +0100, Philip Oakley wrote:\n\n> > Except perhaps for these to see what's there:\n> > \n> > Documentation/git-archimport.txt:\tAttempt to auto-register archives at `http://mirrors.sourcecontrol.net`\n> That domain is gone. Whole line should probably be removed.\n\nHeh, see:\n\n https://public-inbox.org/git/20170420203441.mrlwbkqinub7m225@sigill.intra.peff.net/\n\nI left it to people who actually care about arch to clean up that line\nand figure out if there is some useful alternative.\n\n-Peff\n"},{"id":"375758","messageId":"d8f90604-a0de-a054-2af8-8aa33b07071c@iee.org","threadId":"51082","inReplyTo":"20190516222204.GB11784@sigill.intra.peff.net","subject":"Re: [PATCH v3 2/2] Doc: git.txt: remove backticks from link and add git-scm.com/docs","fromName":"Philip Oakley","fromEmail":"philipoakley@iee.org","sentAt":"2019-05-16T23:09:42Z","receivedAt":"2019-05-16T23:09:46Z","isPatch":true,"sender":{"key":"philipoakley@iee.email","avatar":"https://avatars.githubusercontent.com/u/914343?v=4"},"body":"On 16/05/2019 23:22, Jeff King wrote:\n> On Thu, May 16, 2019 at 12:25:47PM +0100, Philip Oakley wrote:\n>\n>>> Except perhaps for these to see what's there:\n>>>\n>>> Documentation/git-archimport.txt:\tAttempt to auto-register archives at `http://mirrors.sourcecontrol.net`\n>> That domain is gone. Whole line should probably be removed.\n> Heh, see:\n>\n> https://public-inbox.org/git/20170420203441.mrlwbkqinub7m225@sigill.intra.peff.net/\n>\n> I left it to people who actually care about arch to clean up that line\n> and figure out if there is some useful alternative.\n>\nThanks. I'll sit on my hands on that one then (i.e. do nothing).\n-- \nPhilip\n"}]}