INN commit: trunk/doc/pod (hacking.pod)
rra at isc.org
Mon Dec 17 15:07:57 UTC 2018
Date: Monday, December 17, 2018 @ 07:07:56
HACKING: mention "make depend" and better explain where m4 files are in the libtool Debian package
hacking.pod | 49 +++++++++++++++++++++++++++++++++++--------------
1 file changed, 35 insertions(+), 14 deletions(-)
--- 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.
@@ -769,12 +771,31 @@
-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.
+Run C<autogen> and C<configure> that are currently necessary to generate
+Then, run C<make warnings> to generate all necessary files.
+Run C<make depend> to ensure dependencies are properly defined in all
+Afterwards, run C<make check-manifest>. There shouldn't be any
+differences; otherwise, fix the F<MANIFEST> file.
Run C<make release> for a final release, C<support/mksnapshot BETA b1> for
More information about the inn-committers