{"thread":{"id":"40553","subject":"[BUG] Broken links in Git Documentation/user-manual.txt","startedAt":"2015-10-14T00:52:36Z","lastAt":"2015-10-14T14:29:01Z","messageCount":4,"participants":["Xue Fuqiao","Matthieu Moy","John Keeping"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"271630","messageId":"CAAF+z6F3Yej0ByAL1bGnG7qGRLz_HnpwVRqFVVHiMOebNRmSmA@mail.gmail.com","threadId":"40553","inReplyTo":null,"subject":"[BUG] Broken links in Git Documentation/user-manual.txt","fromName":"Xue Fuqiao","fromEmail":"xfq.free@gmail.com","sentAt":"2015-10-14T00:52:36Z","receivedAt":"2015-10-14T00:52:36Z","isPatch":false,"sender":{"key":"xfq.free@gmail.com","avatar":"https://avatars.githubusercontent.com/u/2863444?v=4"},"body":"Hi list,\n\nIn https://git-scm.com/docs/user-manual.html , all links to the\nglossary[1] are broken.\n\nI'm aware of a recent bug report about broken links ($gmane/279048/),\nbut that one seems unrelated to what I'm reporting.\n\n[1] For example: https://git-scm.com/docs/user-manual.html#def_head\n"},{"id":"271636","messageId":"vpqk2qp52am.fsf@grenoble-inp.fr","threadId":"40553","inReplyTo":"CAAF+z6F3Yej0ByAL1bGnG7qGRLz_HnpwVRqFVVHiMOebNRmSmA@mail.gmail.com","subject":"Re: [BUG] Broken links in Git Documentation/user-manual.txt","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@grenoble-inp.fr","sentAt":"2015-10-14T07:37:05Z","receivedAt":"2015-10-14T07:37:05Z","isPatch":false,"sender":{"key":"matthieu.moy@grenoble-inp.fr","avatar":"https://gravatar.com/avatar/72c8a2705971a25dfaff23cece15130d405685845d911aedd5667ace277f3fc5?d=mp&s=160"},"body":"Xue Fuqiao writes:\n\n> Hi list,\n>\n> In https://git-scm.com/docs/user-manual.html , all links to the\n> glossary[1] are broken.\n\nActually, the links themselves are fine, but the destimation is broken.\n\nThe doc is supposed to look like this :\n\n https://www.kernel.org/pub/software/scm/git/docs/user-manual.html#def_head\n\nwith the glossary at the end. On\nhttps://git-scm.com/docs/user-manual.html, the glossary is displayed as\nverbatim text.\n\nThis does not seem to be a bug in our user-manual.txt, but in the way\nit's processed by git-scm.com.\n\nI reported the issue there:\n\nhttps://github.com/git/git-scm.com/issues/605\n\n-- \nMatthieu Moy\nhttp://www-verimag.imag.fr/~moy/\n"},{"id":"271644","messageId":"20151014134042.GD19802@serenity.lan","threadId":"40553","inReplyTo":"vpqk2qp52am.fsf@grenoble-inp.fr","subject":"Re: [BUG] Broken links in Git Documentation/user-manual.txt","fromName":"John Keeping","fromEmail":"john@keeping.me.uk","sentAt":"2015-10-14T13:40:42Z","receivedAt":"2015-10-14T13:40:42Z","isPatch":false,"sender":{"key":"john@keeping.me.uk","avatar":"https://avatars.githubusercontent.com/u/1702081?v=4"},"body":"On Wed, Oct 14, 2015 at 09:37:05AM +0200, Matthieu Moy wrote:\n> Xue Fuqiao writes:\n> \n> > Hi list,\n> >\n> > In https://git-scm.com/docs/user-manual.html , all links to the\n> > glossary[1] are broken.\n> \n> Actually, the links themselves are fine, but the destimation is broken.\n> \n> The doc is supposed to look like this :\n> \n> https://www.kernel.org/pub/software/scm/git/docs/user-manual.html#def_head\n> \n> with the glossary at the end. On\n> https://git-scm.com/docs/user-manual.html, the glossary is displayed as\n> verbatim text.\n> \n> This does not seem to be a bug in our user-manual.txt, but in the way\n> it's processed by git-scm.com.\n\nI think it was an issue in the source, but was fixed by be510e0\n(Documentation: fix section header mark-up, 2015-09-25). I'm not sure\nwhen/how git-scm.com rebulds its documentation, but I'm pretty sure that\nfix hasn't made it into a release yet so I doubt the site has picked it\nup.\n\n> I reported the issue there:\n> \n> https://github.com/git/git-scm.com/issues/605\n"},{"id":"271646","messageId":"vpqbnc1bk2a.fsf@grenoble-inp.fr","threadId":"40553","inReplyTo":"20151014134042.GD19802@serenity.lan","subject":"Re: [BUG] Broken links in Git Documentation/user-manual.txt","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@grenoble-inp.fr","sentAt":"2015-10-14T14:29:01Z","receivedAt":"2015-10-14T14:29:01Z","isPatch":false,"sender":{"key":"matthieu.moy@grenoble-inp.fr","avatar":"https://gravatar.com/avatar/72c8a2705971a25dfaff23cece15130d405685845d911aedd5667ace277f3fc5?d=mp&s=160"},"body":"John Keeping writes:\n\n> On Wed, Oct 14, 2015 at 09:37:05AM +0200, Matthieu Moy wrote:\n>> Xue Fuqiao writes:\n>> \n>> > Hi list,\n>> >\n>> > In https://git-scm.com/docs/user-manual.html , all links to the\n>> > glossary[1] are broken.\n>> \n>> Actually, the links themselves are fine, but the destimation is broken.\n>> \n>> The doc is supposed to look like this :\n>> \n>> https://www.kernel.org/pub/software/scm/git/docs/user-manual.html#def_head\n>> \n>> with the glossary at the end. On\n>> https://git-scm.com/docs/user-manual.html, the glossary is displayed as\n>> verbatim text.\n>> \n>> This does not seem to be a bug in our user-manual.txt, but in the way\n>> it's processed by git-scm.com.\n>\n> I think it was an issue in the source, but was fixed by be510e0\n> (Documentation: fix section header mark-up, 2015-09-25). I'm not sure\n> when/how git-scm.com rebulds its documentation, but I'm pretty sure that\n> fix hasn't made it into a release yet so I doubt the site has picked it\n> up.\n\nAh, OK. I can't reproduce the issue even with versions earlier than\nbe510e0, but this is because my local build uses asciidoc, and the\ncommit message says \"Asciidoctor is stricter than AsciiDoc\", and\ngit-scm.com seems to use asciidoctor.\n\nThe fix isn't in any release (not even in master), so it can't be in\ngit-scm.com.\n\nThanks for the pointer, I'll update the GitHub bug.\n\n-- \nMatthieu Moy\nhttp://www-verimag.imag.fr/~moy/\n"}]}