cmulocal/README.andrew

   1 This is a collection of autoconf macros which've been written by
   2 various people at CMU.  To use it, use "aclocal -I cmulocal" (after
   3 the first time, automake should automatically use the -I cmulocal, if
   4 you've called CMU_INIT_AUTOMAKE in configure.in).
   5
   6 CMU_INIT_AUTOMAKE
   7   If you use automake, you should call this after AM_INIT_AUTOMAKE.
   8   It adds "-I cmulocal" to the aclocal command line, so that when
   9   automake runs aclocal, aclocal'll continue to pick up these macros.
  10
  11 CMU_ADD_LIBPATH
  12   Add -L(arg), and possibly -R(arg) (or whatever the runpath is) to
  13   LDFLAGS.
  14
  15 CMU_ADD_LIBPATH_TO
  16   Likewise to above, except adds it to the specified variable (arg 2).
  17
  18 CMU_GUESS_RUNPATH_SWITCH
  19   Attempts to guess what the runpath switch is (-R or whatever).
  20
  21 CMU_COMERR
  22   Requires that com_err exist in the collection (at CMU, do this by
  23   running "cvs checkout com_err", and adding com_err to DIST_SUBDIRS
  24   in your Makefile.am).
  25
  26   It sets the output variable COMPILE_ET to the compile_et program to
  27   use, and adds the appropriate paths to LDFLAGS and CPPFLAGS.
  28
  29   It does *not* add -lcom_err to LIBS (this would cause later library
  30   checks to fail if com_err needs to be built), so Makefiles need to
  31   explicitly add -lcom_err (which, after all, should always exist as
  32   long as the com_err compile doesn't blow up).  Makefiles should do
  33   this by using LIB_COMERR, which will substitute to the appropriate
  34   magic to use to grab the library.  (This may involve a libtool archive;
  35   you should be using libtool to link your program if you distribute
  36   libraries with it that the program may link against).
  37
  38   Note that com_err will only be compiled if the configure script
  39   can't find compile_et or libcom_err; if the system already has them,
  40   the configure script will use the system installation (although, due
  41   to some autoconf wonkiness, com_err will still be configured; it just
  42   won't show up in the @subdirs@ expansion).
  43
  44 CMU_NANA
  45   Adds --with-nana, set by default; if set, attempts to link against
  46   libnana.  If not set, or if libnana is unavailable, or if we're not
  47   using gcc, it defines WITHOUT_NANA.
  48
  49 CMU_PROG_LIBTOOL
  50   Just like AM_PROG_LIBTOOL, except it performs a couple little hacks
  51   to make sure that things don't break on picky vendor compilers
  52   which whine about empty translation units. [DEPRECATED - DO NOT USE]
  53
  54 CMU_PTHREADS
  55   This attempts to link against libpthread (failing if it can't be found),
  56   and attempts to do any system-specific setup required for thread
  57   support (for example, most things want _REENTRANT to be defined,
  58   but Solaris wants _POSIX_PTHREAD_SEMANTICS and __EXTENSIONS__, IRIX
  59   wants to see _SGI_REENTRANT_FUNCTIONS, etc).
  60
  61 CMU_SASL
  62   This tries to find a SASL library, and calls AC_SUBST on LIB_SASL
  63   if it finds one, or tells the user to go ftp it if it doesn't exist.
  64
  65   Provides --with-sasldir.
  66
  67 CMU_KRB4
  68   This attempts to find Kerberos 4 libraries and set up CFLAGS and LIBS
  69   appropriately. It also updates and substitutes RPATH for shared library
  70   stuff.
  71