From: Paul Eggert <eggert@cs.ucla.edu>
Date: Thu, 17 Apr 2025 08:08:52 +0000 (-0700)
Subject: Document that 'configure' needs awk etc
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=56860215d1af490eddb821d73154a190137aa8ec;p=thirdparty%2Fautoconf.git

Document that 'configure' needs awk etc

Problem reported by Simon Josefsson in:
https://lists.gnu.org/r/bug-gnulib/2025-04/msg00127.html
* doc/install.texi (Installation Prerequisites): New section.
---

diff --git a/doc/autoconf.texi b/doc/autoconf.texi
index 8dffd02c1..fd16d5fbc 100644
--- a/doc/autoconf.texi
+++ b/doc/autoconf.texi
@@ -598,6 +598,7 @@ Transforming Program Names When Installing
 Running @command{configure} Scripts
 
 * Basic Installation::          Instructions for typical cases
+* Installation Prerequisites::  What you need to install
 * Compilers and Options::       Selecting compilers and optimization
 * Multiple Architectures::      Compiling for multiple architectures at once
 * Installation Names::          Installing in different directories
@@ -22893,6 +22894,7 @@ may use comes with Autoconf.
 
 @menu
 * Basic Installation::          Instructions for typical cases
+* Installation Prerequisites::  What you need to install
 * Compilers and Options::       Selecting compilers and optimization
 * Multiple Architectures::      Compiling for multiple architectures at once
 * Installation Names::          Installing in different directories
diff --git a/doc/install.texi b/doc/install.texi
index 414c89393..cf9a9c67f 100644
--- a/doc/install.texi
+++ b/doc/install.texi
@@ -132,6 +132,22 @@ If the package follows the GNU Coding Standards,
 you can type @samp{make uninstall} to remove the installed files.
 @end enumerate
 
+@node Installation Prerequisites
+@section Installation Prerequisites
+
+Installation requires a POSIX-like environment
+with a shell and the following standard utilities:
+
+@example
+[ awk cat cmp cp diff echo expr false
+grep ls mkdir mv printf pwd rm rmdir
+sed sort test touch tr true
+@end example
+
+@noindent
+Depending on the package, other programs may be needed,
+such as a compiler for the language the package is written in.
+
 @node Compilers and Options
 @section Compilers and Options