xref: /openbsd-src/usr.bin/libtool/libtool.1 (revision fac11229356f8a8603a66db25ab2754311592fd1)
1*fac11229Sjmc.\"	$OpenBSD: libtool.1,v 1.3 2017/01/02 09:21:56 jmc Exp $
2dd9b5fdeSespie.\"
3dd9b5fdeSespie.\" Copyright (c) 2012 Marc Espie <espie@openbsd.org>
4dd9b5fdeSespie.\"
5dd9b5fdeSespie.\" Permission to use, copy, modify, and distribute this software for any
6dd9b5fdeSespie.\" purpose with or without fee is hereby granted, provided that the above
7dd9b5fdeSespie.\" copyright notice and this permission notice appear in all copies.
8dd9b5fdeSespie.\"
9dd9b5fdeSespie.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10dd9b5fdeSespie.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11dd9b5fdeSespie.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12dd9b5fdeSespie.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13dd9b5fdeSespie.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14dd9b5fdeSespie.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15dd9b5fdeSespie.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16dd9b5fdeSespie.\"
17*fac11229Sjmc.Dd $Mdocdate: January 2 2017 $
18dd9b5fdeSespie.Dt LIBTOOL 1
19dd9b5fdeSespie.Os
20dd9b5fdeSespie.Sh NAME
21dd9b5fdeSespie.Nm libtool
22dd9b5fdeSespie.Nd compile and link complex libraries
23dd9b5fdeSespie.Sh DESCRIPTION
24dd9b5fdeSespie.Nm
25dd9b5fdeSespieis supposed to be a drop-in replacement for the eponymous GNU project.
26d9a5f0c7SzhukThe following differences in behaviour with GNU Libtool are intentional:
27d9a5f0c7Szhuk.Bl -bullet
28d9a5f0c7Szhuk.It
29d9a5f0c7SzhukRelative
30*fac11229Sjmc.Fl L
31d9a5f0c7Szhukpaths are put before absolute ones.
32*fac11229SjmcThis fixes many (but not all, unfortunately) issues when software
33*fac11229Sjmclinks to libraries already installed instead of those just built because,
34*fac11229Sjmcfor example,
35*fac11229Sjmc.Qq -L/usr/local/lib
36d9a5f0c7Szhukcomes before
37*fac11229Sjmc.Qq -L../libfoo .
38d9a5f0c7Szhuk.It
39d9a5f0c7SzhukExtra (duplicate)
40*fac11229Sjmc.Fl L
41d9a5f0c7Szhukand
42*fac11229Sjmc.Fl l
43*fac11229Sjmcitems are stripped from the link command line.
44d9a5f0c7Szhuk.It
45d9a5f0c7SzhukWhen both
46*fac11229Sjmc.Qq -lstdc++
47d9a5f0c7Szhukand
48*fac11229Sjmc.Qq -lestdc++
49*fac11229Sjmcare encountered in the link command line, only the latter is kept.
50d9a5f0c7Szhuk.El
51