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


                        WriteUp 1.21 FTP instructions

WriteUp 1.21 is more than just a word processor; it has evolved into a comprehensive document handling environment. As a result, you will probably have to download more than one package to get everything you need. 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 WriteUp@afs.com, by phone at +1-215-653-0911, or by fax at +1-215-653-0711.

WriteUp 1.21 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 WriteUp 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.

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

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

WriteUpHPPA.tar - The WriteUp HPPA binary, if you also want to run WriteUp on HPPA hardware. 1MB, optional.

WriteUpSPARC.tar - The WriteUp SPARC binary, if you also want to run WriteUp on SPARC hardware. .9MB, optional.

WriteUpFrench.tar - Contains the French User interface (French.lproj & dictionary).

WriteUpGerman.tar - Contains the German User interface (German.lproj & dictionary).

WriteUp_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.

WriteUpSamples.pkg.tar - Sample templates, sample graphics, and source documents to run the tutorials in the user manual. 350K, optional.

WriteUpASCIIFilter.pkg.tar - A service which allows native WriteUp 'wub' files to be indexed by Digital Librarian. 125K, optional.

WriteUpLibrarianIcons.pkg.tar - A few small icons which will appear next to WriteUp document names in Digital Librarian file browsers. 32K, optional.

AFSDocumentFilter_Main.pkg.tar (NEXTSTEP 3.1 or later) or AFSDocumentFilter_Main_3.0.pkg.tar (NEXTSTEP 3.0) - MANDATORY - see AFSDocumentFilter.README

                 Installing WriteUp 1.21 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 to a temporary directory like /tmp,  you need to 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.

WriteUp.pkg - This package must be installed in a 'visible' applications location, like /LocalApps or ~/Apps. If you are already using a copy of WriteUp 1.1 or WriteUp 1.0, be sure you have a good backup (or access to the original disks) before installing this package over the old version. WriteUp.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.

WriteUpHPPA.pkg and WriteUpSPARC.pkg - If you need a tri-FAT or quad-FAT version in a networked environment, install these packages after WriteUp.pkg. You must be logged in as the same user who installed WriteUp.pkg, because these packages change files inside the WriteUp.app wrapper. The installation path is /[main_path]/WriteUp.app/, where [main_path] is the folder in which you installed WriteUp.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)

WriteUp_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 WriteUp.app with thin versions. You must be logged in as the same user who installed WriteUp.pkg, because this package change files inside the WriteUp.app wrapper. The installation path is /[main_path]/WriteUp.app/, where [main_path] is the folder in which you installed WriteUp.app. (SEE NOTE at end of installation instructions)

WriteUpFrench.tar - You must be logged in as the same user who installed WriteUp.pkg, because this package changes files inside the WriteUp.app wrapper. The installation path is /[main_path], where [main_path] is the folder in which you installed WriteUp.app. 

WriteUpGerman.tar - You must be logged in as the same user who installed WriteUp.pkg, because this package changes files inside the WriteUp.app wrapper. The installation path is /[main_path], where [main_path] is the folder in which you installed WriteUp.app.

WriteUpASCIIFilter.pkg - This package must be installed in a 'visible' services location, like /LocalLibrary/Services or ~/Library/Services. Since it's small, this package contains a quad-FAT binary. You can use Installer to strip out the architectures you don't need.

WriteUpLibrarianIcons.pkg - This package must be installed as root, because it adds a few icons to the Images folder inside /NextApps/Librarian.app. If every host on a network has a common mount point for /NextApps, you only need to install this package once. If every host has its own private copy of /NextApps on a local hard disk, this package must be installed on each machine individually.

WriteUpSamples.pkg - This package contains source documents for the tutorials in the user manual, plus some creative ideas about using templates and graphics. This package should be installed in /LocalLibrary/WriteUp or ~/Library/WriteUp.

Language dictionaries - If you previously installed a language dictionary in WriteUp 1.0 or 1.1, at this point you should find that disk and reinstall it. The FTP site does not have foreign dictionary packages at this time. If you need a foreign language dictionary, contact AFS and we will send it to you directly.

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