automake: Basics of Installation

1 
1 12.1 Basics of Installation
1 ===========================
1 
1 A file named in a primary is installed by copying the built file into
1 the appropriate directory.  The base name of the file is used when
1 installing.
1 
1      bin_PROGRAMS = hello subdir/goodbye
1 
1    In this example, both ‘hello’ and ‘goodbye’ will be installed in
1 ‘$(bindir)’.
1 
1    Sometimes it is useful to avoid the basename step at install time.
1 For instance, you might have a number of header files in subdirectories
1 of the source tree that are laid out precisely how you want to install
1 them.  In this situation you can use the ‘nobase_’ prefix to suppress
1 the base name step.  For example:
1 
1      nobase_include_HEADERS = stdio.h sys/types.h
1 
1 will install ‘stdio.h’ in ‘$(includedir)’ and ‘types.h’ in
1 ‘$(includedir)/sys’.
1 
1    For most file types, Automake will install multiple files at once,
1 while avoiding command line length issues (⇒Length Limitations).
1 Since some ‘install’ programs will not install the same file twice in
1 one invocation, you may need to ensure that file lists are unique within
1 one variable such as ‘nobase_include_HEADERS’ above.
1 
1    You should not rely on the order in which files listed in one
1 variable are installed.  Likewise, to cater for parallel make, you
1 should not rely on any particular file installation order even among
1 different file types (library dependencies are an exception here).
1