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	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.