From: Bruno Haible <bruno@clisp.org>
Date: Wed, 14 May 2025 21:41:55 +0000 (-0700)
Subject: doc: Clarify where to put -L and -l options.
X-Git-Tag: v1.18~8
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=68da133f18aeddfc0e655b3fdc6d0242e45182d9;p=thirdparty%2Fautomake.git

doc: Clarify where to put -L and -l options.

From https://bugs.gnu.org/78411.

* doc/automake.texi (Linking): Clarify that -L and -l options
belong in LDADD.
---

diff --git a/doc/automake.texi b/doc/automake.texi
index bdd615e2d..3cbbff250 100644
--- a/doc/automake.texi
+++ b/doc/automake.texi
@@ -4946,9 +4946,12 @@ and Lex}.
 
 If you need to link against libraries that are not found by
 @command{configure}, you can use @code{LDADD} to do so.  This variable is
-used to specify additional objects or libraries to link with; it is
-inappropriate for specifying specific linker flags; you should use
-@code{AM_LDFLAGS} for this purpose.
+used to specify additional objects or libraries to link with.
+Libraries to link with can be indicated either as file names or
+through @code{-L} and @code{-l} options.
+
+For other linker options (not @code{-L} or @code{-l}), @code{LDADD}
+is inappropriate.  You should use @code{AM_LDFLAGS} for this purpose.
 @vindex LDADD
 @vindex AM_LDFLAGS