{"thread":{"id":"45761","subject":"[PATCH 0/6] fix broken links in Documentation/","startedAt":"2017-04-20T20:32:12Z","lastAt":"2017-04-20T20:35:43Z","messageCount":7,"participants":["Jeff King"],"isPatch":true,"patchVersion":1,"patchTotal":6},"messages":[{"id":"317374","messageId":"20170420203203.xlbajdfzy7gp3hj3@sigill.intra.peff.net","threadId":"45761","inReplyTo":null,"subject":"[PATCH 0/6] fix broken links in Documentation/","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2017-04-20T20:32:04Z","receivedAt":"2017-04-20T20:32:12Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"I've been looking at running an automated link-checker on git-scm.com.\nBut as it hosts HTML rendered from our Documentation/ directory, it\ninherits any broken links that we have here. :)\n\nThis series fixes all the issues I could find.\n\n [1/6]: doc: use https links to avoid http redirect\n [2/6]: doc: replace or.cz gitwiki link with git.wiki.kernel.org\n [3/6]: gitcore-tutorial: update broken link\n [4/6]: docs/archimport: quote sourcecontrol.net reference\n [5/6]: docs/bisect-lk2009: update nist report link\n [6/6]: docs/bisect-lk2009: update java code conventions link\n\n Documentation/git-archimport.txt | 2 +-\n Documentation/git-bisect-lk2009.txt | 14 +++++++-------\n Documentation/git-tools.txt | 2 +-\n Documentation/gitcore-tutorial.txt | 2 +-\n Documentation/gitweb.conf.txt | 4 ++--\n Documentation/howto/rebuild-from-update-hook.txt | 4 ++--\n 6 files changed, 14 insertions(+), 14 deletions(-)\n\n-Peff\n"},{"id":"317375","messageId":"20170420203238.kqflctbulimw4npn@sigill.intra.peff.net","threadId":"45761","inReplyTo":"20170420203203.xlbajdfzy7gp3hj3@sigill.intra.peff.net","subject":"[PATCH 2/6] doc: replace or.cz gitwiki link with git.wiki.kernel.org","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2017-04-20T20:32:39Z","receivedAt":"2017-04-20T20:32:46Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"The or.cz version of the Git wiki went away long ago, and\nnow just redirects to kernel.org.\n\nSigned-off-by: Jeff King \n---\n Documentation/git-tools.txt | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/Documentation/git-tools.txt b/Documentation/git-tools.txt\nindex 2f4ff5015..d0fec4cdd 100644\n--- a/Documentation/git-tools.txt\n+++ b/Documentation/git-tools.txt\n@@ -7,4 +7,4 @@ maintained here. These days, however, search engines fill that role much\n more efficiently, so this manually-maintained list has been retired.\n \n See also the `contrib/` area, and the Git wiki:\n-http://git.or.cz/gitwiki/InterfacesFrontendsAndTools\n+https://git.wiki.kernel.org/index.php/InterfacesFrontendsAndTools\n-- \n2.13.0.rc0.363.g8726c260e\n\n"},{"id":"317376","messageId":"20170420203232.z3m5xeu3pgazkdkx@sigill.intra.peff.net","threadId":"45761","inReplyTo":"20170420203203.xlbajdfzy7gp3hj3@sigill.intra.peff.net","subject":"[PATCH 1/6] doc: use https links to avoid http redirect","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2017-04-20T20:32:33Z","receivedAt":"2017-04-20T20:33:38Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"Many sites these days unconditionally redirect http requests\nto their https equivalents. Let's make our links https in\nthe first place to save the client a redirect.\n\nSigned-off-by: Jeff King \n---\n Documentation/git-bisect-lk2009.txt | 10 +++++-----\n Documentation/gitweb.conf.txt | 4 ++--\n Documentation/howto/rebuild-from-update-hook.txt | 4 ++--\n 3 files changed, 9 insertions(+), 9 deletions(-)\n\ndiff --git a/Documentation/git-bisect-lk2009.txt b/Documentation/git-bisect-lk2009.txt\nindex e015f5b3c..716d66d43 100644\n--- a/Documentation/git-bisect-lk2009.txt\n+++ b/Documentation/git-bisect-lk2009.txt\n@@ -1349,10 +1349,10 @@ References\n \n - [[[1]]] http://www.nist.gov/public_affairs/releases/n02-10.htm['Software Errors Cost U.S. Economy $59.5 Billion Annually'. Nist News Release.]\n - [[[2]]] http://java.sun.com/docs/codeconv/html/CodeConventions.doc.html#16712['Code Conventions for the Java Programming Language'. Sun Microsystems.]\n-- [[[3]]] http://en.wikipedia.org/wiki/Software_maintenance['Software maintenance'. Wikipedia.]\n+- [[[3]]] https://en.wikipedia.org/wiki/Software_maintenance['Software maintenance'. Wikipedia.]\n - [[[4]]] http://article.gmane.org/gmane.comp.version-control.git/45195/[Junio C Hamano. 'Automated bisect success story'. Gmane.]\n-- [[[5]]] http://lwn.net/Articles/317154/[Christian Couder. 'Fully automated bisecting with \"git bisect run\"'. LWN.net.]\n-- [[[6]]] http://lwn.net/Articles/277872/[Jonathan Corbet. 'Bisection divides users and developers'. LWN.net.]\n+- [[[5]]] https://lwn.net/Articles/317154/[Christian Couder. 'Fully automated bisecting with \"git bisect run\"'. LWN.net.]\n+- [[[6]]] https://lwn.net/Articles/277872/[Jonathan Corbet. 'Bisection divides users and developers'. LWN.net.]\n - [[[7]]] http://article.gmane.org/gmane.linux.scsi/36652/[Ingo Molnar. 'Re: BUG 2.6.23-rc3 can't see sd partitions on Alpha'. Gmane.]\n-- [[[8]]] http://www.kernel.org/pub/software/scm/git/docs/git-bisect.html[Junio C Hamano and the git-list. 'git-bisect(1) Manual Page'. Linux Kernel Archives.]\n-- [[[9]]] http://github.com/Ealdwulf/bbchop[Ealdwulf. 'bbchop'. GitHub.]\n+- [[[8]]] https://www.kernel.org/pub/software/scm/git/docs/git-bisect.html[Junio C Hamano and the git-list. 'git-bisect(1) Manual Page'. Linux Kernel Archives.]\n+- [[[9]]] https://github.com/Ealdwulf/bbchop[Ealdwulf. 'bbchop'. GitHub.]\ndiff --git a/Documentation/gitweb.conf.txt b/Documentation/gitweb.conf.txt\nindex e6320891b..9c8982ec9 100644\n--- a/Documentation/gitweb.conf.txt\n+++ b/Documentation/gitweb.conf.txt\n@@ -368,8 +368,8 @@ $logo_url::\n $logo_label::\n \tURI and label (title) for the Git logo link (or your site logo,\n \tif you chose to use different logo image). By default, these both\n-\trefer to Git homepage, http://git-scm.com[]; in the past, they pointed\n-\tto Git documentation at http://www.kernel.org[].\n+\trefer to Git homepage, https://git-scm.com[]; in the past, they pointed\n+\tto Git documentation at https://www.kernel.org[].\n \n \n Changing gitweb's look\ndiff --git a/Documentation/howto/rebuild-from-update-hook.txt b/Documentation/howto/rebuild-from-update-hook.txt\nindex 25378f68d..db219f5c0 100644\n--- a/Documentation/howto/rebuild-from-update-hook.txt\n+++ b/Documentation/howto/rebuild-from-update-hook.txt\n@@ -4,13 +4,13 @@ From: Junio C Hamano \n Date: Fri, 26 Aug 2005 18:19:10 -0700\n Abstract: In this how-to article, JC talks about how he\n uses the post-update hook to automate Git documentation page\n- shown at http://www.kernel.org/pub/software/scm/git/docs/.\n+ shown at https://www.kernel.org/pub/software/scm/git/docs/.\n Content-type: text/asciidoc\n \n How to rebuild from update hook\n ===============================\n \n-The pages under http://www.kernel.org/pub/software/scm/git/docs/\n+The pages under https://www.kernel.org/pub/software/scm/git/docs/\n are built from Documentation/ directory of the git.git project\n and needed to be kept up-to-date. The www.kernel.org/ servers\n are mirrored and I was told that the origin of the mirror is on\n-- \n2.13.0.rc0.363.g8726c260e\n\n"},{"id":"317377","messageId":"20170420203348.g5b2ttxm7wray4vy@sigill.intra.peff.net","threadId":"45761","inReplyTo":"20170420203203.xlbajdfzy7gp3hj3@sigill.intra.peff.net","subject":"[PATCH 3/6] gitcore-tutorial: update broken link","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2017-04-20T20:33:49Z","receivedAt":"2017-04-20T20:34:03Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"The slides for the Linux-mentoring presentation are no\nlonger available. Let's point to the wayback version of the\npage, which works.\n\nNote that the referenced diagram is also available on page\n15 of [1]. We could link to that instead, but it's not clear\nfrom the URL scheme (\"uploads\") whether it's going to stick\naround forever.\n\n[1] https://www.linuxfoundation.jp/jp_uploads/seminar20070313/Randy.pdf\n\nSigned-off-by: Jeff King \n---\nTBH, I'm not sure this diagram is actually showing anything all that\nuseful, and maybe the paragraph could be re-worded, or a better diagram\nfound. I restricted myself here to a technical fix for the broken link,\nbut I'd be fine with somebody taking a more editorial pass.\n\n Documentation/gitcore-tutorial.txt | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/Documentation/gitcore-tutorial.txt b/Documentation/gitcore-tutorial.txt\nindex 3a0ec8c53..7577f27ec 100644\n--- a/Documentation/gitcore-tutorial.txt\n+++ b/Documentation/gitcore-tutorial.txt\n@@ -1429,7 +1429,7 @@ Although Git is a truly distributed system, it is often\n convenient to organize your project with an informal hierarchy\n of developers. Linux kernel development is run this way. There\n is a nice illustration (page 17, \"Merges to Mainline\") in\n-http://www.xenotime.net/linux/mentor/linux-mentoring-2006.pdf[Randy Dunlap's presentation].\n+https://web.archive.org/web/20120915203609/http://www.xenotime.net/linux/mentor/linux-mentoring-2006.pdf[Randy Dunlap's presentation].\n \n It should be stressed that this hierarchy is purely *informal*.\n There is nothing fundamental in Git that enforces the \"chain of\n-- \n2.13.0.rc0.363.g8726c260e\n\n"},{"id":"317378","messageId":"20170420203441.mrlwbkqinub7m225@sigill.intra.peff.net","threadId":"45761","inReplyTo":"20170420203203.xlbajdfzy7gp3hj3@sigill.intra.peff.net","subject":"[PATCH 4/6] docs/archimport: quote sourcecontrol.net reference","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2017-04-20T20:34:41Z","receivedAt":"2017-04-20T20:34:48Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"git-archimport has an option to register archives at\nmirrors.sourcecontrol.net. The sourcecontrol.net domain\nstill exists, but that hostname no longer exists.\n\nThat means this feature is presumably broken. I'll leave the\nexamination and modification of that to people who might\nactually use archimport. But in the meantime, let's wrap the\nreference in the documentation in backticks, which will\navoid turning it into a broken link (and thus polluting\nlinkchecker results).\n\nSigned-off-by: Jeff King \n---\nIt seems unlikely to me that anybody is using \"arch\" at all in 2017, so\nmaybe this whole command could be put to rest. But I didn't want to step\non any toes.\n\n Documentation/git-archimport.txt | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/Documentation/git-archimport.txt b/Documentation/git-archimport.txt\nindex 163b9f6f4..ea7065336 100644\n--- a/Documentation/git-archimport.txt\n+++ b/Documentation/git-archimport.txt\n@@ -96,7 +96,7 @@ OPTIONS\n \tpruned.\n \n -a::\n-\tAttempt to auto-register archives at http://mirrors.sourcecontrol.net\n+\tAttempt to auto-register archives at `http://mirrors.sourcecontrol.net`\n \tThis is particularly useful with the -D option.\n \n -t ::\n-- \n2.13.0.rc0.363.g8726c260e\n\n"},{"id":"317379","messageId":"20170420203528.ij4tfmz4g4hafwr2@sigill.intra.peff.net","threadId":"45761","inReplyTo":"20170420203203.xlbajdfzy7gp3hj3@sigill.intra.peff.net","subject":"[PATCH 5/6] docs/bisect-lk2009: update nist report link","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2017-04-20T20:35:28Z","receivedAt":"2017-04-20T20:35:34Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"The original NIST press release linked here is no longer\navailable. But it was just a one-page summary of a larger\nplanning report; we can link to the report and point people\nto the executive summary, which contains the same\ninformation.\n\nIdeally we'd cite it with a DOI, but I couldn't dig one up\nfor this particular document. I found many URLs pointing to\nthis report, but they all end up redirecting to this one\n(and it looks somewhat official).\n\nSigned-off-by: Jeff King \n---\nThis one and the next are in somewhat of a historical document, so maybe\nit's better to leave it as-is. We _do_ build it via \"make html\", though.\n\n Documentation/git-bisect-lk2009.txt | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/Documentation/git-bisect-lk2009.txt b/Documentation/git-bisect-lk2009.txt\nindex 716d66d43..263a853fa 100644\n--- a/Documentation/git-bisect-lk2009.txt\n+++ b/Documentation/git-bisect-lk2009.txt\n@@ -1347,7 +1347,7 @@ author to given a talk and for publishing this paper.\n References\n ----------\n \n-- [[[1]]] http://www.nist.gov/public_affairs/releases/n02-10.htm['Software Errors Cost U.S. Economy $59.5 Billion Annually'. Nist News Release.]\n+- [[[1]]] https://www.nist.gov/sites/default/files/documents/director/planning/report02-3.pdf['The Economic Impacts of Inadequate Infratructure for Software Testing'. Nist Planning Report 02-3], see Executive Summary and Chapter 8.\n - [[[2]]] http://java.sun.com/docs/codeconv/html/CodeConventions.doc.html#16712['Code Conventions for the Java Programming Language'. Sun Microsystems.]\n - [[[3]]] https://en.wikipedia.org/wiki/Software_maintenance['Software maintenance'. Wikipedia.]\n - [[[4]]] http://article.gmane.org/gmane.comp.version-control.git/45195/[Junio C Hamano. 'Automated bisect success story'. Gmane.]\n-- \n2.13.0.rc0.363.g8726c260e\n\n"},{"id":"317380","messageId":"20170420203536.pbzwtao5vrsqwwsi@sigill.intra.peff.net","threadId":"45761","inReplyTo":"20170420203203.xlbajdfzy7gp3hj3@sigill.intra.peff.net","subject":"[PATCH 6/6] docs/bisect-lk2009: update java code conventions link","fromName":"Jeff King","fromEmail":"peff@peff.net","sentAt":"2017-04-20T20:35:36Z","receivedAt":"2017-04-20T20:35:43Z","isPatch":true,"sender":{"key":"peff@peff.net","avatar":"https://avatars.githubusercontent.com/u/45925?v=4"},"body":"The old link just redirects to a big index page. I was able\nto find a new link for the original document via Google.\n\nSigned-off-by: Jeff King \n---\n Documentation/git-bisect-lk2009.txt | 2 +-\n 1 file changed, 1 insertion(+), 1 deletion(-)\n\ndiff --git a/Documentation/git-bisect-lk2009.txt b/Documentation/git-bisect-lk2009.txt\nindex 263a853fa..8ac75fcc2 100644\n--- a/Documentation/git-bisect-lk2009.txt\n+++ b/Documentation/git-bisect-lk2009.txt\n@@ -1348,7 +1348,7 @@ References\n ----------\n \n - [[[1]]] https://www.nist.gov/sites/default/files/documents/director/planning/report02-3.pdf['The Economic Impacts of Inadequate Infratructure for Software Testing'. Nist Planning Report 02-3], see Executive Summary and Chapter 8.\n-- [[[2]]] http://java.sun.com/docs/codeconv/html/CodeConventions.doc.html#16712['Code Conventions for the Java Programming Language'. Sun Microsystems.]\n+- [[[2]]] http://www.oracle.com/technetwork/java/codeconvtoc-136057.html['Code Conventions for the Java Programming Language'. Sun Microsystems.]\n - [[[3]]] https://en.wikipedia.org/wiki/Software_maintenance['Software maintenance'. Wikipedia.]\n - [[[4]]] http://article.gmane.org/gmane.comp.version-control.git/45195/[Junio C Hamano. 'Automated bisect success story'. Gmane.]\n - [[[5]]] https://lwn.net/Articles/317154/[Christian Couder. 'Fully automated bisecting with \"git bisect run\"'. LWN.net.]\n-- \n2.13.0.rc0.363.g8726c260e\n"}]}