This document accompanies the FTP release of AFSDocumentFilter.service 1.21. It contains FTP download instructions, installation instructions. Please read this document in its entirety before installing AFSDocumentFilter.service 1.21, even if you're the kind of person who doesn't believe in instructions. You'll thank us later.
AFSDocumentFilter.service 1.21 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.
AFSDocumentFilter.service 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 AFSDocumentFilter.service 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.
AFSDocumentFilter.README - This document. Describes what to download and how to install it.
AFSDocumentFilter_Main.pkg.tar (NEXTSTEP 3.1 or later) or AFSDocumentFilter_Main_3.0.pkg.tar (NEXTSTEP 3.0) - The main bundle for the service which allows (PasteUp, ReadUp, WriteUp) to read and (WriteUp) to write foreign document formats. The basic service supports WriteNow importing, and ascii mail merge importing. For additional foreign document types, you must also download some or all of the extension filters listed below., mandatory.
Extension Filters - Provide support for importing and exporting foreign documents on specific hardware architectures. All of these files use the same naming convention:
AFSDocumentFilter_DocType_Arch.pkg.tar
'DocType' is an obvious abbreviation of the foreign document type, like MSWord, WordPerf, or AmiPro. 'Arch' is 'M' (Motorola/NeXT hardware), 'I' (Intel), 'H' (HPPA), or 'S' (SPARC). For example, the file
AFSDocumentFilter_MSWord_I.pkg.tar
contains all of the filters you need to read and write Microsoft Word documents when running on Intel hardware. The 'Graphics' package is a special case. It contains general graphics filters for formats that may be found in many different document types, like JPEG and BMP. This package is mandatory if your foreign documents contain graphics.
All of the extension filters are optional, based on your hardware architectures and foreign document needs. Sizes run from 300K to 1.3 MB.
Installing AFSDocumentFilter from FTP tar files
AFSDocumentFilter_Main.pkg or AFSDocumentFilter_Main_3.0.pkg - This package must be installed in a 'visible' services location, like /LocalLibrary/Services or ~/Library/Services. Since it's reasonably small, this package contains quad-FAT binaries. You can use Installer to strip out the architectures you don't need. AFSDocumentFilter.service is a functional replacement for the Igor.service provided with WriteUp 1.1 & PasteUp 2.5. Once you stop using WriteUp 1.1 (and PasteUp 2.5, if you also have that application), you can remove Igor.service from your system.
Extension Filters - These packages must be installed after AFSDocumentFilter_Main.pkg. You must be logged in as the same user, because these packages change files inside AFSDocumentFilter.service. The installation path is /[main_path], where [main_path] is the folder in which you installed AFSDocumentFilter.service. For each extension filter package, you will get a warning that it contains a post-installation script. In addition, if you install more than one architecture for the same document type, you may get a warning that certain files already exist. Both warnings are normal and must be allowed. Repeat the process for each extension filter set you need.
