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