automake: Libtool Flags

1 
1 8.3.7 ‘_LIBADD’, ‘_LDFLAGS’, and ‘_LIBTOOLFLAGS’
1 ------------------------------------------------
1 
1 As shown in previous sections, the ‘LIBRARY_LIBADD’ variable should be
1 used to list extra libtool objects (‘.lo’ files) or libtool libraries
1 (‘.la’) to add to LIBRARY.
1 
1    The ‘LIBRARY_LDFLAGS’ variable is the place to list additional
1 libtool linking flags, such as ‘-version-info’, ‘-static’, and a lot
1 more.  ⇒Link mode (libtool)Link mode.
1 
1    The ‘libtool’ command has two kinds of options: mode-specific options
1 and generic options.  Mode-specific options such as the aforementioned
1 linking flags should be lumped with the other flags passed to the tool
1 invoked by ‘libtool’ (hence the use of ‘LIBRARY_LDFLAGS’ for libtool
1 linking flags).  Generic options include ‘--tag=TAG’ and ‘--silent’
1 (⇒Invoking ‘libtool’ (libtool)Invoking libtool. for more options)
1 should appear before the mode selection on the command line; in
1 ‘Makefile.am’s they should be listed in the ‘LIBRARY_LIBTOOLFLAGS’
1 variable.
1 
1    If ‘LIBRARY_LIBTOOLFLAGS’ is not defined, then the variable
1 ‘AM_LIBTOOLFLAGS’ is used instead.
1 
1    These flags are passed to libtool after the ‘--tag=TAG’ option
1 computed by Automake (if any), so ‘LIBRARY_LIBTOOLFLAGS’ (or
1 ‘AM_LIBTOOLFLAGS’) is a good place to override or supplement the
1 ‘--tag=TAG’ setting.
1 
1    The libtool rules also use a ‘LIBTOOLFLAGS’ variable that should not
11 be set in ‘Makefile.am’: this is a user variable (⇒Flag Variables
 Ordering.  It allows users to run ‘make LIBTOOLFLAGS=--silent’, for
1 instance.  Note that the verbosity of ‘libtool’ can also be influenced
11 by the Automake support for silent rules (⇒Automake Silent
 Rules).
1