Build System Maintainer Notes
-----------------------------

* most useful command:  "make dist"  this creates a release tarball

* most important command:  "make distcheck"  this creates a release
tarball, then builds and installs it in a temporary directory, just to
make sure things like building where srcdir != builddir work, and such.

* Makefile.am files contain all the intelligence.  Makefile.in and
Makefile are auto-generated, do not edit...

* autoconf, automake, and libtool packages required only for developers,
not end users.

* libtool, autoconf and automake manuals at: 
http://www.gnu.org/manual/manual.html

* use INCLUDES to set '-D' defines normally stuffed into the Makefile's
CFLAGS

* the source in 'acpica/subsystem' directory creates "libacpi".  Feel
free to change the name.

* libacpi shared library version number is set in Makefile.am, search
for '-version-info'

* if it doesn't make sense to have a shared library at all, it can
easily be disabled while leaving the libtool functionality intact. 
'info libtool', there is a section on disabling shared libraries.

* package version number is centralled maintained in configure.in. 
change this version number for each release.

* The autoconf portability file "ac-config.h" can be included into C
code.  You can use this to print out the special VERSION symbol (a
quoted string containing the version number from configure.in), or
access other autoconf portability defines.

* if you want to include a file in the tarball but it is not part of the
build, list it in the EXTRA_DIST variable in Makefile.am

end user 'quickstart':

	./configure
	make
	make install  # installs bin/acpi, sbin/acpid, and libraries
