more HACKING tweaks

diff --git a/HACKING b/HACKING
index 5f0effff30e76d85811142d2f80bad30522e9ecb..248fd4b0312b198e6f3c3ae30a16a6868c9e133e 100644 (file)
--- a/HACKING
+++ b/HACKING
@@ -37,9 +37,9 @@
   $(FETCHFILES) variable in Makefile.am.  They should never be edited
   here.  All but one of them can be updated from respective upstreams
   with "make fetch" (this should be done especially before releases).
-  The only exception is 'lib/COPYING' (from FSF), which should be
-  updated by hand whenever the GPL gets updated (which shouldn't happen
-  that often anyway :-)
+  The only exceptions are help2man (install the current version) and
+  'lib/COPYING' (from FSF), which should be updated by hand whenever the
+  GPL gets updated (which shouldn't happen that often anyway :-).
 
 * All changes that are not trivial bug fixes must be mentioned in NEWS.
 
@@ -351,7 +351,7 @@
   runs the fastest on your machine.  We'll use -j12 in this document.
 
 * To summarize, here is a typical make check invocation:
-    make -j12 VERBOSE=1 keep_testdirs=yes check
+    make -j12 VERBOSE=1 check keep_testdirs=yes
 
 * Then check t/test-suite.log for the overall results.  The directory
   t/TESTNAME.dir is where the work will be left, if the test fails.
@@ -457,14 +457,14 @@
   The repository will always have its own "odd" number so we can easily
   distinguish net and repo versions.)
 
-* Run these commands, in this order:
-
+* Run these commands, in this order (as mentioned, adjust -j as desired):
     make bootstrap
-    make check keep_testdirs=yes
+    make -j12 check keep_testdirs=yes
     make maintainer-check
-    make distcheck
-    make check-no-trailing-backslash-in-recipes
-    make check-cc-no-c-o
+    make -j12 distcheck                                # regular distcheck
+    make -j12 distcheck AM_TESTSUITE_MAKE="make -j$j"  # parallelize makes
+    make -j12 check-no-trailing-backslash-in-recipes
+    make -j12 check-cc-no-c-o
 
   It is also advised to run "git clean -fdx" before invoking the
   bootstrap, to ensure a really clean rebuild.  However, it must
@@ -488,20 +488,17 @@
 * For stable releases you'll have to update the manuals at www.gnu.org.
 
   - Generate manuals (with the help of the standard gendocs.sh script):
-
        make web-manual
 
     The ready-to-be-uploaded manuals (in several formats) will be left
     in the 'doc/web-manuals' directory.
 
   - Commit the updated manuals to web CVS:
-
       make web-manual-update
 
     If your local username is different from your username at Savannah,
     you'll have to override the 'CVS_USER' make variable accordingly;
     for example:
-
       make web-manual-update CVS_USER=slattarini
 
   - Check for link errors, fix them, recheck until convergence:
@@ -529,8 +526,7 @@
   the version you sent to the automake list, as get archived on
   <https://lists.gnu.org/archive/html/automake/>).
 
------
-
+---------
 Copyright (C) 2003-2022 Free Software Foundation, Inc.
 
 This program is free software; you can redistribute it and/or modify