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 39e31204b6e32f4c378cbb22ec001a90a0dc797d..4c2fd641fb30a693df36002f08a16364e8448e29 100644 (file)
--- 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 2e81bb17f0c33feefff319fd3b8c6fb1de7dc046..6be807f8772003ac21523980665049ac4c87594b 100755 (executable)
--- 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',