libtool: Install mode

1 
1 4.4 Install mode
1 ================
1 
1 In "install" mode, libtool interprets most of the elements of MODE-ARGS
1 as an installation command beginning with 'cp', or a BSD-compatible
1 'install' program.
1 
1    The following components of MODE-ARGS are treated specially:
1 
1 '-inst-prefix-dir INST-PREFIX-DIR'
1      When installing into a temporary staging area, rather than the
1      final 'prefix', this argument is used to reflect the temporary
1      path, in much the same way 'automake' uses 'DESTDIR'.  For
1      instance, if 'prefix' is '/usr/local', but INST-PREFIX-DIR is
1      '/tmp', then the object will be installed under '/tmp/usr/local/'.
1      If the installed object is a libtool library, then the internal
1      fields of that library will reflect only 'prefix', not
1      INST-PREFIX-DIR:
1 
1           # Directory that this library needs to be installed in:
1           libdir='/usr/local/lib'
1 
1      not
1 
1           # Directory that this library needs to be installed in:
1           libdir='/tmp/usr/local/lib'
1 
1      'inst-prefix' is also used to ensure that if the installed object
1      must be relinked upon installation, that it is relinked against the
1      libraries in INST-PREFIX-DIR/'prefix', not 'prefix'.
1 
1      In truth, this option is not really intended for use when calling
1      libtool directly; it is automatically used when 'libtool
1      --mode=install' calls 'libtool --mode=relink'.  Libtool does this
1      by analyzing the destination path given in the original 'libtool
1      --mode=install' command and comparing it to the expected
1      installation path established during 'libtool --mode=link'.
1 
1      Thus, end-users need change nothing, and 'automake'-style 'make
1      install DESTDIR=/tmp' will Just Work(tm) most of the time.  For
1      systems where fast installation cannot be turned on, relinking may
1      be needed.  In this case, a 'DESTDIR' install will fail.
1 
1      Currently it is not generally possible to install into a temporary
1      staging area that contains needed third-party libraries that are
1      not yet visible at their final location.
1 
1    The rest of the MODE-ARGS are interpreted as arguments to the 'cp' or
1 'install' command.
1 
1    The command is run, and any necessary unprivileged post-installation
1 commands are also completed.
1