autoconf: Configuration Links
1
1 4.11 Creating Configuration Links
1 =================================
1
1 You may find it convenient to create links whose destinations depend
1 upon results of tests. One can use `AC_CONFIG_COMMANDS' but the
1 creation of relative symbolic links can be delicate when the package is
1 built in a directory different from the source directory.
1
1 -- Macro: AC_CONFIG_LINKS (DEST:SOURCE..., [CMDS], [INIT-CMDS])
1 Make `AC_OUTPUT' link each of the existing files SOURCE to the
1 corresponding link name DEST. Makes a symbolic link if possible,
1 otherwise a hard link if possible, otherwise a copy. The DEST and
1 SOURCE names should be relative to the top level source or build
1 directory. This macro is one of the instantiating macros; see
1 ⇒Configuration Actions.
1
1 For example, this call:
1
1 AC_CONFIG_LINKS([host.h:config/$machine.h
1 object.h:config/$obj_format.h])
1
1 creates in the current directory `host.h' as a link to
1 `SRCDIR/config/$machine.h', and `object.h' as a link to
1 `SRCDIR/config/$obj_format.h'.
1
1 The tempting value `.' for DEST is invalid: it makes it impossible
1 for `config.status' to guess the links to establish.
1
1 One can then run:
1 ./config.status host.h object.h
1 to create the links.
1