[Automake-commit] [SCM] GNU Automake branch, branch-1-10, updated. Release-1-10-1-29-gc4b1e8c

[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 Automake".

http://git.sv.gnu.org/gitweb/?p=automake.git;a=commitdiff;h=c4b1e8c39d21584a1a0960e174081bb7403dfb28

The branch, branch-1-10 has been updated
       via  c4b1e8c39d21584a1a0960e174081bb7403dfb28 (commit)
      from  b784d884bfaa172753a64245d6bcb41deffdc8d5 (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 c4b1e8c39d21584a1a0960e174081bb7403dfb28
Author: Ralf Wildenhues <address@hidden>
Date:   Tue Aug 19 23:03:57 2008 +0200

    Fix maintainer-check failure.
    
    * tests/missing6.test: Use 'rm -f'.
    
    Signed-off-by: Ralf Wildenhues <address@hidden>

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

Summary of changes:
 ChangeLog           |    5 ++
 doc/automake.texi   |  151 ++++++++++++++++++++++++++++++++++++++++++++-------
 tests/missing6.test |    2 +-
 3 files changed, 137 insertions(+), 21 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index b5911ba..005d62b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2008-08-19  Ralf Wildenhues  <address@hidden>
+
+       Fix maintainer-check failure.
+       * tests/missing6.test: Use 'rm -f'.
+
 2008-08-19  Reuben Thomas <address@hidden>  (tiny patch)
 
        * doc/automake.texi (Flag Variables Ordering, Per-Object Flags):
diff --git a/doc/automake.texi b/doc/automake.texi
index 04c1816..265a3f8 100644
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -7,6 +7,14 @@
 
 @include version.texi
 
address@hidden @ovar(ARG, DEFAULT)
address@hidden -------------------
address@hidden The ARG is an optional argument.  To be used for macro arguments 
in
address@hidden their documentation (@defmac).
address@hidden ovar{varname}
address@hidden@address@hidden
address@hidden macro
+
 @copying
 
 This manual is for @acronym{GNU} Automake (version @value{VERSION},
@@ -1034,7 +1042,8 @@ options.
 @cindex Programs, renaming during installation
 
 The GNU Build System provides means to automatically rename
-executables before they are installed.  This is especially convenient
+executables and manpages before they are installed (@pxref{Man pages}).
+This is especially convenient
 when installing a GNU package on a system that already has a
 proprietary implementation you do not want to overwrite.  For instance,
 you may want to install GNU @command{tar} as @command{gtar} so you can
@@ -1504,7 +1513,7 @@ AC_OUTPUT
 @end example
 
 This file is read by both @command{autoconf} (to create
address@hidden) and @command{automake} (to create the various
address@hidden) and @command{automake} (to create the various
 @file{Makefile.in}s).  It contains a series of M4 macros that will be
 expanded as shell code to finally form the @file{configure} script.
 We will not elaborate on the syntax of this file, because the Autoconf
@@ -1860,13 +1869,15 @@ the @dfn{primary}.  For instance, the primary 
@code{PROGRAMS} holds a
 list of programs that are to be compiled and linked.
 @vindex PROGRAMS
 
address@hidden @code{pkglibdir}, defined
address@hidden @code{pkgincludedir}, defined
 @cindex @code{pkgdatadir}, defined
address@hidden @code{pkgincludedir}, defined
address@hidden @code{pkglibdir}, defined
address@hidden @code{pkglibexecdir}, defined
 
address@hidden pkglibdir
address@hidden pkgincludedir
 @vindex pkgdatadir
address@hidden pkgincludedir
address@hidden pkglibdir
address@hidden pkglibexecdir
 
 @cindex @code{PACKAGE}, directory
 A different set of names is used to decide where the built objects
@@ -1874,9 +1885,9 @@ should be installed.  These names are prefixes to the 
primary, and they
 indicate which standard directory should be used as the installation
 directory.  The standard directory names are given in the GNU standards
 (@pxref{Directory Variables, , , standards, The GNU Coding Standards}).
-Automake extends this list with @code{pkglibdir}, @code{pkgincludedir},
-and @code{pkgdatadir}; these are the same as the address@hidden
-versions, but with @samp{$(PACKAGE)} appended.  For instance,
+Automake extends this list with @code{pkgdatadir}, @code{pkgincludedir},
address@hidden, and @code{pkglibexecdir}; these are the same as the
address@hidden versions, but with @samp{$(PACKAGE)} appended.  For instance,
 @code{pkglibdir} is defined as @samp{$(libdir)/$(PACKAGE)}.
 
 @cindex @code{EXTRA_}, prepending
@@ -1962,8 +1973,9 @@ The current primary names are @samp{PROGRAMS}, 
@samp{LIBRARIES},
 
 Some primaries also allow additional prefixes that control other
 aspects of @command{automake}'s behavior.  The currently defined prefixes
-are @samp{dist_}, @samp{nodist_}, and @samp{nobase_}.  These prefixes
-are explained later (@pxref{Program and Library Variables}).
+are @samp{dist_}, @samp{nodist_}, @samp{nobase_}, and @samp{notrans_}.
+These prefixes are explained later (@pxref{Program and Library Variables})
+(@pxref{Man pages}).
 
 
 @node Canonicalization
@@ -2650,6 +2662,10 @@ to check whether @file{Makefile.am} exists.  (In the 
very hairy case
 that your setup requires such use of variables, you will have to tell
 Automake which @file{Makefile.in}s to generate on the command-line.)
 
+It is possible to let @command{automake} emit conditional rules for
address@hidden with the help of @code{AM_COND_IF}
+(@pxref{Optional}).
+
 To summarize:
 @itemize @bullet
 @item
@@ -2776,6 +2792,11 @@ This is required for programs and shared libraries that 
are a mixture of
 languages that include Fortran 77 (@pxref{Mixing Fortran 77 With C and
 C++}).  @xref{Macros, , Autoconf macros supplied with Automake}.
 
address@hidden AC_FC_SRCEXT
+Automake will add the flags computed by @code{AC_FC_SRCEXT} to compilation
+of files with the respective source extension (@pxref{Fortran Compiler, ,
+Fortran Compiler Characteristics, autoconf, The Autoconf Manual}).
+
 @item AC_PROG_FC
 This is required if any Fortran 90/95 source is included.  This macro is
 distributed with Autoconf version 2.58 and later.  @xref{Particular
@@ -2822,6 +2843,15 @@ you can use these variables in any @file{Makefile.am} if
 This is required when using the obsolete de-ANSI-fication feature; see
 @ref{ANSI}.
 
address@hidden AM_CONDITIONAL
+This introduces an Automake conditional (@pxref{Conditionals}).
+
address@hidden AM_COND_IF
+This macro allows @code{automake} to detect subsequent access within
address@hidden to a conditional previously introduced with
address@hidden, thus enabling conditional @code{AC_CONFIG_FILES}
+(@pxref{Conditionals}).
+
 @item AM_GNU_GETTEXT
 This macro is required for packages that use GNU gettext
 (@pxref{gettext}).  It is distributed with gettext.  If Automake sees
@@ -4389,9 +4419,9 @@ programs.  Most of the comments about these also apply to 
libraries
 In a directory containing source that gets built into a program (as
 opposed to a library or a script), the @code{PROGRAMS} primary is used.
 Programs can be installed in @code{bindir}, @code{sbindir},
address@hidden, @code{pkglibdir}, or not at all (@code{noinst_}).
-They can also be built only for @samp{make check}, in which case the
-prefix is @samp{check_}.
address@hidden, @code{pkglibdir}, @code{pkglibexecdir}, or not at all
+(@code{noinst_}).  They can also be built only for @samp{make check}, in
+which case the prefix is @samp{check_}.
 
 For instance:
 
@@ -6301,7 +6331,7 @@ trick with @address@hidden
 @cindex Fortran 9x support
 @cindex Support for Fortran 9x
 
-Automake includes full support for Fortran 9x.
+Automake includes support for Fortran 9x.
 
 Any package including Fortran 9x code must define the output variable
 @code{FC} in @file{configure.ac}; the simplest way to do this is to use
@@ -6340,14 +6370,24 @@ library.
 @comment  node-name,  next,  previous,  up
 @subsection Compiling Fortran 9x Files
 
address@hidden is made automatically from @file{N.f90} or @file{N.f95}
address@hidden@var{N}.o} is made automatically from @address@hidden,
address@hidden@var{N}.f95}, @address@hidden, or @address@hidden
 by running the Fortran 9x compiler.  The precise command used
 is as follows:
 
 @table @file
 
address@hidden .f9x
address@hidden(FC) -c $(AM_FCFLAGS) $(FCFLAGS)}
address@hidden .f90
address@hidden(FC) $(AM_FCFLAGS) $(FCFLAGS) -c $(FCFLAGS_f90) $<}
+
address@hidden .f95
address@hidden(FC) $(AM_FCFLAGS) $(FCFLAGS) -c $(FCFLAGS_f95) $<}
+
address@hidden .f03
address@hidden(FC) $(AM_FCFLAGS) $(FCFLAGS) -c $(FCFLAGS_f03) $<}
+
address@hidden .f08
address@hidden(FC) $(AM_FCFLAGS) $(FCFLAGS) -c $(FCFLAGS_f08) $<}
 
 @end table
 
@@ -7254,7 +7294,7 @@ files in your @file{Makefile.am}, depending where you 
want your files
 installed (see the definitions of @code{pythondir} and
 @code{pkgpythondir} below).
 
address@hidden AM_PATH_PYTHON (address@hidden, address@hidden, address@hidden)
address@hidden AM_PATH_PYTHON (@ovar{VERSION}, @ovar{ACTION-IF-FOUND}, 
@ovar{ACTION-IF-NOT-FOUND})
 
 Search for a Python interpreter on the system.  This macro takes three
 optional arguments.  The first argument, if present, is the minimum
@@ -7633,6 +7673,32 @@ dist_man_MANS = cpio.1 mt.1
 The @code{nobase_} prefix is meaningless for man pages and is
 disallowed.
 
address@hidden notrans_
address@hidden @code{notrans_} prefix
address@hidden Man page renaming, avoiding
address@hidden Avoiding man page renaming
+
+Executables and manpages may be renamed upon installation
+(@pxref{Renaming}).  For manpages this can be avoided by use of the
address@hidden prefix.  For instance, suppose an executable @samp{foo}
+allowing to access a library function @samp{foo} from the command line.
+The way to avoid renaming of the @file{foo.3} manpage is:
+
address@hidden
+man_MANS = foo.1
+notrans_man_MANS = foo.3
address@hidden example
+
address@hidden @code{notrans_} and @code{dist_} or @code{nodist_}
address@hidden @code{dist_} and @code{notrans_}
address@hidden @code{nodist_} and @code{notrans_}
+
address@hidden must be specified first when used in conjunction with
+either @samp{dist_} or @samp{nodist_} (@pxref{Dist}).  For instance:
+
address@hidden
+notrans_dist_man3_MANS = bar.3
address@hidden example
 
 @node Install
 @chapter What Gets Installed
@@ -8118,6 +8184,12 @@ work when building in a separate directory (@pxref{Build 
Directories,
 , Build Directories , autoconf, The Autoconf Manual}), and in
 particular for the @code{distcheck} rule (@pxref{Dist}).
 
+For each of the @code{TESTS}, the result of execution is printed along
+with the test name, where @code{PASS} denotes a successful test,
address@hidden denotes a failed test, @code{XFAIL} an expected failure,
address@hidden an unexpected pass for a test that is supposed to fail,
+and @code{SKIP} denotes a skipped test.
+
 @cindex Exit status 77, special interpretation
 
 The number of failures will be printed at the end of the run.  If a
@@ -8125,6 +8197,14 @@ given test program exits with a status of 77, then its 
result is ignored
 in the final count.  This feature allows non-portable tests to be
 ignored in environments where they don't make sense.
 
address@hidden AM_COLOR_TESTS
+If the Automake option @code{color-tests} is used (@pxref{Options})
+and standard output is connected to a capable terminal, then the test
+results and the summary are colored appropriately.  The user can disable
+colored output by setting the @command{make} variable
address@hidden, or force colored output even without a connecting
+terminal with @samp{AM_COLOR_TESTS=always}.
+
 @vindex TESTS
 @vindex TESTS_ENVIRONMENT
 The variable @code{TESTS_ENVIRONMENT} can be used to set environment
@@ -8356,6 +8436,12 @@ currently does not check this).
 Cause @samp{make dist} to fail unless the current version number appears
 in the first few lines of the @file{NEWS} file.
 
address@hidden @option{color-tests}
address@hidden Option, @option{color-tests}
address@hidden color-tests
+Cause output of the simple test suite (@pxref{Tests}) to be
+colorized on capable terminals.
+
 @item @option{dejagnu}
 @cindex Option, @option{dejagnu}
 @opindex dejagnu
@@ -8868,6 +8954,32 @@ The @code{else} branch of the above two examples could 
be omitted,
 since assigning the empty string to an otherwise undefined variable
 makes no difference.
 
address@hidden AM_COND_IF
+In order to allow access to the condition registered by
address@hidden inside @file{configure.ac}, and to allow
+conditional @code{AC_CONFIG_FILES}, @code{AM_COND_IF} may be used:
+
address@hidden AM_COND_IF (@var{conditional}, @ovar{if-true}, @ovar{if-false})
+If @var{conditional} is fulfilled, execute @var{if-true}, otherwise
+execute @var{if-false}.  If either branch contains @code{AC_CONFIG_FILES},
+it will cause @command{automake} to output the rules for the respective
+files only for the given condition.
address@hidden defmac
+
address@hidden macros may be nested when m4 quotation is used
+properly (@pxref{M4 Quotation, ,, autoconf, The Autoconf Manual}).
+
address@hidden Example conditional @code{AC_CONFIG_FILES}
address@hidden @code{AC_CONFIG_FILES}, conditional
+
+Here is an example of how to define a conditional config file:
+
address@hidden
+AM_CONDITIONAL([SHELL_WRAPPER], [test "x$with_wrapper" = xtrue])
+AM_COND_IF([SHELL_WRAPPER],
+           [AC_CONFIG_FILES([wrapper:wrapper.in])])
address@hidden example
+
 @unnumberedsec Portability
 
 Note that conditionals in Automake are not the same as conditionals in
@@ -11962,7 +12074,6 @@ The number of test cases in the test suite.
 @item 2005-02-13 @tab 1.9.5  @tab 7523 @tab 719 @tab 7859 @tab 3373 (40) @tab 
1453 (32) @tab 142 @tab 562
 @item 2005-07-10 @tab 1.9.6  @tab 7539 @tab 699 @tab 7867 @tab 3400 (40) @tab 
1453 (32) @tab 144 @tab 570
 @item 2006-10-15 @tab 1.10   @tab 7859 @tab 1072 @tab 8024 @tab 3512 (40) @tab 
1496 (34) @tab 172 @tab 604
address@hidden 2008-01-21 @tab 1.10.1 @tab 7870 @tab 1089 @tab 8025 @tab 3584 
(41) @tab 1499 (34) @tab 173 @tab 617
 @end multitable
 
 
diff --git a/tests/missing6.test b/tests/missing6.test
index 56c6047..f65e2ab 100755
--- a/tests/missing6.test
+++ b/tests/missing6.test
@@ -26,7 +26,7 @@ set -e
   cat configure.in
   echo AC_OUTPUT
 } >configure.ac
-rm configure.in
+rm -f configure.in
 
 touch Makefile.am
 


hooks/post-receive
--
GNU Automake