DEPENDENCIES

   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.
   9
  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/
  17
  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/
  26
  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/
  36
  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/
  43
  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/
  50
  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/
  58
  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/
  70
  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/
  78
  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/
  87
  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/
  95
  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/
 104
 105 * Python 3.7 or newer.
 106   * Recommended.
 107     Without it, gnulib-tool is between 8 times and 100 times slower and may lack
 108     functionality added after April 2024.
 109   + Homepage:
 110     https://www.python.org/
 111   + Download:
 112     https://www.python.org/downloads/
 113   + Pre-built package name:
 114     - On Debian and Debian-based systems: python3,
 115     - On Red Hat distributions: python3.
 116     - Other: https://repology.org/project/python/versions
 117
 118 * GNU gettext.
 119   + If your project wants to follow GNU Coding Standards:
 120     + Always use the newest available gettext release, see
 121       <https://www.gnu.org/software/gnulib/manual/html_node/gettextize-and-autopoint.html>.
 122     + Use the 'gettext' module.
 123   + If your project cares more about ease of development on older platforms:
 124     + gettext 0.17 or newer.
 125     + Use the 'gettext-h' module.
 126   + Recommended.
 127     Needed if you use modules that use internationalization (many do).
 128   + Homepage:
 129     https://www.gnu.org/software/gettext/
 130   + Download:
 131     https://ftp.gnu.org/gnu/gettext/
 132   + Pre-built package name:
 133     - On Debian and Debian-based systems: gettext,
 134     - On Red Hat distributions: gettext.
 135     - Other: https://repology.org/project/gettext/versions
 136
 137 * Bison 2.0 or newer.
 138   + Recommended.
 139     Needed if you use the 'parse-datetime' module.
 140   + Homepage:
 141     https://www.gnu.org/software/bison/
 142   + Download:
 143     https://ftp.gnu.org/gnu/bison/
 144   + Pre-built package name:
 145     - On Debian and Debian-based systems: bison,
 146     - On Red Hat distributions: bison.
 147     - Other: https://repology.org/project/bison/versions
 148
 149 * GNU gperf 3.0.1 or newer.
 150   + 3.0.1 or newer is mandatory, but 3.1 or newer is recommended.
 151     Needed if you use the 'iconv_open' module or some of the
 152     unictype/*, unicase/*, uninorm/* modules.
 153   + Homepage:
 154     https://www.gnu.org/software/gperf/
 155   + Download:
 156     https://ftp.gnu.org/gnu/gperf/
 157   + Pre-built package name:
 158     - On Debian and Debian-based systems: gperf,
 159     - On Red Hat distributions: gperf.
 160     - Other: https://repology.org/project/gperf/versions
 161
 162 * Texinfo 4.6 or newer.
 163   + Recommended.
 164     Needed if you use modules that include documentation.
 165   + Homepage:
 166     https://www.gnu.org/software/texinfo/
 167   + Download:
 168     https://ftp.gnu.org/gnu/texinfo/
 169   + Pre-built package name:
 170     - On Debian and Debian-based systems: texinfo,
 171     - On Red Hat distributions: texinfo.
 172     - Other: https://repology.org/project/texinfo/versions
 173
 174 * GNU sed.
 175   + Recommended.
 176     Needed on platforms where the vendor's 'sed' program is too buggy.
 177   + Homepage:
 178     https://www.gnu.org/software/sed/
 179   + Download:
 180     https://ftp.gnu.org/gnu/sed/
 181
 182 * GNU libtool 1.5.22 or newer.
 183   + Optional.
 184     Needed if you want to invoke gnulib-tool with option --libtool.
 185     libtool 2.2.x or newer is needed if you want to invoke gnulib-tool
 186     with options --create-testdir/--test  and --libtool.
 187   + Homepage:
 188     https://www.gnu.org/software/libtool/
 189   + Download:
 190     https://ftp.gnu.org/gnu/libtool/
 191
 192 * GNU tar 1.28 or newer.
 193   + Recommended.
 194     Needed if you use the 'gnumakefile' module, which sets TAR_OPTIONS
 195     to --sort=names (added in version 1.28) in GNUmakefile for 'make dist'.
 196   + Homepage:
 197     https://www.gnu.org/software/tar/
 198   + Download:
 199     https://ftp.gnu.org/gnu/tar/
 200
 201
 202 Prerequisites needed on specific platforms
 203 ==========================================
 204
 205 Prerequisites on Windows
 206 ------------------------
 207
 208 * Cygwin
 209   + Required.
 210     Provides a POSIX-like environment and binary packages necessary to
 211     build and run software. Native Windows binaries can be built with
 212     a packaged mingw tool chain. This method is preferred over MSYS2.
 213   + Homepage:
 214     https://cygwin.com/
 215   + Download:
 216     https://cygwin.com/install.html