To build, validate, and install this program on any UNIX, or
POSIX-compliant, system, with an ANSI/ISO Standard C compiler,
the canonical GNUware incantation

	./configure && make all check install

should suffice.

The programs have been successfully built, validated, and
installed using the above recipe at the development site on at
least these systems and compilers:

	DEC Alpha		OSF/1 3.2	'cxx -c cxx', c89, cc, gcc, g++, lcc
	HP 9000/735		HP-UX 10.01	c89, gcc
	IBM RS/6000		AIX 3.2		c89, gcc, xlC (IBM C++)
	IBM PowerPC		AIX 4.2		cc, gcc, g++, 'c89 -D_ALL_SOURCE', xlC (IBM C++)
	Intel Pentium II MMX	GNU/Linux 2.0.35  cc, gcc, lcc, g++
	NeXT Turbostation	Mach 3.3	cc, gcc, g++
	SGI Indigo/2		IRIX 5.3	'cc -ansi', lcc, gcc	
	SGI Origin 200		IRIX 6.4	CC, NCC, cc, c89, gcc, g++
	SGI Origin 2000		IRIX 6.5	CC, NCC, cc, c89
	Sun SPARC		SunOS 4.1.3	acc, gcc 
	Sun SPARC		Solaris 2.5, 2.6  cc, c89, gcc, lcc, CC, g++

If you wish to select a different compiler, and possibly,
compiler optimization flags, do it like this:

	env CC=c89 ./configure && make all check install OPT='-O5'

You can use either Standard C or C++ compilers; old-style K&R C
compilers are no longer supported.  [If you absolutely need this,
get the ansi2knr.c program from the Free Software Foundation
archives at ftp://prep.ai.mit.edu.]

To choose a different permanent installation location than the
default /usr/local, you can provide it to configure like this:

	./configure --prefix=/home/jones/local

or you can temporarily override it at install time like this:

	make install prefix=/home/jones/local

The prefix directory is only referenced at install time, so
configure-time specification is not necessary.

As with most GNUware, a directory structure under the prefix is
assumed; the default tree is:

	/usr/local/bin
	/usr/local/man/cat1
	/usr/local/man/man1
	/usr/local/share/lib/awkpretty/awkpretty-1.00

The last of these will be created automatically; the others are
assumed to exist.

Executable programs go into the bin directory, manual pages into
the man/man1 directory, and library files needed by the
executable programs at runtime into the
share/lib/awkpretty/awkpretty-1.00 directory.

On completion of "make install", these files should be in place
under the prefix:

	bin/awklex
	bin/awklex-1.00
	bin/awkpretty
	bin/awkpretty-1.00
	bin/awkunlex
	bin/awkunlex-1.00
	man/man1/awklex.1
	man/man1/awkpretty.1
	man/man1/awkunlex.1
	share/lib/awkpretty/awkpretty-1.00/awkpretty.awk
	share/lib/awkpretty/awkpretty-1.00/awkunlex.awk
	share/lib/awkpretty/awkpretty-1.00/globals.awk
	share/lib/awkpretty/awkpretty-1.00/sortfcn.awk

You can list them at any subsequent time by

	make install-show

There are version numbers attached to hard links to the programs in
the bin directory, so that it is possible to maintain multiple
simultaneous versions.

If you wish to completely remove an installed version, just do

	make uninstall

Because certain critical files (Makefile, config.h, config.hin,
configure) are automatically derived from others during
autoconfiguration, to allow recovery from a disaster of their
loss or damage, there are read-only backup copies in the save
subdirectory.

Brian Kernighan deserves all of the credit for awk, which lies
underneath awklex, awkunlex, and awkpretty.  Those three
programs, and the configuration, documentation, and packaging of
this distribution, were written by

 	Nelson H. F. Beebe
 	Center for Scientific Computing
 	University of Utah
 	Department of Mathematics, 322 INSCC
 	155 S 1400 E RM 233
 	Salt Lake City, UT 84112-0090
 	USA
 	Email: beebe@math.utah.edu, beebe@acm.org, beebe@ieee.org (Internet)
 	WWW URL: http://www.math.utah.edu/~beebe
 	Telephone: +1 801 581 5254
 	FAX: +1 801 585 1640, +1 801 581 4148

to whom bugs, comments, complaints, kudos, questions, and
suggestions should be communicated.  Please don't bother Brian
Kernighan with any questions about awklex, awkunlex, and
awkpretty.

Please note that the source code from Brian Kernighan's awk
distribution, which is included as part of the awkpretty
distribution, is governed by this copyright notice:

	/****************************************************************
	Copyright (C) Lucent Technologies 1997
	All Rights Reserved

	Permission to use, copy, modify, and distribute this software and
	its documentation for any purpose and without fee is hereby
	granted, provided that the above copyright notice appear in all
	copies and that both that the copyright notice and this
	permission notice and warranty disclaimer appear in supporting
	documentation, and that the name Lucent Technologies or any of
	its entities not be used in advertising or publicity pertaining
	to distribution of the software without specific, written prior
	permission.

	LUCENT DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
	INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.
	IN NO EVENT SHALL LUCENT OR ANY OF ITS ENTITIES BE LIABLE FOR ANY
	SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
	WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
	IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
	ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
	THIS SOFTWARE.
	****************************************************************/
