• Show log

    Commit

  • Hash : 36ee783a
    Author : Stefano Lattarini
    Date : 2012-04-03T22:02:55

    texi: info files can be generated in the builddir
    
    User can now ask info files to be built in the $(builddir), rather than
    the $(srcdir), by specifying the Automake option 'info-in-builddir'.
    This feature was requested by the developers of GCC, GDB, GNU binutils
    and the GNU bfd library.  See the extensive discussion about automake
    bug#11034 for more details.
    
    OK, to be honest, having '.info' files built in the builddir was
    *already* possible, but only using ugly and undocumented hacks involving
    definition of the CLEANFILES and/or DISTCLEANFILES.  For example, the
    binutils project did something like this in the relevant 'Makefile.am':
    
        # Automake 1.9 will only build info files in the objdir if they are
        # mentioned in DISTCLEANFILES.  It doesn't have to be unconditional,
        # though, so we use a bogus condition.
        if GENINSRC_NEVER
        DISTCLEANFILES = binutils.info
        endif
    
    See also the extensive discussion about automake bug#11034; in
    particular, the following messages:
    <http://debbugs.gnu.org/cgi/bugreport.cgi?bug=11034#65>
    <http://debbugs.gnu.org/cgi/bugreport.cgi?bug=11034#80>
    <http://debbugs.gnu.org/cgi/bugreport.cgi?bug=11034#86>
    <http://debbugs.gnu.org/cgi/bugreport.cgi?bug=11034#101>
    
    * lib/Automake/Options.pm (_is_valid_easy_option): Recognize the
    new 'info-in-builddir' option.
    * automake.in (handle_texinfo_helper): If that option is set,
    initialize '$insrc' to '0', so that info files will be generated
    in the builddir.  Adjust comments to match.
    * t/txinfo-builddir.sh: New test.
    * t/list-of-tests.mk: Add it.
    * NEWS: Update.
    * doc/automake.texi: Document the new options.
    
    Signed-off-by: Stefano Lattarini <stefano.lattarini@gmail.com>
    

  • README

  • This is Automake, a Makefile generator.  It aims to be portable and
    to conform to the GNU Coding Standards for Makefile variables and
    targets.
    
    See the INSTALL file for detailed information about how to configure
    and install Automake.
    
    Automake is a Perl script.  The input files are called Makefile.am.
    The output files are called Makefile.in; they are intended for use
    with Autoconf.  Automake requires certain things to be done in your
    configure.ac.
    
    Automake comes with extensive documentation; please refer to it for
    more details about its purpose, features, and usage patterns.
    
    This package also includes the "aclocal" program, whose purpose is
    to generate an 'aclocal.m4' based on the contents of 'configure.ac'.
    It is useful as an extensible, maintainable mechanism for augmenting
    autoconf.  It is intended that other package authors will write m4
    macros which can be automatically used by aclocal.  The documentation
    for aclocal is currently found in the Automake manual.
    
    Automake has a test suite.  Use "make check" to run it.  For more
    information, see the file t/README.
    
    Automake has a page on the web.  See:
    
    	http://www.gnu.org/software/automake/
    
    Automake also has three mailing lists:
    
      * automake@gnu.org
        For general discussions of Automake and its interactions with other
        configuration/portability tools like Autoconf or Libtool.
    
      * bug-automake@gnu.org
        Where to send bug reports and feature requests.
    
      * automake-patches@gnu.org
        Where to send patches, and discuss the automake development process
        and the  design of new features.
    
    To obtain more information about these list, or to subscribe to them,
    refer to <http://www.gnu.org/software/automake/#mailinglists>
    
    New releases are announced to autotools-announce@gnu.org.  If you want to
    be informed, subscribe to that list by following the instructions at
    <http://lists.gnu.org/mailman/listinfo/autotools-announce>.
    
    For any copyright year range specified as YYYY-ZZZZ in this package,
    that the range specifies every single year in that closed interval.
    
    -----
    
    Copyright (C) 1994-2012 Free Software Foundation, Inc.
    
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2, or (at your option)
    any later version.
    
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.
    
    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.