configure: remove AM_MAINTAINER_MODE, effectively always enabling all the rules 76/1476/4
authorPaul Fertser <fercerpav@gmail.com>
Sat, 6 Jul 2013 05:12:45 +0000 (09:12 +0400)
committerSpencer Oliver <spen@spen-soft.co.uk>
Mon, 15 Jul 2013 10:13:51 +0000 (10:13 +0000)
There're strong arguments against using this macro (mostly regarding
build consistency), so remove it altogether.

Change-Id: I90c8e9a86a24571019366435bd868a6799a09c45
Signed-off-by: Paul Fertser <fercerpav@gmail.com>
Reviewed-on: http://openocd.zylin.com/1476
Tested-by: jenkins
Reviewed-by: Spencer Oliver <spen@spen-soft.co.uk>
Reviewed-by: Andreas Fritiofson <andreas.fritiofson@gmail.com>
README
bootstrap
configure.ac
doc/manual/primer/autotools.txt

diff --git a/README b/README
index 14d073b..d1b983d 100644 (file)
--- a/README
+++ b/README
@@ -203,11 +203,6 @@ interfaces should be included (among other things).  The following list
 of options was extracted from the output of './configure --help'.  Other
 options may be available there:
 
-  --enable-maintainer-mode  enable make rules and dependencies not useful
-                          (and sometimes confusing) to the casual installer
-                         NOTE: This option is *required* for GIT builds!
-                         It should *not* be used to build a release.
-
   --enable-dummy          Enable building the dummy JTAG port driver
 
   --enable-parport        Enable building the pc parallel port driver
@@ -453,9 +448,9 @@ Tips For Building From a GIT Repository
 ---------------------------------------
 
 Building OpenOCD from a repository requires a recent version of the GNU
-autotools (autoconf >= 2.59 and automake >= 1.9).
+autotools (autoconf >= 2.60 and automake >= 1.9).
 
 1) Run './bootstrap' to create the 'configure' script and prepare
    the build process for your host system.
 
-2) Run './configure --enable-maintainer-mode' with other options.
+2) Run './configure' with other options.
index 8a3945e..3b60fc6 100755 (executable)
--- a/bootstrap
+++ b/bootstrap
@@ -31,10 +31,6 @@ autoheader
 automake --gnu --add-missing --copy
 )
 
-# AM_MAINTAINER_MODE requires --enable-maintainer-mode from everyone using
-# current source snapshots (working from GIT, or some source snapshot, etc)
-# otherwise the documentation will fail to build due to missing version.texi
-
 if [ -n "$SKIP_SUBMODULE" ]; then
     echo "Skipping submodule setup"
 else
@@ -44,4 +40,4 @@ else
 fi
 
 echo "Bootstrap complete. Quick build instructions:"
-echo "./configure --enable-maintainer-mode ...."
+echo "./configure ...."
index 87f95d5..2998ec7 100644 (file)
@@ -6,7 +6,6 @@ AC_CONFIG_SRCDIR([src/openocd.c])
 m4_include([config_subdir.m4])dnl
 
 AM_INIT_AUTOMAKE([-Wall -Wno-portability dist-bzip2 dist-zip])
-AM_MAINTAINER_MODE
 
 AC_CONFIG_HEADERS([config.h])
 AH_BOTTOM([
index 28a4b5f..9d9aada 100644 (file)
@@ -53,26 +53,6 @@ The @c autoconf program generates the @c configure script from
 included in the project distribution packages and run by users to
 configure the build process for their system.
 
-@subsection primermaintainermode Maintainer Mode
-
-After a fresh checkout, @c bootstrap, and a simple @c configure, you may
-experience errors when running @c make that some files cannot be found
-(e.g. @c version.texi), and a second @c make will "mysteriously" solve
-the problems.  The isssue is well-known and expected, if unfortunate.
-
-The OpenOCD project requires that all developers building from  the
-git repository use the @c --enable-maintainer-mode option when
-running the @c configure script.  This option ensures that certain files
-are created during the build process that would normally be packaged in
-the distribution tarball.  The @c bootstrap script will remind you of
-this requirement when it runs.
-
-In addition to solving these problems, this option enables Makefile
-rules (provided by automake) that allow the normal @c make process to
-rebuild the autotools outputs, included the automake-generated Makefiles
-themselves.  This avoids the heavy-handed approach of running the
-@c bootstrap script after changing one of these files.
-
 @section primerautomake Automake Makefiles
 
 The @c automake program generates @c Makefile.in files (from @c