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.

diff --git a/ChangeLog b/ChangeLog
index 7c8888e1b15e104b152c52b6035a5bf0b3f39c49..64c2bbb10f7f5fc1046c8aa524e225942d760645 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+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

diff --git a/doc/automake.texi b/doc/automake.texi
index d60bfe49bb3f57f9cfa4fd5a8f0227e730e0144a..da2e2b4673678cd0af2b5fbd4932f4a484d93bc4 100644 (file)
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -8740,10 +8740,10 @@ but should be reserved for the user.
 The @code{AM_TESTS_ENVIRONMENT} variable can be used to run initialization
 code and set environment variables for the tests' runs.  The user can
 still employ the @code{TESTS_ENVIRONMENT} variable to override settings
-from @code{AM_TESTS_ENVIRONMENT}.  Note that, for implementation reasons,
-if the @code{AM_TESTS_ENVIRONMENT} variable is set, its contents
-@emph{must} be terminated by a semicolon.  Here is an example of a
-slightly elaborate definition:
+from @code{AM_TESTS_ENVIRONMENT}; for that to work portably, however,
+the contents of a non-empty @code{AM_TESTS_ENVIRONMENT} @emph{must} be
+terminated by a semicolon.  Here is an example of a slightly elaborate
+definition:
 
 @example
 AM_TESTS_ENVIRONMENT = \