[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Fix for 'Cygwin List O' Issues' #2: make install DESTDIR=
From: |
Charles Wilson |
Subject: |
Re: Fix for 'Cygwin List O' Issues' #2: make install DESTDIR= |
Date: |
Fri, 01 Nov 2002 18:59:26 -0500 |
User-agent: |
Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:0.9.4) Gecko/20011019 Netscape6/6.2 |
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.