README.rst: reformat the "Links" section
[ncmpc-debian.git] / m4 / ax_append_link_flags.m4
1 # ===========================================================================
2 #   http://www.gnu.org/software/autoconf-archive/ax_append_link_flags.html
3 # ===========================================================================
4 #
5 # SYNOPSIS
6 #
7 #   AX_APPEND_LINK_FLAGS([FLAG1 FLAG2 ...], [FLAGS-VARIABLE], [EXTRA-FLAGS], [INPUT])
8 #
9 # DESCRIPTION
10 #
11 #   For every FLAG1, FLAG2 it is checked whether the linker works with the
12 #   flag.  If it does, the flag is added FLAGS-VARIABLE
13 #
14 #   If FLAGS-VARIABLE is not specified, the linker's flags (LDFLAGS) is
15 #   used. During the check the flag is always added to the linker's flags.
16 #
17 #   If EXTRA-FLAGS is defined, it is added to the linker's default flags
18 #   when the check is done.  The check is thus made with the flags: "LDFLAGS
19 #   EXTRA-FLAGS FLAG".  This can for example be used to force the linker to
20 #   issue an error when a bad flag is given.
21 #
22 #   INPUT gives an alternative input source to AC_COMPILE_IFELSE.
23 #
24 #   NOTE: This macro depends on the AX_APPEND_FLAG and AX_CHECK_LINK_FLAG.
25 #   Please keep this macro in sync with AX_APPEND_COMPILE_FLAGS.
26 #
27 # LICENSE
28 #
29 #   Copyright (c) 2011 Maarten Bosmans <mkbosmans@gmail.com>
30 #
31 #   This program is free software: you can redistribute it and/or modify it
32 #   under the terms of the GNU General Public License as published by the
33 #   Free Software Foundation, either version 3 of the License, or (at your
34 #   option) any later version.
35 #
36 #   This program is distributed in the hope that it will be useful, but
37 #   WITHOUT ANY WARRANTY; without even the implied warranty of
38 #   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
39 #   Public License for more details.
40 #
41 #   You should have received a copy of the GNU General Public License along
42 #   with this program. If not, see <http://www.gnu.org/licenses/>.
43 #
44 #   As a special exception, the respective Autoconf Macro's copyright owner
45 #   gives unlimited permission to copy, distribute and modify the configure
46 #   scripts that are the output of Autoconf when processing the Macro. You
47 #   need not follow the terms of the GNU General Public License when using
48 #   or distributing such scripts, even though portions of the text of the
49 #   Macro appear in them. The GNU General Public License (GPL) does govern
50 #   all other use of the material that constitutes the Autoconf Macro.
51 #
52 #   This special exception to the GPL applies to versions of the Autoconf
53 #   Macro released by the Autoconf Archive. When you make and distribute a
54 #   modified version of the Autoconf Macro, you may extend this special
55 #   exception to the GPL to apply to your modified version as well.
56
57 #serial 5
58
59 AC_DEFUN([AX_APPEND_LINK_FLAGS],
60 [AX_REQUIRE_DEFINED([AX_CHECK_LINK_FLAG])
61 AX_REQUIRE_DEFINED([AX_APPEND_FLAG])
62 for flag in $1; do
63   AX_CHECK_LINK_FLAG([$flag], [AX_APPEND_FLAG([$flag], [m4_default([$2], [LDFLAGS])])], [], [$3], [$4])
64 done
65 ])dnl AX_APPEND_LINK_FLAGS