[SCM] GNU Autoconf source repository branch, master, updated. v2.67-62-g97d209d

[Ralf Wildenhues]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "GNU Autoconf source repository".

http://git.sv.gnu.org/gitweb/?p=autoconf.git;a=commitdiff;h=97d209ddb1ae2ccc0ac3c5272341252bbec39bed

The branch, master has been updated
       via  97d209ddb1ae2ccc0ac3c5272341252bbec39bed (commit)
       via  23a2c336ade17124f1666dfcf203d83fc7d7c310 (commit)
       via  cb093133b5bf8c2a25e2916e12e8bd8ee7606231 (commit)
       via  37b43561c5bdf3c028d365feef9c1712df737a89 (commit)
       via  d85369c9bffea405dc9b238d0c07d62cf3501beb (commit)
       via  88eeae7588edba68e64100e1ac7b832d0ad5c22c (commit)
      from  dfa02369c4cb8ad4b7df481c2d837177719bbb3c (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 97d209ddb1ae2ccc0ac3c5272341252bbec39bed
Author: Ralf Wildenhues <address@hidden>
Date:   Sun Sep 12 18:37:08 2010 +0200

    docs: document zsh specialty with empty here-documents.
    
    * doc/autoconf.texi (Here-Documents): zsh 4.3.10 adds a newline
    to empty here-docs.
    
    Signed-off-by: Ralf Wildenhues <address@hidden>

commit 23a2c336ade17124f1666dfcf203d83fc7d7c310
Author: Ralf Wildenhues <address@hidden>
Date:   Sun Sep 12 17:04:49 2010 +0200

    docs: document zsh special array $options.
    
    * doc/autoconf.texi (Special Shell Variables): Add entry for
    `options'.
    
    Signed-off-by: Ralf Wildenhues <address@hidden>

commit cb093133b5bf8c2a25e2916e12e8bd8ee7606231
Author: Ralf Wildenhues <address@hidden>
Date:   Sun Sep 12 09:46:41 2010 +0200

    doc: minor updates.
    
    * doc/autoconf.texi (Generic Compiler Characteristics): Use
    second argument of @uref consistently, for nicer OpenMP link.
    (Polymorphic Variables): Restore font-lock.
    (Debugging): Add item for bashdb.
    
    Signed-off-by: Ralf Wildenhues <address@hidden>

commit 37b43561c5bdf3c028d365feef9c1712df737a89
Author: Ralf Wildenhues <address@hidden>
Date:   Sun Sep 12 09:45:34 2010 +0200

    Document and test AT_CHECK args shell execution environment.
    
    * doc/autoconf.texi (Writing Testsuites): Document that COMMANDS
    is run in a subshell, but RUN-IF-FAIL and RUN-IF-PASS are not.
    * tests/autotest.at (AT@&address@hidden execution environment): New
    test.
    * NEWS: Update.
    
    Signed-off-by: Ralf Wildenhues <address@hidden>

commit d85369c9bffea405dc9b238d0c07d62cf3501beb
Author: Ralf Wildenhues <address@hidden>
Date:   Sun Sep 12 09:45:04 2010 +0200

    autotest: document and test at_status semantics.
    
    * doc/autoconf.texi (Writing Testsuites): Document $at_status.
    * tests/autotest.at (at_status): New test.
    * NEWS: Update.
    
    Signed-off-by: Ralf Wildenhues <address@hidden>

commit 88eeae7588edba68e64100e1ac7b832d0ad5c22c
Author: Ralf Wildenhues <address@hidden>
Date:   Sun Sep 12 09:42:22 2010 +0200

    doc: index entries for non-environment, non-output variables.
    
    * doc/autoconf.texi: Clarify the meaning of the various variable
    indices.  Merge variable index `vr' into concept index using
    syncodeindex.
    (Configuration Actions, Generic Programs, Generic Functions)
    (Writing Testsuites): Add index entries for documented shell
    variables used during in configure and testsuite scripts.
    
    Signed-off-by: Ralf Wildenhues <address@hidden>

-----------------------------------------------------------------------

Summary of changes:
 ChangeLog         |   39 ++++++++++++++++++++++++++++++++
 NEWS              |    3 ++
 doc/autoconf.texi |   63 ++++++++++++++++++++++++++++++++++++++++++----------
 tests/autotest.at |   46 ++++++++++++++++++++++++++++++++++++++
 4 files changed, 139 insertions(+), 12 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 781ea92..9431c94 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,42 @@
+2010-09-13  Ralf Wildenhues  <address@hidden>
+           Gary V. Vaughan <address@hidden>
+
+       docs: document zsh specialty with empty here-documents.
+       * doc/autoconf.texi (Here-Documents): zsh 4.3.10 adds a newline
+       to empty here-docs.
+
+2010-09-13  Ralf Wildenhues  <address@hidden>
+
+       docs: document zsh special array $options.
+       * doc/autoconf.texi (Special Shell Variables): Add entry for
+       `options'.
+
+       doc: minor updates.
+       * doc/autoconf.texi (Generic Compiler Characteristics): Use
+       second argument of @uref consistently, for nicer OpenMP link.
+       (Polymorphic Variables): Restore font-lock.
+       (Debugging): Add item for bashdb.
+
+       Document and test AT_CHECK args shell execution environment.
+       * doc/autoconf.texi (Writing Testsuites): Document that COMMANDS
+       is run in a subshell, but RUN-IF-FAIL and RUN-IF-PASS are not.
+       * tests/autotest.at (AT@&address@hidden execution environment): New
+       test.
+       * NEWS: Update.
+
+       autotest: document and test at_status semantics.
+       * doc/autoconf.texi (Writing Testsuites): Document $at_status.
+       * tests/autotest.at (at_status): New test.
+       * NEWS: Update.
+
+       doc: index entries for non-environment, non-output variables.
+       * doc/autoconf.texi: Clarify the meaning of the various variable
+       indices.  Merge variable index `vr' into concept index using
+       syncodeindex.
+       (Configuration Actions, Generic Programs, Generic Functions)
+       (Writing Testsuites): Add index entries for documented shell
+       variables used during in configure and testsuite scripts.
+
 2010-09-12  Fernando Carrijo  <address@hidden>  (tiny change)
 
        docs: fix minor typo and 'See See foo' instances
diff --git a/NEWS b/NEWS
index bfe55e6..43e3621 100644
--- a/NEWS
+++ b/NEWS
@@ -25,6 +25,9 @@ GNU Autoconf NEWS - User visible changes.
 ** Autotest testsuites should not contain long text lines any more, and be
    portable even when very many test groups are used.
 
+** AT_CHECK semantics with respect to the Autotest variable $at_status and
+   shell execution environment of the arguments are documented now.
+
 
 * Major changes in Autoconf 2.67 (2010-07-21) [stable]
   Released by Eric Blake, based on git versions 2.66.*.
diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 97c9eb0..71eefa4 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -46,14 +46,18 @@
 @c with texi2dvi.  But then you wake up an old problem: we use macros
 @c in @defmac etc. where TeX does perform the expansion, but not makeinfo.
 
address@hidden Define an environment variable index.
address@hidden Define an environment variable index, for variables users may set
address@hidden in their environment or on the configure command line.
 @defcodeindex ev
address@hidden Define an output variable index.
address@hidden Define an output variable index, for commonly AC_SUBST'ed 
variables.
 @defcodeindex ov
address@hidden Define a CPP variable index.
address@hidden cv
address@hidden Define a cache variable index.
address@hidden Define a cache variable index, for variables matching *_cv_*.
 @defcodeindex CA
address@hidden Other shell variables not fitting the above categories should be
address@hidden listed in the predefined vrindex, which we merge in the concept 
index.
address@hidden vr cp
address@hidden Define a CPP preprocessor macro index, for #define'd strings.
address@hidden cv
 @c Define an Autoconf macro index that @defmac doesn't write to.
 @defcodeindex AC
 @c Define an Autotest macro index that @defmac doesn't write to.
@@ -2250,25 +2254,30 @@ The variables set during the execution of 
@command{configure} are
 
 @table @code
 @item srcdir
address@hidden srcdir
 The name of the top source directory, assuming that the working
 directory is the top build directory.  This
 is what the @command{configure} option @option{--srcdir} sets.
 
 @item ac_top_srcdir
address@hidden ac_top_srcdir
 The name of the top source directory, assuming that the working
 directory is the current build directory.
 
 @item ac_top_build_prefix
address@hidden ac_top_build_prefix
 The name of the top build directory, assuming that the working
 directory is the current build directory.
 It can be empty, or else ends with a slash, so that you may concatenate
 it.
 
 @item ac_srcdir
address@hidden ac_srcdir
 The name of the corresponding source directory, assuming that the
 working directory is the current build directory.
 
 @item tmp
address@hidden tmp
 The name of a temporary directory within the build tree, which you
 can use if you need to create additional temporary files.  The
 directory is cleaned up when @command{config.status} is done or
@@ -4320,6 +4329,8 @@ the @address@hidden variable.
   @ovar{action-if-not-found}, @dvar{path, $PATH})
 @acindex{PATH_PROGS_FEATURE_CHECK}
 @caindex address@hidden
address@hidden address@hidden
address@hidden address@hidden
 This macro was introduced in Autoconf 2.62.  If @var{variable} is not
 empty, then set the cache variable @address@hidden to
 its value.  Otherwise, check for each program in the blank-separated
@@ -5556,6 +5567,7 @@ Gnulib (@pxref{Gnulib}).
 Specify that @address@hidden must be included in the executables
 to replace a missing or broken implementation of @var{function}.
 
address@hidden ac_objext
 Technically, it adds @address@hidden to the output
 variable @code{LIBOBJS} if it is not already in, and calls
 @code{AC_LIBSOURCE} for @address@hidden  You should not
@@ -7039,7 +7051,7 @@ etc.).
 @ovindex OPENMP_CXXFLAGS
 @ovindex OPENMP_FFLAGS
 @ovindex OPENMP_FCFLAGS
-OpenMP (@url{http://@/www.openmp.org/}) specifies extensions of C, C++,
address@hidden://@/www.openmp.org/, OpenMP} specifies extensions of C, C++,
 and Fortran that simplify optimization of shared memory parallelism,
 which is a common problem on multicore CPUs.
 
@@ -13455,6 +13467,7 @@ results in a script that will output the line 
@samp{hello} three times.
 AC_DEFUN([MY_ACTION],
 [AS_LITERAL_IF([$1],
   [echo "$$1"],
address@hidden $$
   [AS_VAR_COPY([var], [$1])
    echo "$var"],
   [eval 'echo "$'"$1"\"])])
@@ -14884,6 +14897,15 @@ fixed in
 @samp{ksh93g} (1998-04-30) but as of 2006 many operating systems were
 still shipping older versions with the bug.
 
+Empty here-documents are not portable either; with the following code,
address@hidden up to at least version 4.3.10 creates a file with a single
+newline, whereas other shells create an empty file:
+
address@hidden
+cat >file <<EOF
+EOF
address@hidden example
+
 Many shells (including the Bourne shell) implement here-documents
 inefficiently.  In particular, some shells can be extremely inefficient when
 a single statement contains many here-documents.  For instance if your
@@ -16419,6 +16441,11 @@ than 3.1.6-dev-18.  If you are using an older 
@command{zsh}
 and forget to set @env{NULLCMD},
 your script might be suspended waiting for data on its standard input.
 
address@hidden options
address@hidden options
+For @command{zsh} 4.3.10, @env{options} is treated as an associative
+array even after @code{emulate sh}, so it should not be used.
+
 @item PATH_SEPARATOR
 @evindex PATH_SEPARATOR
 On DJGPP systems, the @env{PATH_SEPARATOR} environment
@@ -23969,6 +23996,7 @@ The @var{copyright-notice} shows up in both the head of
 @defmac AT_ARG_OPTION (@var{options}, @var{help-text}, @
   @ovar{action-if-given}, @ovar{action-if-not-given})
 @atindex{ARG_OPTION}
address@hidden address@hidden
 Accept options from the space-separated list @var{options}, a list that
 has leading dashes removed from the options.  Long options will be
 prefixed with @samp{--}, single-character options with @samp{-}.  The
@@ -23982,6 +24010,8 @@ the variable will be set to @samp{:}.  If the user does 
not pass the
 option, or passes @address@hidden, then the variable will be
 set to @samp{false}.
 
address@hidden at_optarg
address@hidden address@hidden
 @var{action-if-given} is run each time the option is encountered; here,
 the variable @code{at_optarg} will be set to @samp{:} or @samp{false} as
 appropriate.  @code{at_optarg} is actually just a copy of
@@ -24000,6 +24030,7 @@ names in order to avoid clashes with future Autotest 
built-in options.
 @defmac AT_ARG_OPTION_ARG (@var{options}, @var{help-text}, @
   @ovar{action-if-given}, @ovar{action-if-not-given})
 @atindex{ARG_OPTION_ARG}
address@hidden address@hidden
 Accept options with arguments from the space-separated list
 @var{options}, a list that has leading dashes removed from the options.
 Long options will be prefixed with @samp{--}, single-character options
@@ -24012,6 +24043,7 @@ If the user passes @address@hidden@var{arg}} or
 @address@hidden @var{arg}} to the @command{testsuite}, the
 variable will be set to @address@hidden
 
address@hidden at_optarg
 @var{action-if-given} is run each time the option is encountered; here,
 the variable @code{at_optarg} will be set to @address@hidden
 @code{at_optarg} is actually just a copy of @address@hidden
@@ -24162,15 +24194,18 @@ be a single shell word that expands into a single 
file name.
   @ovar{stderr}, @ovar{run-if-fail}, @ovar{run-if-pass})
 @atindex{CHECK}
 @atindex{CHECK_UNQUOTED}
-Execute a test by performing given shell @var{commands}.  @var{commands}
-is output as-is, so shell expansions are honored.  These commands
-should normally exit with @var{status}, while producing expected
address@hidden at_status
+Execute a test by performing given shell @var{commands} in a subshell.
address@hidden is output as-is, so shell expansions are honored.  These
+commands should normally exit with @var{status}, while producing expected
 @var{stdout} and @var{stderr} contents.  If @var{commands} exit with
 unexpected status 77, then the rest of the test group is skipped.  If
 @var{commands} exit with unexpected status 99, then the test group is
-immediately failed.  Otherwise, if this test
-fails, run shell commands @var{run-if-fail} or, if this test passes, run shell
-commands @var{run-if-pass}.
+immediately failed.  Otherwise, if this test fails, run shell commands
address@hidden or, if this test passes, run shell commands
address@hidden, both inside the current shell execution environment.
+At the beginning of @var{run-if-fail} and @var{run-if-pass}, the status of
address@hidden is available in the @code{at_status} shell variable.
 
 This macro must be invoked in between @code{AT_SETUP} and @code{AT_CLEANUP}.
 
@@ -25197,6 +25232,10 @@ search for markers like @samp{checking for} a 
particular test in the
 @var{log-file}.
 
 @item
+Alternatively, you might use a shell with debugging capabilities like
address@hidden://bashdb.sourceforge.net/, bashdb}.
+
address@hidden
 When @command{configure} tests produce invalid results for your system,
 it may be necessary to override them:
 
diff --git a/tests/autotest.at b/tests/autotest.at
index fc636e9..ab04dbe 100644
--- a/tests/autotest.at
+++ b/tests/autotest.at
@@ -405,6 +405,52 @@ AT_CHECK_AT_TEST([errexit],
    AT_CHECK([grep "inhibited subsequent" stderr], [], [ignore])],
   [--errexit])
 
+
+AT_CHECK_AT_TEST([at_status],
+  [AT_CHECK([exit $mystatus], [$expected], [], [],
+           [AT_CHECK([echo run-if-fail: $at_status], [], [ignore])],
+           [AT_CHECK([echo run-if-pass: $at_status], [], [ignore])])
+   AT_CLEANUP
+   AT_SETUP([test with nested checks])
+   AT_CHECK([exit $mystatus], [$expected], [], [],
+           [AT_CHECK([exit $mystatus], [$expected], [], [],
+                     [AT_CHECK([echo inner run-if-fail: $at_status], [],
+                               [ignore])])])],
+  [], [], [stdout], [],
+[], [
+AT_CHECK([grep 'inner run-if-fail: 42' stdout], [], [ignore])
+AT_CHECK([$CONFIG_SHELL ./micro-suite -x -v 1 mystatus=0 expected=0], [], 
[stdout])
+AT_CHECK([grep 'run-if-pass: 0' stdout], [], [ignore])
+AT_CHECK([$CONFIG_SHELL ./micro-suite -x -v 1 mystatus=42 expected=0], [], 
[stdout])
+AT_CHECK([grep 'run-if-fail: 42' stdout], [], [ignore])
+AT_CHECK([$CONFIG_SHELL ./micro-suite -x -v 1 mystatus=0 expected=42], [], 
[stdout])
+AT_CHECK([grep 'run-if-fail: 0' stdout], [], [ignore])
+AT_CHECK([$CONFIG_SHELL ./micro-suite -x -v 1 mystatus=42 expected=42], [], 
[stdout])
+AT_CHECK([grep 'run-if-pass: 42' stdout], [], [ignore])
+],
+[-v mystatus=42 expected=1
+])
+
+
+AT_CHECK_AT_TEST([AT@&address@hidden execution environment],
+  [dnl The first test should fail, so we enter RUN-IF-FAIL.
+   AT_CHECK([test "$state" != before], [], [], [],
+           [state=run-if-fail
+            AT_CHECK([:]) dnl need this so we do not bail out at this point.
+            ])
+   dnl This should pass, so we enter RUN-IF-PASS.
+   AT_CHECK([test "$state" = run-if-fail], [], [], [], [],
+           [state=run-if-pass])
+   AT_CHECK([test "$state" = run-if-pass])
+   dnl However, COMMANDS are run inside a subshell, so do not change state.
+   AT_CHECK([state=broken; false], [], [], [],
+           [AT_CHECK([test "$state" = run-if-pass])])
+   AT_CHECK([state=broken], [], [], [], [],
+           [AT_CHECK([test "$state" = run-if-pass])])
+  ],
+  [], [], [], [], [], [], [state=before])
+
+
 AT_CHECK_AT_TEST([unquoted output],
   [m4_define([backtick], [`])
    a=a


hooks/post-receive
-- 
GNU Autoconf source repository