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

diff --git a/ChangeLog b/ChangeLog
index 1318e5bb0fabeca19070b6cdce914902302997c9..744eb0765894009e84afdef8fd4f97e436e65247 100644 (file)
--- 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 2fe7aa6bdd7199106df19a5687703b6c34a25639..dffa14d7735f0d51759a1d08be59c7fda23a348a 100644 (file)
--- 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