pty: Activate the signature wrapper of forkpty.
[gnulib.git] / DEPENDENCIES
index f120751..e19a37e 100644 (file)
@@ -1,33 +1,40 @@
-The following packages are needed by maintainers for using 'gnulib-tool':
+The following packages are needed by maintainers for using
+'gnulib-tool'.  In general, Gnulib prefers the latest stable
+version of each package, but in some cases it also supports
+older versions; this caters to commonly-used software
+distributions that may lag behind the latest stable package.
+Support for older versions is not guaranteed, though, and
+the version numbers in the following list may be incremented
+at any time.
 
-* A C runtime and compiler.
-  + Mandatory, platform cc gives good portability exposure.
-  + GCC Homepage (GNU gcc 2.95 or newer):
+* A C runtime, compiler, linker, etc.
+  + Mandatory. Using the platform's native 'cc' gives good portability
+    exposure, but you can also use GCC 2.95 or newer.
+  + GCC Homepage:
     http://gcc.gnu.org/
   + Download:
     http://ftp.gnu.org/gnu/gcc/
     ftp://ftp.gnu.org/gnu/gcc/
 
 * A 'make' utility.
-  + Mandatory, platform make gives good portability exposure.
-  + VPATH builds often need GNU make 3.79.1 or newer.
+  + Mandatory. Using the platform's native 'make' gives good portability
+    exposure for in-tree builds, but VPATH builds require GNU Make 3.79.1 or
+    newer.
   + GNU Make Homepage:
     http://www.gnu.org/software/make/
   + Download:
     http://ftp.gnu.org/gnu/make/
     ftp://ftp.gnu.org/gnu/make/
 
-* GNU m4 1.4.5 or newer.
-  + Mandatory.
-    Autoconf 2.62 requires GNU m4 1.4.5 or newer, and Autoconf 2.61 triggers
-    bugs in GNU m4 < 1.4.5.
+* GNU M4 1.4.5 or newer.
+  + 1.4.5 or newer is mandatory, but 1.4.9 or newer is recommended.
   + Homepage:
     http://www.gnu.org/software/m4/
   + Download:
     http://ftp.gnu.org/gnu/m4/
     ftp://ftp.gnu.org/gnu/m4/
 
-* GNU autoconf 2.59 or newer.
+* Autoconf 2.59 or newer.
   + Mandatory.
   + Homepage:
     http://www.gnu.org/software/autoconf/
@@ -35,7 +42,7 @@ The following packages are needed by maintainers for using 'gnulib-tool':
     http://ftp.gnu.org/gnu/autoconf/
     ftp://ftp.gnu.org/gnu/autoconf/
 
-* GNU automake 1.10 or newer.
+* Automake 1.9.6 or newer.
   + Mandatory.
   + Homepage:
     http://www.gnu.org/software/automake/
@@ -43,18 +50,75 @@ The following packages are needed by maintainers for using 'gnulib-tool':
     http://ftp.gnu.org/gnu/automake/
     ftp://ftp.gnu.org/gnu/automake/
 
-* GNU gettext 0.16.1.
+* A shell
+  + Mandatory. Using the platform's native 'sh' gives good portability
+    exposure, but you can also use Bash.
+  + Homepage:
+    http://www.gnu.org/software/bash/
+  + Download:
+    http://ftp.gnu.org/gnu/bash/
+    ftp://ftp.gnu.org/gnu/bash/
+
+* Core POSIX utilities, including:
+    [ basename cat chgrp chmod chown cp dd echo expand expr
+    false hostname install kill ln ls md5sum mkdir mkfifo
+    mknod mv printenv pwd rm rmdir sleep sort tee test touch
+    true uname
+  + Mandatory. Using the platform's native utilities gives good portability
+    exposure, but you can also use GNU coreutils.
+  + Homepage:
+    http://www.gnu.org/software/coreutils/
+  + Download:
+    http://ftp.gnu.org/gnu/coreutils/
+    ftp://ftp.gnu.org/gnu/coreutils/
+
+* The comparison utilities 'cmp' and 'diff'.
+  + Mandatory. Using the platform's native utilities gives good portability
+    exposure, but you can also use GNU diffutils.
+  + Homepage:
+    http://www.gnu.org/software/diffutils/
+  + Download:
+    http://ftp.gnu.org/gnu/diffutils/
+    ftp://ftp.gnu.org/gnu/diffutils/
+
+* The patch utility 'patch'.
+  + Mandatory if you use gnulib-local diffs. Using the platform's native
+    utilities gives good portability exposure, but you can also use GNU
+    patch.
+  + Homepage:
+    http://www.gnu.org/software/patch/
+  + Download:
+    http://ftp.gnu.org/gnu/patch/
+    ftp://ftp.gnu.org/gnu/patch/
+
+* Grep.
+  + Mandatory. Using the platform's native grep gives good portability
+    exposure, but you can also use GNU grep.
+  + Homepage:
+    http://www.gnu.org/software/grep/
+  + Download:
+    http://ftp.gnu.org/gnu/grep/
+    ftp://ftp.gnu.org/gnu/grep/
+
+* GNU gettext.
+  + If your project wants to follow GNU Coding Standards:
+    + Always use the newest available gettext release, see
+      <http://www.gnu.org/software/gnulib/manual/html_node/gettextize-and-autopoint.html>.
+    + Use the 'gettext' module.
+  + If your project cares more about ease of development on older platforms:
+    + gettext 0.17 or newer.
+    + Use the 'gettext-h' module.
   + Recommended.
-    Needed if you use modules which make use of internationalization (many do).
+    Needed if you use modules that use internationalization (many do).
   + Homepage:
     http://www.gnu.org/software/gettext/
   + Download:
     http://ftp.gnu.org/gnu/gettext/
     ftp://ftp.gnu.org/gnu/gettext/
 
-* GNU bison 2.0 or newer.
+* Bison 2.0 or newer.
   + Recommended.
-    Needed if you use the 'getdate' module.
+    Needed if you use the 'parse-datetime' module.
   + Homepage:
     http://www.gnu.org/software/bison/
   + Download:
@@ -70,7 +134,7 @@ The following packages are needed by maintainers for using 'gnulib-tool':
     http://ftp.gnu.org/gnu/gperf/
     ftp://ftp.gnu.org/gnu/gperf/
 
-* GNU texinfo 4.2 or newer.
+* Texinfo 4.6 or newer.
   + Recommended.
     Needed if you use modules that include documentation.
   + Homepage:
@@ -79,7 +143,7 @@ The following packages are needed by maintainers for using 'gnulib-tool':
     http://ftp.gnu.org/gnu/texinfo/
     ftp://ftp.gnu.org/gnu/texinfo/
 
-* GNU sed
+* GNU sed.
   + Recommended.
     Needed on platforms where the vendor's 'sed' program is too buggy.
   + Homepage:
@@ -91,6 +155,8 @@ The following packages are needed by maintainers for using 'gnulib-tool':
 * GNU libtool 1.5.22 or newer.
   + Optional.
     Needed if you want to invoke gnulib-tool with option --libtool.
+    libtool 2.2.x or newer is needed if you want to invoke gnulib-tool
+    with options --create-testdir/--test  and --libtool.
   + Homepage:
     http://www.gnu.org/software/libtool/
   + Download: