core/libtool/libtool.1
2006-02-23 15:26:10 +00:00

92 lines
2.3 KiB
Groff

.TH LIBTOOL 1 "OCTOBER 1999" "Library Support" "User Manuals"
.SH NAME
libtool \- generic library support script
.SH SYNOPSIS
.B libtool
.BI [ OPTION... ]
.BI [ MODE\-ARG... ]
.SH "DESCRIPTION"
The `libtool' program provides a standard way to generate both static
and shared libraries. It hides the complexities of platform\-specific
library generation behind an interface that is the same across all
platforms supported by libtool.
.SH "OPTIONS"
libtool accepts the following options:
.TP
.B \-\-config
Display libtool configuration variables and exit.
.TP
.B \-\-debug
Dump a trace of shell script execution to standard output. This
produces a lot of output, so you may wish to pipe it to `less' (or
`more') or redirect to a file.
.TP
.BI \-n | \-\-dry-run
Don't create, modify, or delete any files, just show what commands
would be executed by `libtool'.
.TP
.B \-\-features
Display basic configuration options. This provides a way for packages
to determine whether shared or static libraries will be built.
.TP
.B \-\-finish
Same as
.BR \-\-mode=finish .
.TP
.B \-\-help
Display a help message and exit. If
.BI \-\-mode= MODE
is specified, then detailed help for
.I MODE
is displayed.
.TP
.BI \-\-mode= MODE
Use
.I MODE
as the operation mode. By default, the operation mode is inferred
from the
.IR MODE\-ARGS .
If
.I MODE
is specified, it must be one of the following:
.IP
.B compile
Compile a source file into a `libtool' object.
.IP
.B execute
Automatically set the library path so that another program can use
uninstalled libtool\-generated programs or libraries.
.IP
.B finish
Complete the installation of libtool libraries on the system.
.IP
.B install
Install libraries or executables.
.IP
.B link
Create a library or an executable.
.IP
.B uninstall
Delete libraries or executables.
.TP
.B \-\-version
Print libtool version information and exit.
.P
The
.I MODE\-ARGS
are a variable number of arguments, depending on the selected
operation mode. In general, each
.I MODE\-ARG
is interpreted by programs libtool invokes, rather than libtool itself.
.SH "SEE ALSO"
.BR libtoolize (1),
.BR automake (1)
.br
`libtool', `libtoolize' and `automake' are fully documented via the
Info system.
.SH AUTHOR
This manual page was created by Ossama Othman <ossama@debian.org>. It
is based entirely on the "Invoking Libtool" menu entry in the `libtool'
TEXINFO documentation.