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:
--list print the available module names.
--import
import the given modules into the current package; if no modules
are specified, update the current package from the current
gnulib.
--update
update the current package, restore files omitted from CVS.
--create-testdir
create a scratch package with the given modules.
--create-megatestdir
create a mega scratch package with the given modules one by one
and all together.
--test test the combination of the given modules (recommended to use
CC="gcc -Wall" here).
--megatest
test the given modules one by one and all together (recommended
to use CC="gcc -Wall" here).
--extract-description
extract the description.
--extract-filelist
extract the list of files.
--extract-dependencies
extract the dependencies.
--extract-autoconf-snippet
extract the snippet for configure.ac.
--extract-automake-snippet
extract the snippet for lib/Makefile.am.
--extract-include-directive
extract the #include directive.
--extract-license
report the license terms of the source files under lib/.
--extract-maintainer
report the maintainer(s) inside gnulib.
--extract-tests-module
report the unit test module, if it exists.
Options:
--dir=DIRECTORY
specify the target directory. For --import, this specifies where
your configure.ac can be found. Defaults to current directory.
--lib=LIBRARY
Specify the library name. Defaults to ’libgnu’.
--source-base=DIRECTORY
Directory relative --dir where source code is placed (default
"lib"), for --import.
--m4-base=DIRECTORY
Directory relative --dir where *.m4 macros are placed (default
"m4"), for --import.
--tests-base=DIRECTORY
Directory relative --dir where unit tests are placed (default
"tests"), for --import.
--aux-dir=DIRECTORY
Directory relative --dir where auxiliary build tools are placed
(default "build-aux").
--with-tests
Include unit tests for the included modules.
--avoid=MODULE
Avoid including the given MODULE. Useful if you have code that
provides equivalent functionality. This option can be repeated.
--lgpl Abort if modules aren’t available under the LGPL. Also modify
license template from GPL to LGPL.
--libtool
Use libtool rules, for --import.
--macro-prefix=PREFIX
Specify the prefix of the macros ’gl_EARLY’ and ’gl_INIT’.
Default is ’gl’.
--no-changelog
don’t update or create ChangeLog files.
--dry-run
For --import, only print what would have been done.
-s, --symbolic, --symlink
Make symbolic links instead of copying files.
-h, --help
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).