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

[Charles Wilson]

Bob Friesenhahn wrote:

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


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

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

--Chuck

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:27:00 -0000
@@ -1351,12 +1351,43 @@
 @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-dir @var{inst-prefix}
+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} 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}:
+
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}/@var{prefix}, 
+not @var{prefix}.
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.