SysTutorials

Linux Manual Pages › Section 1

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:

–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 [at] 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 [at] debian.org>, for the Debian project (but may be used by others).