NAME

libtoolize - add libtool support to your Makefile

SYNOPSIS

libtoolize [-cfn] [--automake] [--copy] [--debug] [--dry-run] [--force] [--ltdl] [--ltdl-tar]

libtoolize [--help] [--version]

DESCRIPTION

libtoolize provides a standard way to add libtool(1) support to your Makefiles.

If you are using autoconf or automake, you should add a call to AM_PROG_LIBTOOL to your `configure.in' file. This macro offers seamless integration between the `configure' script and ltconfig.

The aclocal program will automatically add AM_PROG_LIBTOOL support to your configure script. It is advisable to include copy of your libtool.m4 into acinclude.m4, so that if the user rebuilds aclocal.m4 or configure they won't end up with possible incompatible macros if your and their version don't match.

The macro requires that you define the Makefile variable top_builddir in your `Makefile.in'. automake does this automatically, but autoconf users should set it to the relative path to the top of their build directory (`../..', for example)

AM_PROG_LIBTOOL

Add support for --enable-shared[=PACKAGE,...] so that the user may specify wether they want shared or static libraries built based on the name of the package. The package name `default' matches any packages that don't have their name in the PACKAGE environment variable.

By default, this macro turns on shared libraries if they are available, and also enables static libraries if they don't conflict with the shared libraries. You can modify these defaults by setting calling either the AM_DISABLE_SHARED or AM_DISABLE_STATIC macros.

# Turn off shared libraries during beta-testing, 
# since they make the build process take too long.
AC_DISABLE_SHARED
AM_PROG_LIBTOOL

The macro also sets the environment variable LIBTOOL_DEPS, that you can use to automaticall update the libtool scrit if it becomes out of date. To do this, add to your configure.in

AC_SUBST(LIBTOOL_DEPS)

LIBTOOL_DEPS = @LIBTOOL_DEPS@
libtool: $(LIBTOOL_DEPS)


        $(SHELL) ./config.status --recheck

AC_DISABLE_FAST_INSTALL

Change the default behaviour from AM_PROG_LIBTOOL to disable any optimizations for fast installation. The user may override this macro by specifying --enable-fast-install[=PACKAGE,...] as in --enable-shared

AC_DISABLE_SHARED

Change the default behaviour for AM_PROG_LIBTOOL to disable shared libraries. The user may still override this default by specifying --enable-shared.

AC_DISABLE_STATIC

Change the default behaviour for AM_PROG_LIBTOOL to disable static libraries. The user may still override this default by specifying --enable-static.

AC_LIBTOOL_DLOPEN

Use this macro if a package uses -dlopen or -dlpreopen. It must be called before AMPROG_LIBTOOL, and enables checking for dlopen support. Otherwise libtool will assume the platform doesn't support it.

AC_LIBTOOL_WIN32_DLL

Use this macro if a package has been ported to build clean dlls on win32 platforms. It must be called before AMPROG_LIBTOOL and -no-undefined must be passed to libtool in link mode.

It usually this means that any library data items are exported with `__declspec(dllexport)' and imported with `__declspec(dllimport)'. If this macro is not used, libtool will assume that the package libraries are not dll clean and will build only static libraries on win32 hosts.

See libtool(1) for a Makefile.am example.

OPTIONS

-c, --copy

Copy files from the libtool data directory rather than creating symlinks.

-f, --force

Replace existing libtool files. By default, libtoolize won't overwrite existing files.

-n, --dry-run

Don't create, modify, or delete any files, just show what commands would be executed by libtoolize.

--automake

Work silently, and assume that Automake libtool support is used. `libtoolize --automake' is used by Automake to add libtool files to your package, when AM_PROG_LIBTOOL appears in your `configure.in'.

--debug

Enables shell script trace mode, writing to standard output.

--ltdl

Install libltdl in a subdirectory of your package.

--ltdl-tar

Add the file libltdl.tar.gz to your package.

--help

Print a usage message on standard output and exit successfully.

--version

Print version information on standard output then exit successfully.

SEE ALSO

libtool(1), ltconfig(1)

NOTES

Report bugs to <bug-libtool@gnu.org>.
Man page by Ragnar Hojland Espinosa <ragnar@macula.net>