[automake-commit] branch master updated: doc: checklinkx tweaks.

[Karl Berry]

This is an automated email from the git hooks/post-receive script.

karl pushed a commit to branch master
in repository automake.

View the commit online:
https://git.savannah.gnu.org/gitweb/?p=automake.git;a=commitdiff;h=5c8dce802376c4a0d289fff414572d518d743556

The following commit(s) were added to refs/heads/master by this push:
     new 5c8dce802 doc: checklinkx tweaks.
5c8dce802 is described below

commit 5c8dce802376c4a0d289fff414572d518d743556
Author: Karl Berry <karl@freefriends.org>
AuthorDate: Wed Dec 13 10:17:49 2023 -0800

    doc: checklinkx tweaks.
    
    * HACKING: mention checklinkx to check for broken links.
    * contrib/checklinkx: mention us in version info;
    use warnings instead of -w.
---
 HACKING            | 11 +++++++----
 contrib/checklinkx | 10 ++++++----
 2 files changed, 13 insertions(+), 8 deletions(-)

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',