Next: , Previous: , Up: The programmer's view   [Contents][Index]

3.3 Link options

The library to link with is called libtextstyle, with a system-dependent suffix. You link with it though link options of the form -ltextstyle for a library installed in system locations, or -Llibdir -ltextstyle for a static library installed in other locations, or -Llibdir -ltextstyle -Wl,-rpath,libdir for a shared library installed in other locations (assuming a GCC compatible compiler and linker and no libtool), or -Llibdir -ltextstyle -Rlibdir for a shared library installed in other locations (with libtool). Additionally, the link options may need to include the dependencies: -lm, and -lncurses or (on NetBSD) -ltermcap or (on AIX) -lxcurses or (on HP-UX) -lcurses, and on some systems also -liconv.

It is a bit complicated to determine the right link options in a portable way. Therefore an Autoconf macro is provided in the file libtextstyle.m4 in Gnulib, that makes this task easier. Assuming the build system of your package is based on GNU Autoconf, you invoke it through gl_LIBTEXTSTYLE. It searches for an installed libtextstyle. If found, it sets and AC_SUBSTs HAVE_LIBTEXTSTYLE=yes and the LIBTEXTSTYLE and LTLIBTEXTSTYLE variables, and augments the CPPFLAGS variable, and #defines HAVE_LIBTEXTSTYLE to 1. Otherwise, it sets and AC_SUBSTs HAVE_LIBTEXTSTYLE=no and LIBTEXTSTYLE and LTLIBTEXTSTYLE to empty. In link commands that use libtool, use LTLIBTEXTSTYLE; in link commands that don’t use libtool, use LIBTEXTSTYLE.

If you use GNU Automake, the proper place to use the link options is program_LDADD for programs and library_LIBADD for libraries.