Scroll to navigation

GNULIB-TOOL(1) GNU Portability Library GNULIB-TOOL(1)

NAME

gnulib-tool - program for authors or maintainers which want to import modules from gnulib into their packages.

SYNOPSIS

gnulib-tool --list

gnulib-tool --import [module1 ... moduleN]

gnulib-tool --update

gnulib-tool --create-testdir --dir=directory module1 ... moduleN

gnulib-tool --create-megatestdir --dir=directory [module1 ... moduleN]

gnulib-tool --test --dir=directory module1 ... moduleN

gnulib-tool --megatest --dir=directory [module1 ... moduleN]

gnulib-tool --extract-description module

gnulib-tool --extract-filelist module

gnulib-tool --extract-dependencies module

gnulib-tool --extract-autoconf-snippet module

gnulib-tool --extract-automake-snippet module

gnulib-tool --extract-include-directive module

gnulib-tool --extract-license module

gnulib-tool --extract-maintainer module

gnulib-tool --extract-tests-module module

DESCRIPTION

The GNU portability library is a macro system and C declarations and definitions for commonly-used API elements and abstracted system behaviors. It can be used to improve portability and other functionality in your programs.

OPTIONS

Operation modes:

print the available module names.
import the given modules into the current package; if no modules are specified, update the current package from the current gnulib.
update the current package, restore files omitted from CVS.
create a scratch package with the given modules.
create a mega scratch package with the given modules one by one and all together.
test the combination of the given modules (recommended to use CC="gcc -Wall" here).
test the given modules one by one and all together (recommended to use CC="gcc -Wall" here).
extract the description.
extract the list of files.
extract the dependencies.
extract the snippet for configure.ac.
extract the snippet for lib/Makefile.am.
extract the #include directive.
report the license terms of the source files under lib/.
report the maintainer(s) inside gnulib.
report the unit test module, if it exists.

Options:

specify the target directory. For --import, this specifies where your configure.ac can be found. Defaults to current directory.
Specify the library name. Defaults to 'libgnu'.
Directory relative --dir where source code is placed (default "lib"), for --import.
Directory relative --dir where *.m4 macros are placed (default "m4"), for --import.
Directory relative --dir where unit tests are placed (default "tests"), for --import.
Directory relative --dir where auxiliary build tools are placed (default "build-aux").
Include unit tests for the included modules.
Avoid including the given MODULE. Useful if you have code that provides equivalent functionality. This option can be repeated.
Abort if modules aren't available under the LGPL. Also modify license template from GPL to LGPL.
Use libtool rules, for --import.
Specify the prefix of the macros 'gl_EARLY' and 'gl_INIT'. Default is 'gl'.
don't update or create ChangeLog files.
For --import, only print what would have been done.
Make symbolic links instead of copying files.
Show summary of options.

BUGS

Report bugs to <bug-gnulib@gnu.org>.

SEE ALSO

check-module(1).

AUTHOR

gnulib was written by the Free Software Foundation and others (sources of various origins).

This manual page was written by Daniel Baumann <daniel@debian.org>, for the Debian project (but may be used by others).

2006-06-01 0.0.20060601