\n\nOther files, e.g. git-add.html, are affected, too.\n\nAFAICS, this is caused by fe77b41, more precisely the change of the\nDocumentation/asciidoc.conf file. Indeed, reverting that commit on\nv1.7.11-rc3 results in git.html containing hyperlinks as expected.\n\nCan anyone confirm this? If so, is this intended behaviour? So far,\nI haven't found any clues in the release notes / mailing list / etc.\nAm I doing something wrong? Do I miss something? Thanks for any hint.\n\nRegards,\n\nMichael\n"},{"id":"194018","messageId":"20120621062410.GB19485@sigill.intra.peff.net","threadId":"30854","inReplyTo":"4FE235DC.9080202@online.de","subject":"Re: Missing hyperlinks in HTML docs","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2012-06-21T06:24:10Z","receivedAt":"2012-06-21T06:24:10Z","isPatch":false,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"On Wed, Jun 20, 2012 at 10:43:08PM +0200, Michael Hertling wrote:\n\n> shows that git.html does have the expected hyperlinks; e.g., diffing\n> git-1.7.11.rc{2,3}/Documentation/git.html reveals the following hunk:\n> \n> @@ -964,7 +964,6 @@\n>
\n> \n> Other files, e.g. git-add.html, are affected, too.\n> \n> AFAICS, this is caused by fe77b41, more precisely the change of the\n> Documentation/asciidoc.conf file. Indeed, reverting that commit on\n> v1.7.11-rc3 results in git.html containing hyperlinks as expected.\n> \n> Can anyone confirm this? If so, is this intended behaviour? So far,\n> I haven't found any clues in the release notes / mailing list / etc.\n> Am I doing something wrong? Do I miss something? Thanks for any hint.\n\nEek. I can easily replicate it here. The problem is that the new\ngit-relative-html-prefix attribute is not defined by default (whereas we\nwant it defined but blank). Which puzzles me, as I thought I tested how\nfe77b41 impacted files outside of technical/. But obviously I screwed\nsomething up.\n\nThe patch below should solve it.\n\n-- >8 --\nSubject: docs: always define git-relative-html-prefix attribute\n\nCommit fe77b41 introduced a new attribute to let the linkgit macro\ncreate cross-directory HTML references from the technical/ and howto/\nsubdirectories back to the main documentation. We define that attribute\nto \"../\" on the command-line when building inside those subdirectories,\nand otherwise leave it unset under the assumption that it would default\nto being blank. Instead, asciidoc omits the link entirely, leading to\nbroken documentation. Fix this by defining git-relative-html-prefix to\nblank in asciidoc.conf (and an instance on the command-line, when\npresent, will override it).\n\nSigned-off-by: Jeff King