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