AC-Archive
Autoconf Macro Archive

ac-archive.sf.net: - Project CVS - Download
Macro Index
- AM Support
- C++ Support
- C Support
- Fortran Support
- Java Support
- Cross Compilation
- Installed Packages
- Miscellaneous
- LaTeX Support
- Uncategorized
- archive macros
- adl's macros
- bkorb's macros
- guidod's macros
- latex's macros
- other's macros
- rleigh's macros
- obsoleted macros
- released macros
- search index

Documentation
- Contribute!
- History
- acincludedir m4
- acinclude (tool)
- macro howto
- ax tricks
- maintainers
- License
- Topics

generated...
2007-08-05

(C) 2007 guidod

`acinclude` - the tool

The newest `aclocal` tool is able to recognize macros in a project-local subdirectory. Instead of copying the macro text to aclocal.m4 it will happily just do an m4_include(m4/filename.m4). That makes it easier than the previous `acinclude` tool, which was copying extra autoconf macros from a project-external repository to the project-local acinclude.m4 where it was again copied to aclocal.m4 by `aclocal`. Additionally, it makes it easier to track singular macro updates with a CVS repository since each extra autoconf macro is visible on its own in the project tree.

The `acincludedir` tool works almost exactly the same as `aclocal`, in fact it's implementation borrows some code from it. But instead of populating "aclocal.m4" it will populate a subdirectory "m4/" with autoconf archive macros. The tool will scan your configure.ac for macros with the prefix "AX_" and look for them in the central macro repository of yours. Therefore, if you have been using AX_PREFIX_CONFIG_H then this tool will copy that AC-Archive macro to "m4/ax_prefix_config_h.m4".

Note that you can install all the macros of this AC-Archive website to your local server. Just download the tarball, unpack the archive, and in the unpacked directory (named "ac-archive-2007.0202") call the command "make install-aclocal" which will copy the macros to your servers aclocal dir - usually in /usr/share/aclocal/. However, the AC-Archive tools will always use subdirectories in there - and the `acincludedir` tool will search the subdirectories for macros. Since it does that alphabetically (by directory name) you can also override some macros - the macros definitions do not need to be unique! (hint: the copied macro in m4/* will have a header line saying which macro was copied).