Re: [PATCH v2] api-argv-array.txt: Remove broken link to string-list API
- Date: Fri, 6 Oct 2017 00:08:41 -0400
- From: Todd Zullinger <tmz@xxxxxxxxx>
- Subject: Re: [PATCH v2] api-argv-array.txt: Remove broken link to string-list API
Jonathan Nieder wrote:
Thanks for catching it. Do you use a broken link detection tool to
detect this kind of issue automatically?
Yeah, in the Fedora git builds we pass all the generated html files
through the linkchecker tool (http://wummel.github.io/linkchecker/).
We started using that a few months ago to help us catch broken links
in case we somehow failed to include some documentation in our
packaging. (After catching this minor issue I wondered if it might be
useful to add something similar to the travis builds, but I haven't
done any more than wonder about it. ;)
Here's the (somehwat verbose) output from the failed link check:
$ find /builddir/build/BUILDROOT/git-2.15.0-0.0.rc0.fc25.x86_64/usr/share/doc/git -name '*.html' | xargs linkchecker
Start checking at 2017-10-05 12:37:01-004
10 threads active, 325 links queued, 194 links in 47 URLs checked, runtime 1 seconds
10 threads active, 643 links queued, 1242 links in 197 URLs checked, runtime 6 seconds
Name `string-list API'
Parent URL file:///builddir/build/BUILDROOT/git-2.15.0-0.0.rc0.fc25.x86_64/usr/share/doc/git/technical/api-argv-array.html, line 745, col 31
Real URL file:///builddir/build/BUILDROOT/git-2.15.0-0.0.rc0.fc25.x86_64/usr/share/doc/git/technical/api-string-list.html
Check time 0.002 seconds
Result Error: URLError: <urlopen error [Errno 2] No such file or directory: '/builddir/build/BUILDROOT/git-2.15.0-0.0.rc0.fc25.x86_64/usr/share/doc/git/technical/api-string-list.html'>
Content types: 0 image, 2764 text, 0 video, 0 audio, 0 application, 29 mail and 49 other.
URL lengths: min=17, max=125, avg=96.
That's it. 2842 links in 232 URLs checked. 0 warnings found. 1 error found.
Stopped checking at 2017-10-05 12:37:09-004 (8 seconds)
I always wanted to be a procrastinator, never got around to it.