git-version-gen: port better to older Git
[gnulib.git] / DEPENDENCIES
blobf9b6aa0cf1a234d4801ff92e6a1307c43f567db7
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 2.95 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   + 1.4.5 or newer is mandatory, but 1.4.9 or newer is recommended.
29   + Homepage:
30     https://www.gnu.org/software/m4/
31   + Download:
32     https://ftp.gnu.org/gnu/m4/
34 * Autoconf 2.60 or newer.
35   + Mandatory.
36   + Homepage:
37     https://www.gnu.org/software/autoconf/
38   + Download:
39     https://ftp.gnu.org/gnu/autoconf/
41 * Automake 1.11.1 or newer.
42   + Mandatory.
43   + Homepage:
44     https://www.gnu.org/software/automake/
45   + Download:
46     https://ftp.gnu.org/gnu/automake/
48 * A shell
49   + Mandatory. Using the platform's native 'sh' gives good portability
50     exposure, but you can also use Bash.
51   + Homepage:
52     https://www.gnu.org/software/bash/
53   + Download:
54     https://ftp.gnu.org/gnu/bash/
56 * Core POSIX utilities, including:
57     [ basename cat chgrp chmod chown cp dd echo expand expr
58     false hostname install kill ln ls md5sum mkdir mkfifo
59     mknod mv printenv pwd rm rmdir sleep sort tee test touch
60     true uname
61   + Mandatory. Using the platform's native utilities gives good portability
62     exposure, but you can also use GNU coreutils.
63   + Homepage:
64     https://www.gnu.org/software/coreutils/
65   + Download:
66     https://ftp.gnu.org/gnu/coreutils/
68 * The comparison utilities 'cmp' and 'diff'.
69   + Mandatory. Using the platform's native utilities gives good portability
70     exposure, but you can also use GNU diffutils.
71   + Homepage:
72     https://www.gnu.org/software/diffutils/
73   + Download:
74     https://ftp.gnu.org/gnu/diffutils/
76 * The patch utility 'patch'.
77   + Mandatory if you use gnulib-local diffs. Using the platform's native
78     utilities gives good portability exposure, but you can also use GNU
79     patch.
80   + Homepage:
81     https://www.gnu.org/software/patch/
82   + Download:
83     https://ftp.gnu.org/gnu/patch/
85 * Grep.
86   + Mandatory. Using the platform's native grep gives good portability
87     exposure, but you can also use GNU grep.
88   + Homepage:
89     https://www.gnu.org/software/grep/
90   + Download:
91     https://ftp.gnu.org/gnu/grep/
93 * GNU gettext.
94   + If your project wants to follow GNU Coding Standards:
95     + Always use the newest available gettext release, see
96       <https://www.gnu.org/software/gnulib/manual/html_node/gettextize-and-autopoint.html>.
97     + Use the 'gettext' module.
98   + If your project cares more about ease of development on older platforms:
99     + gettext 0.17 or newer.
100     + Use the 'gettext-h' module.
101   + Recommended.
102     Needed if you use modules that use internationalization (many do).
103   + Homepage:
104     https://www.gnu.org/software/gettext/
105   + Download:
106     https://ftp.gnu.org/gnu/gettext/
108 * Bison 2.0 or newer.
109   + Recommended.
110     Needed if you use the 'parse-datetime' module.
111   + Homepage:
112     https://www.gnu.org/software/bison/
113   + Download:
114     https://ftp.gnu.org/gnu/bison/
116 * GNU gperf 3.0.1 or newer.
117   + 3.0.1 or newer is mandatory, but 3.1 or newer is recommended.
118     Needed if you use the 'iconv_open' module.
119   + Homepage:
120     https://www.gnu.org/software/gperf/
121   + Download:
122     https://ftp.gnu.org/gnu/gperf/
124 * Texinfo 4.6 or newer.
125   + Recommended.
126     Needed if you use modules that include documentation.
127   + Homepage:
128     https://www.gnu.org/software/texinfo/
129   + Download:
130     https://ftp.gnu.org/gnu/texinfo/
132 * GNU sed.
133   + Recommended.
134     Needed on platforms where the vendor's 'sed' program is too buggy.
135   + Homepage:
136     https://www.gnu.org/software/sed/
137   + Download:
138     https://ftp.gnu.org/gnu/sed/
140 * GNU libtool 1.5.22 or newer.
141   + Optional.
142     Needed if you want to invoke gnulib-tool with option --libtool.
143     libtool 2.2.x or newer is needed if you want to invoke gnulib-tool
144     with options --create-testdir/--test  and --libtool.
145   + Homepage:
146     https://www.gnu.org/software/libtool/
147   + Download:
148     https://ftp.gnu.org/gnu/libtool/