From: Karl Berry <karl@freefriends.org>
Date: Wed, 13 Dec 2023 18:17:49 +0000 (-0800)
Subject: doc: checklinkx tweaks.
X-Git-Tag: v1.16i~1
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=5c8dce802376c4a0d289fff414572d518d743556;p=thirdparty%2Fautomake.git

doc: checklinkx tweaks.

* HACKING: mention checklinkx to check for broken links.
* contrib/checklinkx: mention us in version info;
use warnings instead of -w.
---

diff --git a/HACKING b/HACKING
index 39e31204b..4c2fd641f 100644
--- a/HACKING
+++ b/HACKING
@@ -481,7 +481,7 @@
     make -j12 check keep_testdirs=yes
     make maintainer-check
     make -j12 distcheck                                # regular distcheck
-    make -j12 distcheck AM_TESTSUITE_MAKE="make -j$j"  # parallelize makes
+    make -j12 distcheck AM_TESTSUITE_MAKE="make -j12"  # parallelize makes
     make -j12 check-no-trailing-backslash-in-recipes
     make -j12 check-cc-no-c-o
 
@@ -506,6 +506,12 @@
 
 * For stable releases you'll have to update the manuals at www.gnu.org.
 
+  - Check links:
+       make html
+       make checklinkx # various perl prerequisites, see contrib/checklinkx
+    or use:
+      <https://validator.w3.org/checklink>
+
   - Generate manuals (with the help of the standard gendocs.sh script):
        make web-manual
 
@@ -520,9 +526,6 @@
     for example:
       make web-manual-update CVS_USER=slattarini
 
-  - Check for link errors, fix them, recheck until convergence:
-    <http://validator.w3.org/checklink>
-
 * Create an announcement message with "make announcement".  Edit the
   generated 'announcement' file appropriately, in particularly filling
   in by hand any "TODO" left in there.
diff --git a/contrib/checklinkx b/contrib/checklinkx
index 2e81bb17f..6be807f87 100755
--- a/contrib/checklinkx
+++ b/contrib/checklinkx
@@ -1,4 +1,4 @@
-#!/usr/local/bin/perl -wT
+#!/usr/local/bin/perl
 #
 # W3C Link Checker
 # by Hugo Haas <hugo@w3.org>
@@ -35,7 +35,9 @@
 #
 # For GNU Automake, this program is used by the checklinkx target
 # in doc/local.mk to check the (html output of) automake manual.
+# (Run make html to create automake.html.)
 
+use warnings;
 use strict;
 use 5.008;
 
@@ -329,9 +331,9 @@ use constant LINK_LIST_ATTRS => {
 BEGIN {
 
     # Version info
-    $PACKAGE  = 'W3C Link Checker';
-    $PROGRAM  = 'W3C-checklink';
-    $VERSION  = '4.81';
+    $PACKAGE  = 'W3C Link Checker (+GNU Automake)';
+    $PROGRAM  = 'W3C-checklink-am';
+    $VERSION  = '4.81-am';
     $REVISION = sprintf('version %s (c) 1999-2011 W3C', $VERSION);
     $AGENT    = sprintf(
         '%s/%s %s',