INN commit: trunk/doc/pod (hacking.pod)

[INN Commit]

    Date: Monday, December 17, 2018 @ 07:07:56
  Author: iulius
Revision: 10317

HACKING:  mention "make depend" and better explain where m4 files are in the libtool Debian package

Modified:
  trunk/doc/pod/hacking.pod

-------------+
 hacking.pod |   49 +++++++++++++++++++++++++++++++++++--------------
 1 file changed, 35 insertions(+), 14 deletions(-)

Modified: hacking.pod
===================================================================
--- hacking.pod	2018-12-17 14:51:05 UTC (rev 10316)
+++ hacking.pod	2018-12-17 15:07:56 UTC (rev 10317)
@@ -69,16 +69,17 @@
 The supporting files for B<autoconf> are in the F<support>
 subdirectory, including the files F<config.guess> and F<config.sub>
 to determine the system name and F<ltmain.sh> for libtool support.
-The latter file comes from the Debian package of Libtool, available
-from L<https://packages.debian.org/libtool> (F<ltmain.sh> is generated
-in the F<build-aux> subdirectory after building the package with
-for instance B<debuild -us -uc>); the canonical versions of the former two
-files are available from L<ftp://ftp.gnu.org/gnu/config/> (which currently
+The latter file comes from the Debian package of Libtool, available from
+L<https://packages.debian.org/libtool> (F<ltmain.sh> is generated in the
+F<build-aux> subdirectory after building the package with for instance
+B<debuild -us -uc>); the canonical versions of the former two files
+are available from L<ftp://ftp.gnu.org/gnu/config/> (which currently
 redirects to L<http://git.savannah.gnu.org/gitweb/?p=config.git;a=tree>).
-In addition, F<m4/libtool.m4> and a few others m4 files used by INN are
-just a copy of the corresponding files in the F<m4> subdirectory
-of the Debian package of the libtool distribution.  (Using libtool
-without using B<automake> requires a few odd hacks.)  New versions
+In addition, F<m4/libtool.m4> and a few others m4 files used
+by INN are just a copy of the corresponding files in the
+F<debian/libtool/usr/share/aclocal> subdirectory of the Debian
+package of the libtool distribution.  (Using libtool without
+using B<automake> requires a few odd hacks.)  New versions
 should be checked in periodically when available.  There are no
 INN-specific modifications to those files except for F<ltmain.sh>
 which recognizes the additional B<-B> flag that INN's B<install-sh>
@@ -722,6 +723,7 @@
 
 Also build INN (including the F<contrib> and F<tests> directories) with
 warnings on (C<make warnings>) and run the test suite (C<make tests>).
+Fix any errors.
 
 =item 3.
 
@@ -769,12 +771,31 @@
 
 =item 8.
 
-Check out a copy of the release branch.  It's currently necessary to run
-C<autogen> and C<configure> to generate F<Makefile.global>.  Then, run
-C<make warnings> to generate all necessary files.  Afterwards, run
-C<make check-manifest>.  There shouldn't be any differences; otherwise,
-fix the F<MANIFEST> file.
+Check out a copy of the release branch, and perform the following actions.
 
+=over 2
+
+=item *
+
+Run C<autogen> and C<configure> that are currently necessary to generate
+F<Makefile.global>.
+
+=item *
+
+Then, run C<make warnings> to generate all necessary files.
+
+=item *
+
+Run C<make depend> to ensure dependencies are properly defined in all
+INN makefiles.
+
+=item *
+
+Afterwards, run C<make check-manifest>.  There shouldn't be any
+differences; otherwise, fix the F<MANIFEST> file.
+
+=back
+
 =item 9.
 
 Run C<make release> for a final release, C<support/mksnapshot BETA b1> for