From: Paul Smith <psmith@gnu.org>
Date: Sat, 6 Apr 2013 14:51:57 +0000 (-0400)
Subject: Clarify LDFLAGS vs. LDLIBS.  Fixes Savannah bug #37970.
X-Git-Tag: 3.99.90~55
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=6a52395ed14e0bda22be3fc0819e4507a71278e1;p=thirdparty%2Fmake.git

Clarify LDFLAGS vs. LDLIBS.  Fixes Savannah bug #37970.
---

diff --git a/ChangeLog b/ChangeLog
index 1318e5bb..744eb076 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
 2013-04-06  Paul Smith  <psmith@gnu.org>
 
+	* doc/make.texi (Implicit Variables): Clarify LDFLAGS vs. LDLIBS.
+	Fixes Savannah bug #37970.
+
 	* remake.c (check_dep): Reconsider files waiting on prerequisites,
 	as they may have finished.  Fixes Savannah bug #37703.
 
diff --git a/doc/make.texi b/doc/make.texi
index 2fe7aa6b..dffa14d7 100644
--- a/doc/make.texi
+++ b/doc/make.texi
@@ -9377,14 +9377,16 @@ Extra flags to give to the SCCS @code{get} program.
 @item LDFLAGS
 @vindex LDFLAGS
 Extra flags to give to compilers when they are supposed to invoke the linker,
-@samp{ld}.
+@samp{ld}, such as @code{-L}.  Libraries (@code{-lfoo}) should be
+added to the @code{LDLIBS} variable instead.
 
 @item LDLIBS
 @vindex LDLIBS
 @vindex LOADLIBES
 Library flags or names given to compilers when they are supposed to
 invoke the linker, @samp{ld}.  @code{LOADLIBES} is a deprecated (but
-still supported) alternative to @code{LDLIBS}.
+still supported) alternative to @code{LDLIBS}.  Non-library linker
+flags, such as @code{-L}, should go in the @code{LDFLAGS} variable.
 
 @item LFLAGS
 @vindex LFLAGS