Merge branch 'maint'

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

diff --cc ChangeLog
index 5da2962,c77326d..c1e4a46
--- 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 0409258,8da5a21..fd50754
--- 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 c501819,1504233..306189d
--- 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