1GNULIB-TOOL(1)              GNU Portability Library             GNULIB-TOOL(1)
2
3
4

NAME

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

SYNOPSIS

11       gnulib-tool --list
12
13       gnulib-tool --import [module1 ... moduleN]
14
15       gnulib-tool --update
16
17       gnulib-tool --create-testdir --dir=directory module1 ... moduleN
18
19       gnulib-tool --create-megatestdir --dir=directory [module1 ... moduleN]
20
21       gnulib-tool --test --dir=directory module1 ... moduleN
22
23       gnulib-tool --megatest --dir=directory [module1 ... moduleN]
24
25       gnulib-tool --extract-description module
26
27       gnulib-tool --extract-filelist module
28
29       gnulib-tool --extract-dependencies module
30
31       gnulib-tool --extract-autoconf-snippet module
32
33       gnulib-tool --extract-automake-snippet module
34
35       gnulib-tool --extract-include-directive module
36
37       gnulib-tool --extract-license module
38
39       gnulib-tool --extract-maintainer module
40
41       gnulib-tool --extract-tests-module module
42
43

DESCRIPTION

45       The GNU portability library is a macro system and  C  declarations  and
46       definitions for commonly-used API elements and abstracted system behav‐
47       iors. It can be used to improve portability and other functionality  in
48       your programs.
49

OPTIONS

51       Operation modes:
52
53       --list print the available module names.
54
55       --import
56              import the given modules into the current package; if no modules
57              are specified, update  the  current  package  from  the  current
58              gnulib.
59
60       --update
61              update the current package, restore files omitted from CVS.
62
63       --create-testdir
64              create a scratch package with the given modules.
65
66       --create-megatestdir
67              create  a mega scratch package with the given modules one by one
68              and all together.
69
70       --test test the combination of the given modules  (recommended  to  use
71              CC="gcc -Wall" here).
72
73       --megatest
74              test  the given modules one by one and all together (recommended
75              to use CC="gcc -Wall" here).
76
77       --extract-description
78              extract the description.
79
80       --extract-filelist
81              extract the list of files.
82
83       --extract-dependencies
84              extract the dependencies.
85
86       --extract-autoconf-snippet
87              extract the snippet for configure.ac.
88
89       --extract-automake-snippet
90              extract the snippet for lib/Makefile.am.
91
92       --extract-include-directive
93              extract the #include directive.
94
95       --extract-license
96              report the license terms of the source files under lib/.
97
98       --extract-maintainer
99              report the maintainer(s) inside gnulib.
100
101       --extract-tests-module
102              report the unit test module, if it exists.
103
104       Options:
105
106       --dir=DIRECTORY
107              specify the target directory. For --import, this specifies where
108              your configure.ac can be found. Defaults to current directory.
109
110       --lib=LIBRARY
111              Specify the library name. Defaults to 'libgnu'.
112
113       --source-base=DIRECTORY
114              Directory  relative  --dir  where source code is placed (default
115              "lib"), for --import.
116
117       --m4-base=DIRECTORY
118              Directory relative --dir where *.m4 macros are  placed  (default
119              "m4"), for --import.
120
121       --tests-base=DIRECTORY
122              Directory  relative  --dir  where unit tests are placed (default
123              "tests"), for --import.
124
125       --aux-dir=DIRECTORY
126              Directory relative --dir where auxiliary build tools are  placed
127              (default "build-aux").
128
129       --with-tests
130              Include unit tests for the included modules.
131
132       --avoid=MODULE
133              Avoid  including  the given MODULE. Useful if you have code that
134              provides equivalent functionality. This option can be repeated.
135
136       --lgpl Abort if modules aren't available under the  LGPL.  Also  modify
137              license template from GPL to LGPL.
138
139       --libtool
140              Use libtool rules, for --import.
141
142       --macro-prefix=PREFIX
143              Specify  the  prefix  of  the  macros  'gl_EARLY' and 'gl_INIT'.
144              Default is 'gl'.
145
146       --no-changelog
147              don't update or create ChangeLog files.
148
149       --dry-run
150              For --import, only print what would have been done.
151
152       -s, --symbolic, --symlink
153              Make symbolic links instead of copying files.
154
155       -h, --help
156              Show summary of options.
157
158

BUGS

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

SEE ALSO

164       check-module(1).
165
166

AUTHOR

168       gnulib was written by the Free Software Foundation and others  (sources
169       of various origins).
170
171       This manual page was written by Daniel Baumann <daniel@debian.org>, for
172       the Debian project (but may be used by others).
173
174
175
1760.0.20060601                      2006-06-01                    GNULIB-TOOL(1)