Build and install instructions for osh-20080629!

SYNOPSIS
	env [variable=value ...] make [target ...]
	make [variable=value ...] [target ...]

If the defaults described below match your desires and/or the
requirements of your system, you can build and install the entire
osh package by doing the following.

	% make
	# make install

...
Otherwise, continue reading for full build and install details.
See the EXAMPLES section at the end of this file for additional
help if needed.

---------
VARIABLES
The Makefile defines the following configuration variables (default
value listed).  The user can modify the default configuration by
passing the desired variable=value pair(s) on the command line.

	PREFIX		Defaults to /usr/local.  This is the target
			directory where BINDIR, MANDIR, and SYSCONFDIR
			are located by default.

	BINDIR		Defaults to $(PREFIX)/bin.  This is the target
			directory where the binaries are installed.

	MANDIR		Defaults to $(PREFIX)/man/man1.  This is the
			target directory where the manual pages are
			installed.

	SYSCONFDIR	Defaults to $(PREFIX)/etc.  This is the target
			directory where the shell shall search for its
			system-wide rc (init and logout) files if such
			files are available on the system.  See also:

				http://v6shell.org/rc_files/

			...
			for example rc files.

	DESTDIR		Unset by default.  This may be used for
			building binary packages if needed.

	INSTALL		Defaults to /usr/bin/install.  The install(1)
			utility is used to copy the resulting binaries
			and manual pages to their final targets.

Mac OS X only:
The following configuration variable specifies the desired target
architecture(s) for compiling universal binaries and/or 64-bit
binaries and/or 32-bit binaries for Mac OS X running on Intel and
PowerPC Macs.

	MOXARCH		Unset by default.  Possible value(s) may be
			one or more of the following: -arch x86_64,
			-arch ppc64, -arch i386, -arch ppc.
			See also EXAMPLES.

-------
TARGETS
The following targets are available.

	all		Default target is the same as typing `make'.
			Compiles everything.

	install		Installs all binaries and manual pages.

	oshall		Compiles osh, if, goto, and fd2.

	install-oshall	Installs oshall binaries and manual pages.

	sh6all		Compiles sh6, glob6, if, goto, and fd2.

	install-sh6all	Installs sh6all binaries and manual pages.

	clean-obj	Removes all object files.

	clean		Removes all binaries, object files, and other
			files generated during the build.

--------
EXAMPLES
The following example compiles osh, if, goto, and fd2 for /opt/local.
It then installs these binaries into /opt/local/bin, their manual
pages into /opt/local/man/man1, and also sets SYSCONFDIR to
/opt/local/etc.

	% make PREFIX=/opt/local oshall
	# make PREFIX=/opt/local install-oshall

The following example compiles sh6, glob6, if, goto, and fd2 for
/usr/pkg.  It then installs these binaries into /usr/pkg/bin, their
manual pages into /usr/pkg/man/man1, and also sets SYSCONFDIR to
/usr/pkg/etc.

	% make PREFIX=/usr/pkg sh6all
	# make PREFIX=/usr/pkg install-sh6all

The following example compiles everything, configuring the shell to
search for its system-wide rc files in /etc instead of /usr/local/etc
by default.  It then installs the entire osh package into the
default location.

	% make SYSCONFDIR=/etc
	# make install

The following example compiles each program as a 2-way 32-bit
universal binary for Mac OS X running on Intel and PowerPC Macs.
It then installs the entire osh package into the default location.

	% make MOXARCH='-arch i386 -arch ppc'
	# make install

Jeffrey Allen Neitzel						2008/06/25

@(#)$Id: INSTALL 463 2008-06-25 17:21:05Z jneitzel $
