gnulib-tool.py: Tweak last commit.
[gnulib.git] / DEPENDENCIES
blobe396adbd80d129896e284c43f69611139792cfd6
1 The following packages are needed by maintainers for using
2 'gnulib-tool'.  In general, Gnulib prefers the latest stable
3 version of each package, but in some cases it also supports
4 older versions; this caters to commonly-used software
5 distributions that may lag behind the latest stable package.
6 Support for older versions is not guaranteed, though, and
7 the version numbers in the following list may be incremented
8 at any time.
10 * A C runtime, compiler, linker, etc.
11   + Mandatory. Using the platform's native 'cc' gives good portability
12     exposure, but you can also use GCC 3.1 or newer.
13   + GCC Homepage:
14     https://gcc.gnu.org/
15   + Download:
16     https://ftp.gnu.org/gnu/gcc/
18 * A 'make' utility.
19   + Mandatory. Using the platform's native 'make' gives good portability
20     exposure for in-tree builds, but VPATH builds require GNU Make 3.79.1 or
21     newer.
22   + GNU Make Homepage:
23     https://www.gnu.org/software/make/
24   + Download:
25     https://ftp.gnu.org/gnu/make/
27 * GNU M4 1.4.5 or newer.
28   + Mandatory.
29     1.4.5 or newer is mandatory, but 1.4.9 or newer is recommended.
30     If you want to build it from source, use the tarball from
31     https://gitlab.com/gnu-m4/ci-distcheck/-/jobs/artifacts/master/raw/m4-snapshot.tar?job=check-optimized
32   + Homepage:
33     https://www.gnu.org/software/m4/
34   + Download:
35     https://ftp.gnu.org/gnu/m4/
37 * Autoconf 2.64 or newer.
38   + Mandatory.
39   + Homepage:
40     https://www.gnu.org/software/autoconf/
41   + Download:
42     https://ftp.gnu.org/gnu/autoconf/
44 * Automake 1.14 or newer.
45   + Mandatory.
46   + Homepage:
47     https://www.gnu.org/software/automake/
48   + Download:
49     https://ftp.gnu.org/gnu/automake/
51 * A shell
52   + Mandatory. Using the platform's native 'sh' gives good portability
53     exposure, but you can also use Bash.
54   + Homepage:
55     https://www.gnu.org/software/bash/
56   + Download:
57     https://ftp.gnu.org/gnu/bash/
59 * Core POSIX utilities, including:
60     [ basename cat chgrp chmod chown cp dd echo expand expr
61     false hostname install join kill ln ls md5sum mkdir mkfifo
62     mknod mv printenv pwd rm rmdir sleep sort tee test touch
63     true uname
64   + Mandatory. Using the platform's native utilities gives good portability
65     exposure, but you can also use GNU coreutils.
66   + Homepage:
67     https://www.gnu.org/software/coreutils/
68   + Download:
69     https://ftp.gnu.org/gnu/coreutils/
71 * The comparison utilities 'cmp' and 'diff'.
72   + Mandatory. Using the platform's native utilities gives good portability
73     exposure, but you can also use GNU diffutils.
74   + Homepage:
75     https://www.gnu.org/software/diffutils/
76   + Download:
77     https://ftp.gnu.org/gnu/diffutils/
79 * The patch utility 'patch'.
80   + Mandatory if you use gnulib-local diffs. Using the platform's native
81     utilities gives good portability exposure, but you can also use GNU
82     patch.
83   + Homepage:
84     https://www.gnu.org/software/patch/
85   + Download:
86     https://ftp.gnu.org/gnu/patch/
88 * Grep.
89   + Mandatory. Using the platform's native grep gives good portability
90     exposure, but you can also use GNU grep.
91   + Homepage:
92     https://www.gnu.org/software/grep/
93   + Download:
94     https://ftp.gnu.org/gnu/grep/
96 * Awk.
97   + Mandatory.
98     Using the platform's native awk, mawk, or nawk gives good portability
99     exposure, but you can also use GNU awk.
100   + Homepage:
101     https://www.gnu.org/software/gawk/
102   + Download:
103     https://ftp.gnu.org/gnu/gawk/
105 * GNU gettext.
106   + If your project wants to follow GNU Coding Standards:
107     + Always use the newest available gettext release, see
108       <https://www.gnu.org/software/gnulib/manual/html_node/gettextize-and-autopoint.html>.
109     + Use the 'gettext' module.
110   + If your project cares more about ease of development on older platforms:
111     + gettext 0.17 or newer.
112     + Use the 'gettext-h' module.
113   + Recommended.
114     Needed if you use modules that use internationalization (many do).
115   + Homepage:
116     https://www.gnu.org/software/gettext/
117   + Download:
118     https://ftp.gnu.org/gnu/gettext/
119   + Pre-built package name:
120     - On Debian and Debian-based systems: gettext,
121     - On Red Hat distributions: gettext.
122     - Other: https://repology.org/project/gettext/versions
124 * Bison 2.0 or newer.
125   + Recommended.
126     Needed if you use the 'parse-datetime' module.
127   + Homepage:
128     https://www.gnu.org/software/bison/
129   + Download:
130     https://ftp.gnu.org/gnu/bison/
131   + Pre-built package name:
132     - On Debian and Debian-based systems: bison,
133     - On Red Hat distributions: bison.
134     - Other: https://repology.org/project/bison/versions
136 * GNU gperf 3.0.1 or newer.
137   + 3.0.1 or newer is mandatory, but 3.1 or newer is recommended.
138     Needed if you use the 'iconv_open' module or some of the
139     unictype/*, unicase/*, uninorm/* modules.
140   + Homepage:
141     https://www.gnu.org/software/gperf/
142   + Download:
143     https://ftp.gnu.org/gnu/gperf/
144   + Pre-built package name:
145     - On Debian and Debian-based systems: gperf,
146     - On Red Hat distributions: gperf.
147     - Other: https://repology.org/project/gperf/versions
149 * Texinfo 4.6 or newer.
150   + Recommended.
151     Needed if you use modules that include documentation.
152   + Homepage:
153     https://www.gnu.org/software/texinfo/
154   + Download:
155     https://ftp.gnu.org/gnu/texinfo/
156   + Pre-built package name:
157     - On Debian and Debian-based systems: texinfo,
158     - On Red Hat distributions: texinfo.
159     - Other: https://repology.org/project/texinfo/versions
161 * GNU sed.
162   + Recommended.
163     Needed on platforms where the vendor's 'sed' program is too buggy.
164   + Homepage:
165     https://www.gnu.org/software/sed/
166   + Download:
167     https://ftp.gnu.org/gnu/sed/
169 * GNU libtool 1.5.22 or newer.
170   + Optional.
171     Needed if you want to invoke gnulib-tool with option --libtool.
172     libtool 2.2.x or newer is needed if you want to invoke gnulib-tool
173     with options --create-testdir/--test  and --libtool.
174   + Homepage:
175     https://www.gnu.org/software/libtool/
176   + Download:
177     https://ftp.gnu.org/gnu/libtool/
179 * GNU tar 1.28 or newer.
180   + Recommended.
181     Needed if you use the 'gnumakefile' module, which sets TAR_OPTIONS
182     to --sort=names (added in version 1.28) in GNUmakefile for 'make dist'.
183   + Homepage:
184     https://www.gnu.org/software/tar/
185   + Download:
186     https://ftp.gnu.org/gnu/tar/