From: Karl Berry <karl@freefriends.org>
Date: Tue, 23 Feb 2021 02:23:16 +0000 (-0800)
Subject: doc: a_LDFLAGS always overrides AM_LDFLAGS.
X-Git-Tag: v1.16.4~27
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=03d1ab0acdf5268b1640d8f197c138d79ef00155;p=thirdparty%2Fautomake.git

doc: a_LDFLAGS always overrides AM_LDFLAGS.

This change addresses https://bugs.gnu.org/34925.

* doc/automake.texi (Program and Library Variables): document
that using a_LDFLAGS at all, even in the false branch of a
conditional, means that AM_LDFLAGS is ignored.
---

diff --git a/doc/automake.texi b/doc/automake.texi
index 5f70e370c..8f5a9fcee 100644
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -5839,7 +5839,11 @@ of any library built by your package.  Doing so will ensure that
 
 @item maude_LDFLAGS
 This variable is used to pass extra flags to the link step of a program
-or a shared library.  It overrides the @code{AM_LDFLAGS} variable.
+or a shared library.  It overrides the @code{AM_LDFLAGS} variable,
+even if it is defined only in a false branch of a conditional; in
+other words, if @code{@var{prog}_LDFLAGS} is defined at all,
+@code{AM_LDFLAGS} will not be used.
+@c https://bugs.gnu.org/34925
 
 @item maude_LIBTOOLFLAGS
 This variable is used to pass extra options to @command{libtool}.