Merge branch 'maint'

* maint:
  docs, tests: synchronize examples from docs to tests

diff --cc ChangeLog
index 5da2962c8ef3d1f9047a2360693e9fab535a37c1,c77326d2f0c0e213a218063ab2968ea5cfebefab..c1e4a46097efee654ca2b4330708c6e15e038018
--- 1/ChangeLog
--- 2/ChangeLog
+++ b/ChangeLog
@@@ -1,28 -1,26 +1,49 @@@
 -      * tests/interp.test: Likewise.  Since we are at it, and enable
 -      the `errexit' shell flag, do related changes, and add trailing
 -      `:'command.
+ 2011-07-01  Stefano Lattarini  <stefano.lattarini@gmail.com>
+ 
+       docs, tests: synchronize examples from docs to tests
+       * tests/README (Writing test cases): Give suggestions on how to
+       keep test cases and examples in the documentation synchronized.
+       * doc/automake.texi: Improve or fix existing testcase-referencing
+       comments, and add many new ones.
+       * HACKING (Administrivia): Suggest to test complex examples and
+       idioms from the manual.
+       * tests/specflg8.test: Improve synchronization with the example
+       in the manual.
+       * tests/output11.test:Likewise.
+       * tests/txinfo21.test:Likewise.
++      * tests/interp.test: Likewise.
+       * tests/amhello-cflags.test: New test.
+       * tests/amhello-cross-compile.test: Likewise.
+       * tests/amhello-binpkg.test: Likewise.
+       * tests/tests-environment-backcompat: Likewise.
+       * tests/parallel-tests-log-compiler-example.test: Likewise.
+       * tests/Makefile.am (TESTS): Update.
+ 
 +2011-06-30   Stefano Lattarini  <stefano.lattarini@gmail.com>
 +
 +      coverage: new test on parallel-tests TESTS runtime overriding
 +      * tests/parallel-tests-cmdline-override.test: New test, check that
 +      we can use indirections when overriding TESTS and TEST_LOGS from
 +      the command line.
 +      * tests/Makefile.am (TESTS): Update.
 +
 +2011-06-29   Stefano Lattarini  <stefano.lattarini@gmail.com>
 +
 +      docs: explain why AM_TESTS_ENVIRONMENT must be semicolon-terminated
 +      * doc/automake.texi (Simple Tests using parallel-tests): Ditto, and
 +      related adjustments.
 +      Suggestion by Ralf Wildenhues.
 +
 +2011-06-29  Stefano Lattarini  <stefano.lattarini@gmail.com>
 +
 +      docs: fix unportable example of AM_TESTS_ENVIRONMENT usage
 +      * doc/automake.texi (Simple Tests using parallel-tests): The
 +      old example on AM_TESTS_ENVIRONMENT relied on unportable shell
 +      features, and in particular didn't work with various Korn
 +      Shells (see also commit `v1.11-925-g29ca903').  Give another
 +      example, simpler this time, but still inspired to real-world
 +      usage (the GNU coreutils testsuite).
 +
  2011-06-23  Stefano Lattarini  <stefano.lattarini@gmail.com>
  
        docs: avoid a footnote, some related rewordings and improvements

diff --cc HACKING
Simple merge

diff --cc doc/automake.texi
Simple merge

diff --cc tests/Makefile.am
index 0409258f3f9df73f7267d059f1de8c87a1907776,8da5a21fcc4e27a01255d97d2829e9920ce259af..fd50754fead991e1081831e22243aabc0a03f6f5
--- 1/tests/Makefile.am
--- 2/tests/Makefile.am
+++ b/tests/Makefile.am
@@@ -727,7 -604,7 +731,8 @@@ parallel-tests-harderror.test 
  parallel-tests-log-override-1.test \
  parallel-tests-log-override-2.test \
  parallel-tests-log-override-recheck.test \
 +parallel-tests-cmdline-override.test \
+ parallel-tests-log-compiler-example.test \
  parse.test \
  percent.test \
  percent2.test \

diff --cc tests/Makefile.in
index c5018197c04d0c2878f3dfa802bfee422b5fdfd9,150423370d0ccb9089c9ba2b9ef2f7dfc5710d4e..306189da54b88954d466575d4aa392c285254479
--- 1/tests/Makefile.in
--- 2/tests/Makefile.in
+++ b/tests/Makefile.in
@@@ -1000,7 -881,7 +1004,8 @@@ parallel-tests-harderror.test 
  parallel-tests-log-override-1.test \
  parallel-tests-log-override-2.test \
  parallel-tests-log-override-recheck.test \
 +parallel-tests-cmdline-override.test \
+ parallel-tests-log-compiler-example.test \
  parse.test \
  percent.test \
  percent2.test \

diff --cc tests/README
Simple merge

diff --cc tests/interp.test
Simple merge

diff --cc tests/specflg8.test
Simple merge

diff --cc tests/txinfo21.test
Simple merge