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 <[EMAIL PROTECTED]> 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
pgp60QXyNIWlJ.pgp
Description: PGP signature
_______________________________________________ http://lists.gnu.org/mailman/listinfo/libtool