path: root/Documentation/technical
diff options
authorRoberto Tyley <>2014-02-18 21:42:22 (GMT)
committerJunio C Hamano <>2014-02-20 22:14:58 (GMT)
commit2df85669d16703714968572937ebb67a31241ca3 (patch)
tree31e0852db93b0bed9f679fdb657e1a17078aa0fd /Documentation/technical
parent5f95c9f850b19b368c43ae399cc831b17a26a5ac (diff)
Documentation: fix documentation AsciiDoc links for external urls
Turns out that putting 'link:' before the 'http' is actually superfluous in AsciiDoc, as there's already a predefined macro to handle it. "http, https, [etc] URLs are rendered using predefined inline macros." "Hypertext links to files on the local file system are specified using the link inline macro." Despite being superfluous, the reference implementation of AsciiDoc tolerates the extra 'link:' and silently removes it, giving a functioning link in the generated HTML. However, AsciiDoctor (the Ruby implementation of AsciiDoc used to render the site) does /not/ have this behaviour, and so generates broken links, as can be seen here: (links to cvs2git & parsecvs) (link to The BFG) It's worth noting that after this change, the html generated by 'make html' in the git project is identical, and all links still work. Signed-off-by: Roberto Tyley <> Signed-off-by: Junio C Hamano <>
Diffstat (limited to 'Documentation/technical')
1 files changed, 2 insertions, 2 deletions
diff --git a/Documentation/technical/http-protocol.txt b/Documentation/technical/http-protocol.txt
index 544373b..20525d9 100644
--- a/Documentation/technical/http-protocol.txt
+++ b/Documentation/technical/http-protocol.txt
@@ -500,7 +500,7 @@ TODO: Document this further.
-link:[RFC 1738: Uniform Resource Locators (URL)]
-link:[RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1]
+[RFC 1738: Uniform Resource Locators (URL)]
+[RFC 2616: Hypertext Transfer Protocol -- HTTP/1.1]