NOTICE that neither the code nor the directions nor any advice in this
package is warranted fit or safe for any purpose.  There is a further
amplified notice in the patched directory (when you have patched it)
which you should read.

Little Scripts in `shadow' directory:

	convert.lower	(sh)	run by unpack etc.  Converts
				comp.sources.misc shar file
				names if they are upper-case
	sh_strip	(perl)	run by unpack-, unpack, unpack+go
				to filter comp.sources.misc shar sources,
				removing non-executable commentary
				(unpack etc. pipe through sh_strip leaving
				source unchanged)
	unpack-		(sh)	creates 3.3.1 source tree from
				part01.gz..part14.gz + patch01.gz
	unpack		(sh)	like unpack-, but also applies patches
				shadaut-3.3.1.df3 to give 3.3.1+ tree
	graduate	(sh)	given 3.3.1 source tree, patches to
				3.3.1+ level with shadaut-3.3.1.df3
	go+		(sh)	given 3.3.1 source tree, applies
				shadaut-3.3.1.df3, configures and
				compiles
	go		(sh)	given 3.3.1+ (patched) source tree,
				configures and compiles
	unpack+conf	(sh)	like unpack+go but doesn't compile
	unpack+go	(sh)	given comp.sources.misc gzipped
				shar files, creates and patches
				source tree, configures and compiles

This README is in the directory `shadow' which is created when you
untar shadaut-331df3.tgz.  It provides directions for a simple
patching and compilation which works on one Linux system and will
probably work on some other Un*x systems.  Within the patched
directory shadow-3.3.1+ (created by unpack or unpack+go or your hand
patching) there is a file named INSTALL which contains directions
for a more deliberate method of installation for Un*x systems in
general.  The diff file shadaut-3.3.1.df3 may be read with less as it
stands, so if you wish you may read INSTALL before doing anything
else.

The method of configuring and installing suggested here carries some
risks of getting a few things wrong.  You might have a look at
config.h.bot to see what they might be.  On the other hand, if
you follow the directions here to the letter, you will be able to
recover from any problems quite easily, and then adopt a more
conservative approach in the second attempt.

You may (after slight preparation - see below) run one of the sh
scripts unpack+go and go+ in this directory.  The script will create
and patch the source directory and then run the sh script `configure'
in that directory.  Finally it will run make to compile the sources.
Read INSTALL on make save before going on to make install.

| If you would prefer to avoid the use of these scripts and do
| everything by hand, *NOTE* that Makefile must be renamed Makefile.in
| and config.h must be renamed config.h.in before running configure.


(1)	Of course you need the shadow sources.  You may have
	obtained them in one of two forms, (a) as the files
	part01.gz .. part14.gz plus patch01.gz from comp.sources.misc
	(see the .lsm file), or (b) as a file with some name
	such as shadow-3.3.1.tar.gz.

(2)	In either case, place the file(s) in this directory
	shadow.  In case (b), gunzip and untar the file so that you
	have a subdirectory named shadow-3.3.1 in the present directory.

(3)	SU_PATH and U_PATH are the values of the $PATH variable
	for root and the ordinary user on my system.  Check that
	they are satisfactory for yours - change if necessary.

(4)	In case (a) do `sh unpack+go'.  (Alternatively, run `sh
	unpack-' followed by `sh go+', or `sh unpack' followed by
	`go', or unpack-, graduate, go.  These simply allow you to stop
        mid-stream if you feel like checking up on what is happening.)
	In case (b) run `sh go+' (or: graduate, go).

The last step takes some time.
The files patch01.errs, patch.errs and make.errs will appear.  They
are worth a look, especially the last.  Of course you must have a
sucessful compile before going further.

(5)	cd shadow-3.3.1+.  As root, run make save and make install (see
	INSTALL regarding make save).  Note the warning to stay root
	until you have checked that the new login works.  Edit
	/etc/login.defs - see INSTALL regarding this.  Log in as
	root on another VT to prove that you can.

(6)	Read WHATNEXT.  Use pwconv and mkpasswd to complete the
	installation.


CHANGES from Version 1.2 to Version 1.3

Applied patch to fix the -froot bug.  Gary Anderson (ganderson@clark.net)
send me this patch which was posted by John Haugh to comp.os.linux.dev-
elopment on 3 June 1994.  Forced ci of all main programs to indicate
that: binaries with RCS Id dated 1995/07/11 "mike Exp" or later have
the fix applied.

CHANGES from Version 1.1 to Version 1.2

Changed the message displayed at the end of the run in go and go+
bringing it into conformity with that in unpack+go.
Deleted ineffective PATH setting in unpack.

CHANGES from Version 1 to Version 1.1

All known bugs have been fixed. Thanks to the following who found some and
sent diffs:
	dabn100@hermes.cam.ac.uk (Dirk Niggeman)
	duval@lorien.wlu.edu (Danek Duval)
As well, redundant macros have been removed, and there have been some
cosmetic changes - a bit of a cleanup.  I have appended to the file WHATNEXT
a News item once posted by longyear@netcom.com (Al Longyear) listing more
programs that (if you need them at all) may have to be made Shadow aware.

$Id: README,v 2.2 1995/07/12 08:14:39 mike Exp $
