From: Bruno Haible <bruno@clisp.org>
Date: Wed, 7 May 2025 16:03:18 +0000 (+0200)
Subject: doc: Clarify how to obtain the various autoconf macros.
X-Git-Tag: v0.25~4
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=43f5ac51ddeb1b70a7b9647cb45cfeee67fd8c41;p=thirdparty%2Fgettext.git

doc: Clarify how to obtain the various autoconf macros.

* gettext-tools/doc/gettext.texi (autoconf macros): Suggest to use gettextize or
autopoint. Discourage autoreconf.
---

diff --git a/gettext-tools/doc/gettext.texi b/gettext-tools/doc/gettext.texi
index 2ba499e95..b53440fd8 100644
--- a/gettext-tools/doc/gettext.texi
+++ b/gettext-tools/doc/gettext.texi
@@ -9282,6 +9282,12 @@ package that needs it should contain a copy of it on its own.
 GNU @code{gettext} installs macros for use in a package's
 @file{configure.ac} or @file{configure.in}.
 @xref{Top, , Introduction, autoconf, The Autoconf Manual}.
+
+In order to copy these macros into your package,
+use the @code{gettextize} or @code{autopoint} programs.
+See @ref{gettextize Invocation} or @ref{autopoint Invocation}.
+Attempts to use the @code{autoreconf} program for this purpose are unreliable.
+
 The primary macro is, of course, @code{AM_GNU_GETTEXT}.
 
 @menu