libtool
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[PATCH] small fix for the libtool manual


From: Stefan Sperling
Subject: [PATCH] small fix for the libtool manual
Date: Wed, 28 Nov 2007 17:13:39 +0100
User-agent: Mutt/1.5.17 (2007-11-01)

Hello,

the "Using libtool" section in the manual starts talking about
a "wrapper script" in one paragraph without explaining beforehand
what that script is.

It is actually explained right in the following paragraph.

But I still found myself confused and tried to figure out what
"wrapper script" the author was talking about, before I finally
decided to simply accept that the wrapper script was a mystery,
read on and then stumbled over the answer.

This is not how documentation should work.

The following patch simply reverts the order of those two
paragraphs to fix this.

Thanks.


--- manual.html.orig    Wed Nov 28 16:53:01 2007
+++ manual.html Wed Nov 28 16:54:27 2007
@@ -726,16 +726,16 @@
    <p>Note that libtool added the necessary run-time path flag, as well as
 `<samp><span class="samp">-lm</span></samp>', the library libhello.la depended 
upon.  Nice, huh?
 
+   <p><a name="index-wrapper-scripts-for-programs-32"></a><a 
name="index-program-wrapper-scripts-33"></a>Notice that the executable, 
<code>hell</code>, was actually created in the
+<samp><span class="file">.libs</span></samp> subdirectory.  Then, a wrapper 
script was created
+in the current directory.
+
    <p>Since libtool created a wrapper script, you should use libtool to
 install it and debug it too.  However, since the program does not depend
 on any uninstalled libtool library, it is probably usable even without
 the wrapper script.  Libtool could probably be made smarter to avoid the
 creation of the wrapper script in this case, but this is left as an
 exercise for the reader.
-
-   <p><a name="index-wrapper-scripts-for-programs-32"></a><a 
name="index-program-wrapper-scripts-33"></a>Notice that the executable, 
<code>hell</code>, was actually created in the
-<samp><span class="file">.libs</span></samp> subdirectory.  Then, a wrapper 
script was created
-in the current directory.
 
    <p>On NetBSD 1.2, libtool encodes the installation directory of
 <samp><span class="file">libhello</span></samp>, by using the `<samp><span 
class="samp">-R/usr/local/lib</span></samp>' compiler flag. 

-- 
Stefan Sperling <address@hidden>                 Software Developer
elego Software Solutions GmbH                            HRB 77719
Gustav-Meyer-Allee 25, Gebaeude 12        Tel:  +49 30 23 45 86 96 
13355 Berlin                              Fax:  +49 30 23 45 86 95
http://www.elego.de                 Geschaeftsfuehrer: Olaf Wagner

Attachment: pgpw4WmHjGk5s.pgp
Description: PGP signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]