Autotools

http://en.wikipedia.org/wiki/Autoconf

http://sourceware.org/autobook/autobook/autobook_toc.html

Manuals

• http://www.gnu.org/software/autoconf/manual/index.html
• http://www.gnu.org/software/automake/manual/index.html
• http://www.gnu.org/software/libtool/manual/index.html

Libraries

• includes (for the include directory): include_HEADERS = ...
• library: static lib_LIBRARIES = library.a or dynamic lib_LTLIBRARIES = library.la
• sources (internal C data structures and C++ template classes): library_X_SOURCES = library.h ..., where X = a or la
  • library.h is like a precompiled header (contains common headers and symbols), which is to be included in most of source files of the library (there is no need in real precompiled headers for small projects in C)

For example, http://hcl.ucd.ie/repos/CPM/trunk/MPIBlib/benchmarks/Makefile.am

Configured headers

Configured headers (created from *.h.in) must not be included into the package, that is include_HEADERS or *_SOURCES

• nodist_include_HEADERS = *.h for the configured headers as includes
• nodist_*_SOURCES = *.h or BUILT_SOURCES = *.h for the configured headers as sources

For example, http://hcl.ucd.ie/repos/CPM/trunk/MPIBlib/collectives/Makefile.am

Extra files

To add extra files into package, use EXTRA_DIST = *.

For example, http://hcl.ucd.ie/repos/CPM/trunk/MPIBlib/tools/Makefile.am

Conditional building

• http://www.gnu.org/software/hello/manual/automake/Conditionals.html
• In the source code, use macros

#ifdef SYMBOL
...
#endif