This document accompanies the FTP release of ReadUp 1.0. It contains FTP download
instructions, installation instructions. Please read this document in its entirety before
using ReadUp 1.0, even if you're the kind of person who doesn't believe in instructions.
You'll thank us later. 


                        ReadUp 1.0 FTP instructions

This document describes what is available so you can decide in advance what to get from the
FTP site. It is assumed you are already familiar with FTP procedures. If you have any trouble
downloading or installing the application, please contact AFS by email at ReadUp@afs.com, by
phone at +1-215-653-0911, or by fax at +1-215-653-0711. 

ReadUp 1.0 is stored on ftp.cs.orst.edu in the /software/NeXT/demos/productivity directory. We
have tried to provide flexibility in how much you need to download, without making the
installation process overly time-consuming or burdensome. Items marked 'Mandatory' below must
be downloaded and installed in order for ReadUp to work correctly. Items marked 'Optional'
only need to be downloaded if your site requires them, based on hardware architectures and
other word processors in use. 

ReadUp.README - This document. Describes what to download and how to install it.

ReadUp.tar - The ReadUp application: Motorola and Intel binaries, on-line help system, and
import/export bundle. 2.4MB, mandatory. 

ReadUpHPPA.tar - The ReadUp HPPA binary, if you also want to run ReadUp on HPPA hardware. 1MB,
optional. Gets installed inside of ReadUp.app. 

ReadUpSPARC.tar - The ReadUp SPARC binary, if you also want to run ReadUp on SPARC hardware.
.9MB, optional. Gets installed inside of ReadUp.app. 

ReadUp_NS3.0.tar - If you are still running NEXTSTEP 3.0, this overlay package is mandatory,
because NS3.0 cannot load FAT dynamic bundles. 125K. Gets installed inside of ReadUp.app. 

AFSDocumentFilter_Main.pkg.tar (NEXTSTEP 3.1 or later) or AFSDocumentFilter_Main_3.0.pkg.tar
(NEXTSTEP 3.0) - MANDATORY - see AFSDocumentFilter.README
	
                 Installing ReadUp 1.0 from FTP tar files

To provide consistency with disk-based installations, the FTP files are simply tarred versions
of the Installer.app packages supplied on physical media. After downloading all of the
packages you need to a temporary directory like /tmp, untar them with the Workspace
File->Decompress option. This action will turn them into Installer.app packages. The rest of
this document describes the order in which the pieces should be installed, plus preferred
installation locations. 

ReadUp.pkg - This package must be installed in a 'visible' applications location, like
/LocalApps or ~/Apps. ReadUp.pkg contains Motorola and Intel binaries. If you only need one
architecture, you can use Installer to strip out the one you don't need. 

ReadUpHPPA.pkg and ReadUpSPARC.pkg - If you need a tri-FAT or quad-FAT version in a networked
environment, install these packages after ReadUp.pkg. You must be logged in as the same user
who installed ReadUp.pkg, because these packages change files inside the ReadUp.app wrapper.
The installation path is /[main_path]/ReadUp.app/, where [main_path] is the folder in which
you installed ReadUp.app. You will get a warning that the package contains a post-installation
script; this is normal and must be allowed.  (SEE NOTE at end of installation instructions) 

ReadUp_NS3.0.pkg - If you are still running NEXTSTEP 3.0, you MUST install this overlay
package after the main app. NS3.0 does not understand how to load dynamic bundles with
multi-architecture binaries ('FAT' files). This package replaces a few FAT bundles inside
ReadUp.app with thin versions. You must be logged in as the same user who installed
ReadUp.pkg, because this package change files inside the ReadUp.app wrapper. The installation
path is /[main_path]/ReadUp.app/, where [main_path] is the folder in which you installed
ReadUp.app. (SEE NOTE at end of installation instructions) 

This completes the basic installation process. Now, to ensure that Workspace picks up all the
new filter services, logout and log back in. If you will be registering a site license, you
must log back in as the user who installed the application. Launch WriteUp.app and wait for
the registration panel. If you don't have a license key, you can ignore this panel and run in
demo mode, which will disable saving and printing. Otherwise, enter your name, company, and
license key in the fields on the license panel. If the key is valid, the panel will provide
details of the license entitlements. The app is ready to run! 

NOTE:(for packages that get installed into ReadUp.app)

	When installing into a location other than the default, you should make sure the
install path contains ReadUp.app as the last branch of the path. If you set the path by
clicking the set button you will need to select ReadUp.app and add a forward slash (/) before
finishing your selection.