From: Bruno Haible <bruno@clisp.org>
Date: Sun, 18 Aug 2019 08:59:40 +0000 (+0200)
Subject: maint: Document how to deal with the build error in gettext-tools/examples/po.
X-Git-Tag: v0.20.2~53
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=24855e3a7acfd54b55e7ac8319e4c08736273c11;p=thirdparty%2Fgettext.git

maint: Document how to deal with the build error in gettext-tools/examples/po.

Reported by Nick Alcock <nix@esperi.org.uk>
at <https://savannah.gnu.org/bugs/?56529>.

* HACKING (Building off the Git repository): Explain the common build error and
how to fix it.
---

diff --git a/HACKING b/HACKING
index a2bc2884e..7ca3a7ddb 100644
--- a/HACKING
+++ b/HACKING
@@ -208,6 +208,28 @@ Each time you want to update the source, do not only "git pull".  Instead do
   git pull && ./gitsub.sh pull
   ./autogen.sh
 
+The first time you build the Git checkout:
+  ./configure ... --prefix=PREFIX
+  make
+you are likely to encounter a build error in the gettext-tools/examples/po
+subdirectory, such as:
+  autopoint: *** The AM_GNU_GETTEXT_VERSION declaration in your configure.ac
+                 file requires the infrastructure from gettext-0.20 but this
+                 version is older. Please upgrade to gettext-0.20 or newer.
+  autopoint: *** Stop.
+The fix is
+  * either to build and install the latest GNU gettext release first, then
+    continue building the Git checkout:
+      make
+  * or to just install what you have built
+      make install      (fails)
+    then make sure that the installed binaries are in your PATH:
+      PATH=PREFIX/bin:$PATH
+    then continue building:
+      make              (should succeed now)
+      make check
+      make install      (should succeed now as well)
+
 
 Submitting patches
 ==================