summaryrefslogtreecommitdiff
path: root/m4/README
diff options
context:
space:
mode:
authorJim Meyering <jim@meyering.net>2002-07-06 07:38:46 +0000
committerJim Meyering <jim@meyering.net>2002-07-06 07:38:46 +0000
commit942ce19a6f896e37794d1922a824b6f428a57c78 (patch)
tree6579b92965a37dc1bae9a90b6cb28bade8a8442d /m4/README
parentfd8fc3a9ddbefe4d8cacfd487a39d04d9705eaa8 (diff)
downloadgnulib-942ce19a6f896e37794d1922a824b6f428a57c78.tar.gz
Don't mention Makefile.am.in.
Outline how I've tested changes to .m4 files. Yep, it's a pain.
Diffstat (limited to 'm4/README')
-rw-r--r--m4/README18
1 files changed, 13 insertions, 5 deletions
diff --git a/m4/README b/m4/README
index 3a38ae8b95..a101922ba9 100644
--- a/m4/README
+++ b/m4/README
@@ -1,10 +1,18 @@
-The files in this directory are shared between the fileutils, sh-utils,
-and textutils packages.
+Many of the files in this directory are shared between the diffutils,
+fileutils, sh-utils, and textutils packages -- and others, so if you
+change them, try to ensure that you don't break those packages.
+Unfortunately, that's hard.
+
+One way to do that is to put the modified .m4 file in each of the packages,
+run `make dist' to create a .tar.gz file, then build that package on as
+many different types of systems as possible. Then repeat, but using the
+original version of the .m4 file. Run configure like this each time
+`./configure --cache=config.cache' and be sure to save the following files
+from each run: config.cache config.status config.out config.h*.
+Then compare the two versions of each of those files and be prepared to
+explain any differences.
These files are used by a program called aclocal (part of the GNU automake
package). aclocal uses these files to create aclocal.m4 which is in turn
used by autoconf to create the configure script at the top level in
this distribution.
-
-The Makefile.am file in this directory is automatically generated
-from the template file, Makefile.am.in.