• Show log

    Commit

  • Hash : 44da9cbd
    Author : Stefano Lattarini
    Date : 2011-12-27T14:55:41

    docs: "aclocal --install -I /abs/dir" actually copies files
    
    This change is for automake bug#8407.
    
    In the past, there had been some debate and confusion about
    whether "aclocal --install" should copy third-party .m4 files
    in the first directory passed to the `-I' option even when
    such directory was given as an absolute path, or whether it
    was better to do so only for directories specified with a
    relative path.
    
    The rationale for this latter behaviour was that, before the
    existence of the `ACLOCAL_PATH' variable, the only way (a poor
    way, I might add) for a common user to extend the search path
    of a system-wide installation of aclocal was to export something
    like ACLOCAL="aclocal -I /my/extra/macros" in the environment.
    Today, the correct way to proceed is undoubtedly through the
    use of ACLOCAL_PATH, so we can settle the question once and for
    all, and start verifying the correct behaviour of `-I' with a
    new test.
    
    * tests/aclocal-install-absdir.test: New test.
    * tests/Makefile.am (TESTS): Add it.
    * doc/automake.texi (aclocal Options): Be more explicit about
    this part of `--install' semantics.
    

  • README

  • This is Automake, a Makefile generator.  It was inspired by the 4.4BSD
    make and include files, but aims to be portable and to conform to the
    GNU Coding Standards for Makefile variables and targets.
    
    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.
    
    Variable assignment lines in Makefile.am pull in defaults from various
    little *.am files.
    
    To use Automake, replace your Makefile.in files with Makefile.am
    files.  Read the documentation to see what to do.
    
    This package also includes the "aclocal" program.  aclocal is a
    program 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.
    
    Automake has a test suite.  Use
    
    	make check
    
    to run it.  For more information, see the file tests/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>.
    
    -----
    
    Copyright (C) 1994, 1995, 1996, 1997, 1998, 2001, 2003, 2008, 2009, 2011
      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/>.