[automake-commit] branch master updated: doc: a_LDFLAGS always overrides AM_LDFLAGS.

[Karl Berry]

This is an automated email from the git hooks/post-receive script.

karl pushed a commit to branch master
in repository automake.

View the commit online:
https://git.savannah.gnu.org/gitweb/?p=automake.git;a=commitdiff;h=03d1ab0acdf5268b1640d8f197c138d79ef00155

The following commit(s) were added to refs/heads/master by this push:
     new 03d1ab0  doc: a_LDFLAGS always overrides AM_LDFLAGS.
03d1ab0 is described below

commit 03d1ab0acdf5268b1640d8f197c138d79ef00155
Author: Karl Berry <karl@freefriends.org>
AuthorDate: Mon Feb 22 18:23:16 2021 -0800

    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.
---
 doc/automake.texi | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/doc/automake.texi b/doc/automake.texi
index 5f70e37..8f5a9fc 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}.