build/README.txt

   1 autogen.mk
   2
   3 autogen.mk is a makefile provided to automatically update the GNU autotools
   4 build system.  It will run Bakefile, aclocal, and autoconf as appropriate.
   5
   6 The .m4 files required for running aclocal are located in build/aclocal.
   7 When upgrading software that wxWidgets depends on (for example, Bakefile,
   8 cppunit, GTK, SDL, or others) it is advisable to upgrade the .m4 files
   9 located in the build/aclocal directory.
  10
  11 It is particularly important that if you use a newer version of Bakefile
  12 to generate the Makefile.in files that you use the newer bakefile*.m4.
  13 Because build/autogen.mk is a Makefile it will automatically rerun
  14 aclocal and autoconf as necessary whenever any m4 in build/aclocal is
  15 newer than the generated aclocal.m4.
  16
  17 You can achieve this simply by copying the new bakefile*.m4 files from
  18 PREFIX/share/aclocal/ into the build/aclocal/ directory and
  19 rerunning make -f build/autogen.mk.  Note that you should _not_ preserve
  20 source file times (don't use cp -p) or else it's possible your .m4 files
  21 will be older than the generated aclocal.m4).
  22 Example:
  23 cp /usr/share/aclocal/bakefile*.m4 build/aclocal/
  24 make -f build/autogen.mk
  25
  26 Please don't forget to commit updated .m4 files as well as updated aclocal.m4,
  27 configure, and Makefile.in files to wxWidgets.