GNU Automake

1.  Summary

	This fast-track introduces GNU Automake, versions 1.9.6 and 1.10,	
	into the Solaris WOS.

	Patch release binding is requested.

2.  Discussion

	Automake is a utility for generating Makefiles and is very
	commonly used when building open-source software.  It is often
	used in conjunction with other "auto tools" such as autoconf,
	autoheader and libtool to make it easier to build applications
	on different platforms.

	The two versions proposed here are included with the CBE tools
	for JDS, which are available for download from opensolaris.org.

	Version 1.9 of Automake is still explicitly required to build some
	JDS components.  Therefore this proposal will provide 1.9.6 and
	the latest stable version, 1.10, which will be the default.  It
	is normal practise for Linux distros to include multiple versions
	of Automake.  For example, both Red Hat Enterprise Linux 4 and
	Fedora Core 6 install five separate versions by default.  As
	Automake installs most of its files in version-suffixed
	sub-directories (eg /usr/share/automake-1.10) and as there are
	no shared object libraries included, this approach is considered
	safe.

	Due to the mutliple versions required and allowing for the
	possibility that further additional versions may be required in
	future, Automake will be delivered in two packages whose names
	indicate the version (ie SUNWgnu-automake-19 and
	SUNWgnu-automake-110).

	Automake is delivered as:
	- Two command-line programs, automake and aclocal.
	  These Perl scripts will be installed in /usr/bin with version
	  suffixes (eg automake-1.9) and with the unsuffixed name linking
	  to the most recent version (eg aclocal -> aclocal-1.10).
	  As future versions of Automake are integrated, these links
	  should be changed to always point to the latest installed
	  version.

	- A number of private scripts to be installed in
	  /usr/share/automake-$VERSION/

	- A private set of Perl modules to be installed in
	  /usr/share/automake-$VERSION/Automake/

	- A private set of Automake macros to be installed in
	  /usr/share/automake-$VERSION/am/

	- A private set of M4 macros to be installed in
	  /usr/share/aclocal-$VERSION/

	- A user manual in Info format (only for latest version)

	- A text file listing directories to search for macros:
	  /usr/share/aclocal/dirlist
	  (Note: aclocal dir is different from aclocal-$VERSION.)

	- Some demo files

	In addition, other components may install M4 macros to be used by
	aclocal when building yet other components which depend on them.
	The locations /usr/share/aclocal/ and /usr/sfw/share/aclocal/
	are currently used by Solaris packages for this purpose.  For
	example, SUNWgnome-base-libs-devel installs
	/usr/share/aclocal/gtk-2.0.m4.  These directories may be specified
	by command-line options to aclocal, or by listing them in the
	`dirlist' file.  dirlist will be installed with the single value:
		/usr/sfw/share/aclocal
	(/usr/share/aclocal and /usr/share/aclocal-$VERSION do not need
	to be specified).  This file may be edited to add additional
	default directories.

	An earlier version of Automake (1.8.3) is currently available in
	the Solaris Companion CD (CCD).  This proposal removes Automake
	from the CCD and adds it to the SFW consolidation.

	This proposal will install the utilities in /usr, as per the
	guidelines of PSARC/2007/047, /usr/gnu [1].

3.  Interfaces

	Exported Interfaces
	===================
	SUNWgnu-automake-110		Uncommitted	Package name
	SUNWgnu-automake-19		Uncommitted	Package name

	/usr/bin/automake-1.10		Uncommitted	Command
	/usr/bin/automake		Uncommitted	Symbolic link
	/usr/bin/aclocal-1.10		Uncommitted	Command
	/usr/bin/aclocal		Uncommitted	Symbolic link
	/usr/bin/automake-1.9		Uncommitted	Command
	/usr/bin/aclocal-1.9		Uncommitted	Command

	/usr/share/info/automake.info	Uncommitted	Info document

	/usr/share/aclocal/dirlist	Uncommitted	Macro search paths


4.  References

	[1] S. Hahn, B. Smaalders, and R. Orth, PSARC/2007/047: /usr/gnu


ATTACHED MATERIALS

	automake.info
	automake.info-1
	automake.info-2