git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH v2] api-argv-array.txt: Remove broken link to string-list API

From
Todd Zullinger <tmz@pobox.com>
Date
Oct 6, 2017, 04:08 UTC
Message-ID
<20171006040841.GD3382@zaya.teonanacatl.net>
In-Reply-To
<20171006034538.GA142701@aiede.mtv.corp.google.com>
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

URL `api-string-list.html' 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'>

Statistics:
Downloaded: 7.17MB.
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)

-- 
Todd
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
I always wanted to be a procrastinator, never got around to it.
Previous: Jonathan Nieder
Message 5 of 5 in “api-argv-array.txt: Update link to string-list API”
  1. api-argv-array.txt: Update link to string-list APITodd Zullinger, Oct 5, 2017
  2. Junio C HamanoOct 6, 2017
  3. api-argv-array.txt: Remove broken link to string-list APITodd Zullinger, Oct 6, 2017
  4. Jonathan NiederOct 6, 2017
  5. Todd ZullingerOct 6, 2017

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.