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; you can put ‘.’ into ‘SUBDIRS’ to control when the objects in the current directory are built, relative to the objects in the subdirectories.	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. If SUBDIRS is defined conditionally using Automake conditionals, Automake will define DIST_SUBDIRS automatically from the possible values of SUBDIRS in all conditions.

assignments

• AutoGen
  • The Makefile.in file is sometimes big, and can be generated by automake from a Makefile.am file. Some Makefile.in files (used to generate Makefile in the build tree) are generated by autogen from Makefile.tpl and Makefile.def files. Autogen is a (GUILE scriptable) tool designed to simplify the creation and maintenance of programs that contain large amounts of repetitious text.

item	decsription	examples
INCLUDES	This variable is globally assigned to make the header files of the libraries accessible to the source code in this directory
AM_CFLAGS/AM_CXXFLAGS
AM_LDFLAGS	This variable is used to specify specific linker flags.
LDADD	This variable is used to specify additional objects or libraries to link with.
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	the directory to install the program into for “make install”	bindir
install_PROGRAMS = prog	lists all the executable files that will be compiled with make and installed with make install under installdir	bin_PROGRAMS, libexec_PROGRAMS
EXTRA_PROGRAMS = …	1.only built on certain conditions 2.the name is also listed in bin/libexec_PROGRAMS with configure substition which is defined via AC_SUBST.
install_LIBRARIES = lib	list all the library files that will be compiled with make and installed with make install under installdir	lib_LIBRARIES
noinst_PROGRAMS/LIBRARIES = prog/lib	create all the executable or library files, but not install them
install_DATA = data	a number of files which are installed verbatim in installdir)
install_HEADERS	These are separate from DATA macros because this allows for extra error checking in some cases.	include_HEADERS
install_SCRIPTS	These are different from DATA because they are installed with different permissions and because they have the program name transform applied to them (e.g., the ‘—program-transform-name’ argument to configure).
man_MANS	man_MANS can be used when numeric suffixes are already in place	man_MANS = foo.1 bar.2 quux.3n
man1_MANS, man2_MANS, etc	They can be used to force renaming at install time. This renaming is skipped if the suffix already begins with the correct number.

prog/lib

item	decsription	examples
prog_LDADD = zzz.o	Extra objects (*.$(OBJEXT)) and libraries (*.a, *.la) can be added to a program prog. It is appropriate for passing -l, -L, -dlopen and -dlpreopen. This is only used by programs and shared libraries.
lib_LIBADD = zzz.o	Like ‘_LDADD’, but used for static libraries and not programs.
prog/lib_LDFLAGS	for passing program-specific linker flags; this is separate from ‘_LDADD’ to allow ‘_DEPENDENCIES’ to be auto-computed.
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
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.