Automake

• Automake
  • v1.5.22
  • v1.7.2
  • v1.10.2

• Makefile.am

top level

item	decsription	examples
EXTRA_DIST	it tells automake that the the list is part of the distribution and must be included when you do make dist	EXTRA_DIST=file
SUBDIRS	simply say which subdirectories to recurse into for more Makefiles and the recursive is depth-first	SUBDIRS=src
DIST_SUBDIRS	It is used in rules that need to recurse in all directories, even those that have been conditionally left out of the build.

assignments

item	decsription	examples
INCLUDES	is globally assigned to make the header files of the libraries accessible to the source code in this directory
LDFLAGS
LDADD
BUILT_SOURCES	All source code files that are to be generated during compile time

testing

item	decsription	examples
check_PROGRAMS	lists executable files that are not compiled with a simple make but only with a make check
TEST	lists executable files which are to be compiled and executed when you run make check	TESTS = $(check_PROGRAMS)

clean

item	decsription	examples
CLEANFILES	it's cleaned when you type ‘make clean’

install

item	decsription	examples
installdir = xxx	which directory to install the program into for “make install”	helloprgdir=../
install_PROGRAMS = prog	lists all the executable files that will be compiled with make and installed with make install under ‘/prefix/bin’	helloprg_PROGRAMS = hello
install_LIBRARIES = lib	lists all the library files that will be compiled with make and installed with make install under ‘/prefix/lib’
noinst_PROGRAMS/LIBRARIES = prog/lib
include_HEADERS	lists public headers present in this directory that you want to install in /prefix/include
install_DATA = data	install files in data installation locations	acloacl_DATA be installed in $(datadir)/aclocal

prog/lib

item	decsription	examples
EXTRA_PROGRAMS = …	1.only built on certain conditions 2.the name is also listed in install_PROGRAMS with configure substition which is defined via AC_SUBST.
prog_LDADD = zzz.o	Extra objects (*.$(OBJEXT)) and libraries (*.a, *.la) can be added to a program yyy	yyy_LDADD = @LIBOBJS@ => link against ‘@LIBOBJS@’
prog/lib_LDFLAGS	for passing program-specific linker flags	prog_LDFLAGS = -L/dir1 -L/dir2 -L/dir3 …
prog_DEPENDENCIES	If prog_DEPENDENCIES is not supplied, it is computed by Automake. The automatically-assigned value is the contents of prog_LDADD with most configure substitutions, -l, -L, -dlopen and -dlpreopen options removed. The configure substitutions that are left in are only ‘$(LIBOBJS)’ and ‘$(ALLOCA)’.
prog_CPPFLAGS	per-program compilation flags
lib_LIBADD = zzz.o	Extra objects can be added to a library yyy
install_LTLIBRARIES	uses Libtool to build libraries
prog/lib_SOURCES = zzz.c	the source files that compose the program/library	hello_SOURCES = hello.c
EXTRA_prog_SOURCES = zzz.c	Any files that are only conditionally built. Then use prog_DEPENDENCIES/prog_LDADD/lib_LIBADD to link conditionly.