
%description
 autoconf extensions that go into /usr/share/aclocal/ directory.
 This dir is searched for macros with the `aclocal` program.
 Installs also the macros found in the autoconf-archive.tar.gz 
 from http://cryp.to/autoconf-archive

%usage
 create a new subdirectory for your own macros that you use in
 your projects and place your m4 files in there, then add this
 directory to the automake-variable in Makefile.am. You get
 a few makefile rules:

 configure - detect actual share/aclocal dir, and the m4 files available
 make dist - create a new snapshot of all m4-files availabe, as a tarball
 make install - install all m4-files in share/aclocal
 make doc - create html-files in the format of cryp.to/autoconf-archive
 make install-doc - install html-files along with an index.html
 make pack - create autoconf-archive.tar.gz from uppercased subdirs
 make unpack - implant a cryp.to/autoconf-archive snapshot
 make rpm - copy tarball to packages/SOURCES and build rpms
 make pack-doc - create html just like the cryp.to/autoconf-archive
 make install-pack-doc - install only the official macro site docs

%detail
 add your m4-files subdir spec to ACLOCALS_ARCHIVE definition at the
 top of the Makefile.am. Other files should be added to EXTRA_DIST.

 The configure script will make a `find . -name \*.m4` so that all
 m4 files are detected and installed, the automake-variable is only
 used for `make dist`, so you can create a subdir with files that
 shall not be distributed in your tarball.

 The primary goal is to help developers to seperate their m4 files
 out from the projects, and make them easily reusable not only
 for a number of projects - a `make dist` snapshot can be easily
 transferred across network boundaries, and a `make install` will
 update the m4-files available to `aclocal`.

 As a hint, you can compile autoconf and install it somewhere
 in your local non-root home-directory paths, the configure
 script of this package will detect the aclocal-dir from the
 `aclocal` program available, and install the m4-files in your
 home's share/aclocal extensions directory.

 last not least, to use it properly, update the version number
 from time to time in the aclocal-archive.spec - the configure
 script will derive the PACKAGE/VERSION defs from there.

%download
 This is a preview, it is only announced to the autoconf mailinglist
 for discussion. The files are currently hosted side by side to
 the http://pfe.sourceforge.net project release-files which is 
 of course not the right place. To download, have a look at
    http://sourceforge.net/project/showfiles.php?group_id=1922
 for fils called "aclocal-archive-*"

%sync support
 There is new maintainer-support to easily sync back with the gnu.org's
 cvs ac-archive (this one is cvs ac-archive-5, so one can checkout both
 cvs trees in parallel side by side) Therefore:   OUTER=../ac-archive
 "make inner" command-list to sync user-macros with global-macros
 "make outer" command-list to sync user-macros with OUTER global-macros
 "make back"  command-list to sync OUTER macros with our global-macros
 "make sync"  command-list to sync global-macros into OUTER (gnu.org)macros
 the command-list can be simply copy-pasted in the terminal to actually
 execute the commands. Usually it is a good idea to "make back" to sync
 the local cvs tree with the (gnu.org) outer cvs tree - then followed
 by "make outer" and "make inner" to push user-macros into their global
 macros. A following check with "make back" or "make sync" should be null.
 The lines with " ##" hint for users macros currently not made global.


