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 5f70e370c158a1b38a6bf9f46fb5919170ca1cc9..8f5a9fceec9acc88ff3775e9630483e6ac325fe6 100644 (file)
--- 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}.