Re: Fix for 'Cygwin List O' Issues' #2: make install DESTDIR=

[Charles Wilson]

Charles Wilson wrote:

> Bob Friesenhahn wrote:
>
> > This patch appears to provide a new libtool option.  As such, the
> > patch should include matching updates to the libtool documentation.

Oops.  Ignore the previous patch, use this one instead.  (I got 
"inst-prefix" and "inst-prefix-dir" wrong earlier.  The *option* is 
--inst-prefix, the variable is inst_prefix_dir.

Also, I added some clarifying notes; this option is not really intended 
for end-users.  It's automatically added to the relink command by 
"libtool --mode=install", and only has effect during the "libtool 
--mode=relink" step -- but end-users aren't supposed to use "libtool 
--mode=relink".  Because there is no section in the help corresponding 
to mode=relink (since end-users...), so I put the docu in the 
mode=install section.

--Chuck

2002-11-01  Charles Wilson  <address@hidden>

        * doc/libtool.texi (Install mode): document new
        -inst-prefix option.

Index: libtool.texi
===================================================================
RCS file: /cvsroot/libtool/libtool/doc/libtool.texi,v
retrieving revision 1.126
diff -u -r1.126 libtool.texi
--- libtool.texi        28 Oct 2002 15:38:37 -0000      1.126
+++ libtool.texi        1 Nov 2002 23:58:04 -0000
@@ -1351,12 +1351,53 @@
 @cindex install mode
 @cindex mode, install
 
-In @dfn{install} mode, libtool interprets @var{mode-args} as an
-installation command beginning with @code{cp}, or a BSD-compatible
address@hidden program.
+In @dfn{install} mode, libtool interprets most of the elements of
address@hidden as an installation command beginning with 
address@hidden, or a BSD-compatible @code{install} program.
 
-The rest of the @var{mode-args} are interpreted as arguments to that
-command.
+The following components of @var{mode-args} are treated specially:
+
address@hidden @samp
address@hidden -inst-prefix @var{inst-prefix-dir}
+When installing into a temporary staging area, rather than the
+final @var{prefix}, this argument is used to reflect the 
+temporary path, in much the same way @code{automake} uses
address@hidden  For instance, if @var{prefix} is @code{/usr/local},
+but @var{inst-prefix-dir} is @code{/tmp}, then the object will be
+installed under @code{/tmp/usr/local/}.  If the installed object 
+is a libtool library, then the internal fields of that library
+will reflect only @var{prefix}, not @var{inst-prefix-dir}:
+
address@hidden
+# Directory that this library needs to be installed in:
+libdir='/usr/local/lib'
address@hidden example
+
+not
+
address@hidden
+# Directory that this library needs to be installed in:
+libdir='/tmp/usr/local/lib'
address@hidden example
+
address@hidden is also used to insure that if the installed 
+object must be relinked upon installation, that it is relinked 
+against the libraries in @var{inst-prefix-dir}/@var{prefix}, 
+not @var{prefix}.
+
+In truth, this option is not really intended for use when calling
+libtool directly; it is automatically used when @code{libtool --mode=install}
+calls @code{libtool --mode=relink}.  Libtool does this by 
+analyzing the destination path given in the original 
address@hidden --mode=install} command and comparing it to the 
+expected installation path established during @code{libtool --mode=link}.
+
+Thus, end-users need change nothing, and @code{automake}-style
address@hidden install DESTDIR=/tmp} will Just Work(tm).
address@hidden table
+
+The rest of the @var{mode-args} are interpreted as arguments to the
address@hidden or @code{install} command.
 
 The command is run, and any necessary unprivileged post-installation
 commands are also completed.