autoupdate
[gnulib.git] / DEPENDENCIES
blob3b24f45ad6b695a0730314e1fa501fd0a50323bc
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.
139   + Homepage:
140     https://www.gnu.org/software/gperf/
141   + Download:
142     https://ftp.gnu.org/gnu/gperf/
143   + Pre-built package name:
144     - On Debian and Debian-based systems: gperf,
145     - On Red Hat distributions: gperf.
146     - Other: https://repology.org/project/gperf/versions
148 * Texinfo 4.6 or newer.
149   + Recommended.
150     Needed if you use modules that include documentation.
151   + Homepage:
152     https://www.gnu.org/software/texinfo/
153   + Download:
154     https://ftp.gnu.org/gnu/texinfo/
155   + Pre-built package name:
156     - On Debian and Debian-based systems: texinfo,
157     - On Red Hat distributions: texinfo.
158     - Other: https://repology.org/project/texinfo/versions
160 * GNU sed.
161   + Recommended.
162     Needed on platforms where the vendor's 'sed' program is too buggy.
163   + Homepage:
164     https://www.gnu.org/software/sed/
165   + Download:
166     https://ftp.gnu.org/gnu/sed/
168 * GNU libtool 1.5.22 or newer.
169   + Optional.
170     Needed if you want to invoke gnulib-tool with option --libtool.
171     libtool 2.2.x or newer is needed if you want to invoke gnulib-tool
172     with options --create-testdir/--test  and --libtool.
173   + Homepage:
174     https://www.gnu.org/software/libtool/
175   + Download:
176     https://ftp.gnu.org/gnu/libtool/
178 * GNU tar 1.28 or newer.
179   + Recommended.
180     Needed if you use the 'gnumakefile' module, which sets TAR_OPTIONS
181     to --sort=names (added in version 1.28) in GNUmakefile for 'make dist'.
182   + Homepage:
183     https://www.gnu.org/software/tar/
184   + Download:
185     https://ftp.gnu.org/gnu/tar/