CRUX-ARM : Home

Home :: Documentation :: Download :: Development :: Community :: Ports :: Packages :: Bugs :: Links :: About :: Donors
8780a98089c8ba7fa82c871e46897177ae1f7740
[crossrootfs.git] / libtool / libtool.1
1 .TH LIBTOOL 1 "August 2003" "Library Support" "User Manuals"
2 .SH NAME
3 libtool \- Provide generalized library-building support services.
4 .SH SYNOPSIS
5 .B libtool
6 .BI [ OPTION ] ...
7 .BI [ MODE\-ARG ] ...
8 .SH "DESCRIPTION"
9 The `libtool' program provides a standard way to generate both static
10 and shared libraries. It hides the complexities of platform\-specific
11 library generation behind an interface that is the same across all
12 platforms supported by libtool.
13 .SH "OPTIONS"
14 libtool accepts the following options:
15 .TP
16 .B \-\-config
17 Display libtool configuration variables and exit.
18 .TP
19 .B \-\-debug
20 Dump a trace of shell script execution to standard output. This
21 produces a lot of output, so you may wish to pipe it to `less' (or
22 `more') or redirect to a file.
23 .TP
24 .BI \-n | \-\-dry-run
25 Don't create, modify, or delete any files, just show what commands
26 would be executed by `libtool'.
27 .TP
28 .B \-\-features
29 Display basic configuration options. This provides a way for packages
30 to determine whether shared or static libraries will be built.
31 .TP
32 .B \-\-finish
33 Same as
34 .BR \-\-mode=finish .
35 .TP
36 .B \-\-help
37 Display a help message and exit. If
38 .BI \-\-mode= MODE
39 is specified, then detailed help for
40 .I MODE
41 is displayed.
42 .TP
43 .BI \-\-mode= MODE
44 Use
45 .I MODE
46 as the operation mode. By default, the operation mode is inferred
47 from the
48 .IR MODE\-ARGS .
49
50 If
51 .I MODE
52 is specified, it must be one of the following:
53 .IP
54 .B clean
55 Remove files from the build directory
56 .IP
57 .B compile
58 Compile a source file into a `libtool' object.
59 .IP
60 .B execute
61 Automatically set the library path, then run a program.
62 .IP
63 .B finish
64 Complete the installation of libtool libraries.
65 .IP
66 .B install
67 Install libraries or executables.
68 .IP
69 .B link
70 Create a library or an executable.
71 .IP
72 .B uninstall
73 Remove libraries from an installed directory.
74 .TP
75 .B \-\-quiet
76 Same as `\-\-silent'.
77 .TP
78 .B \-\-silent
79 Don't print informational messages.
80 .TP
81 .B \-\-tag=TAG
82 Use configuration variables from tag
83 .I TAG
84 .TP
85 .B \-\-version
86 Print version information.
87 .P
88 The
89 .I MODE\-ARGS
90 are a variable number of arguments, depending on the selected
91 operation mode. In general, each
92 .I MODE\-ARG
93 is interpreted by programs libtool invokes, rather than libtool itself.
94 .SH "SEE ALSO"
95 .BR libtoolize (1),
96 .BR automake (1)
97 .br
98 `libtool', `libtoolize' and `automake' are fully documented via the
99 Info system.
100 .SH AUTHOR
101 This manual page was created by Ossama Othman <ossama@debian.org>. It
102 is based on the "Invoking Libtool" menu entry in the `libtool' TEXINFO
103 documentation, and the output from the
104 .B \-\-help
105 option. It was updated for Libtool 1.5 by
106 Scott James Remnant <scott@netsplit.com>.