mpack-1.6-4/cmulocal/README.andrew

This is a collection of autoconf macros which've been written by
various people at CMU.  To use it, use "aclocal -I cmulocal" (after
the first time, automake should automatically use the -I cmulocal, if
you've called CMU_INIT_AUTOMAKE in configure.in).

CMU_INIT_AUTOMAKE
  If you use automake, you should call this after AM_INIT_AUTOMAKE.
  It adds "-I cmulocal" to the aclocal command line, so that when
  automake runs aclocal, aclocal'll continue to pick up these macros.

CMU_ADD_LIBPATH
  Add -L(arg), and possibly -R(arg) (or whatever the runpath is) to 
  LDFLAGS.

CMU_ADD_LIBPATH_TO
  Likewise to above, except adds it to the specified variable (arg 2).

CMU_GUESS_RUNPATH_SWITCH
  Attempts to guess what the runpath switch is (-R or whatever).

CMU_COMERR
  Requires that com_err exist in the collection (at CMU, do this by
  running "cvs checkout com_err", and adding com_err to DIST_SUBDIRS
  in your Makefile.am).

  It sets the output variable COMPILE_ET to the compile_et program to
  use, and adds the appropriate paths to LDFLAGS and CPPFLAGS.

  It does *not* add -lcom_err to LIBS (this would cause later library
  checks to fail if com_err needs to be built), so Makefiles need to
  explicitly add -lcom_err (which, after all, should always exist as
  long as the com_err compile doesn't blow up).  Makefiles should do
  this by using LIB_COMERR, which will substitute to the appropriate
  magic to use to grab the library.  (This may involve a libtool archive;
  you should be using libtool to link your program if you distribute
  libraries with it that the program may link against).

  Note that com_err will only be compiled if the configure script
  can't find compile_et or libcom_err; if the system already has them,
  the configure script will use the system installation (although, due
  to some autoconf wonkiness, com_err will still be configured; it just
  won't show up in the @subdirs@ expansion).

CMU_NANA
  Adds --with-nana, set by default; if set, attempts to link against
  libnana.  If not set, or if libnana is unavailable, or if we're not
  using gcc, it defines WITHOUT_NANA.

CMU_PROG_LIBTOOL
  Just like AM_PROG_LIBTOOL, except it performs a couple little hacks
  to make sure that things don't break on picky vendor compilers
  which whine about empty translation units.

CMU_PTHREADS
  This attempts to link against libpthread (failing if it can't be found),
  and attempts to do any system-specific setup required for thread
  support (for example, most things want _REENTRANT to be defined,
  but Solaris wants _POSIX_PTHREAD_SEMANTICS and __EXTENSIONS__, IRIX
  wants to see _SGI_REENTRANT_FUNCTIONS, etc).

CMU_SASL
  This tries to find a SASL library, and calls AC_SUBST on LIB_SASL
  if it finds one, or tells the user to go ftp it if it doesn't exist.

  Provides --with-sasldir.

CMU_KRB4
  This attempts to find Kerberos 4 libraries and set up CFLAGS and LIBS
  appropriately. It also updates and substitutes RPATH for shared library 
  stuff.
1	jmc	1.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.
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.