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>.