Overview
========
This program updates your copy of HyperCard 2.3 and the StackToApp stack translator to version 2.3.5 and installs updated versions of four HyperCard stacks. From time to time, Apple produces maintenance releases of software to add minor functionality, fix defects or respond to customer requests. Our goal with this updater is to make it as convenient as possible for you to obtain the enhanced functionality in HyperCard 2.3.5.
This document tells you how to install the HyperCard 2.3.5 update to HyperCard 2.3, and describes what benefits it offers. Please read this entire "Read Me" file. It contains important information and tips that will enhance your experience with HyperCard 2.3.5. We recommend that you print a copy for reference.
This updater will NOT work on versions 2.2 or earlier of HyperCard. It will also not work with the HyperCard Player application. If you need to upgrade your copy of HyperCard call (800) 950-2442 for the Apple Reseller nearest you. To order HyperCard directly from APDA, if you are in the United States, call (800) 282-2732.
It is recommend that you update to system software version 7.5.3 or later in order take advantage of improvements to the latest versions of PlainTalk, the Sound Manager, and Macintosh Easy Open.
It is recommended that you make a backup copy of your HyperCard folder before installing this update.
You'll need enough room for both the original application and the new version (approximately 2.6 MB of disk space for both).
To install the HyperCard 2.3.5 update follow these steps:
Easy Install
============
* Double-click on the "Install HC 2.3.5 Update" application to open it.
* Make sure that "Easy Install" is selected in the pop-up menu in the upper left-hand corner of the window.
* Select the folder where HyperCard 2.3 resides using a button labeled "Select Folder" or by choosing "Select Folder" in a pop-up menu that appears toward the bottom of the window (this will be the case if you have more than one disk mounted). When the folder containing HyperCard 2.3 is highlighted in the standard file dialog, click the "Select" button to select it.
* Click the "Install" button to install the new software and perform the update of your HyperCard application.
* During the installation, you will be asked if you wish to replace copies of the Power Tools and Readymade Buttons stacks if they are present. If you have made changes to these stacks that you'd like to preserve, click the "Skip" button to skip replacing each of these. If you wish to replace the stack, click the "Replace" button. If you wish to replace both of these stacks, click the "Replace All" button in the dialog that appears. You can install any of these stacks later using the Custom Install feature of the Installer (see below).
* After the installation has completed you will be asked if you wish to quit the installer or continue. If you wish to install the update into any other folders containing HyperCard 2.3, click "Continue."
* After the installation completes, you will now have version 2.3.5 of the StackToApp translator, 2.3.5 versions of the Audio Help, Color Tools, Power Tools, and Readymade Buttons stacks, a Read Me document, HyperCard updated to version 2.3.5, your old version of HyperCard renamed HyperCard.old, and an application for updating other copies of the HyperCard 2.3 application to version 2.3.5. Please see the instructions below for using this updater application.
Note: If the copy of HyperCard in the folder you selected is not version 2.3, you will get an error message at the end of the installation indicating that an invalid file was selected for updating.
Custom Install
==============
* Double-click on the "Install HC 2.3.5 Update" application to open it if necessary.
* Make sure that "Custom Install" is selected in the pop-up menu that appears in the upper left-hand corner of the window.
* Select the folder where HyperCard resides using a button labeled "Select Folder" or by choosing "Select Folder" in a pop-up menu (this is the case if you have more than one disk mounted). When the folder containing HyperCard appears in the standard file dialog, click the "Select" button to select it.
* Select the software you wish to install by clicking the checkbox next to its name. You can click the triangle next to the HyperCard Stacks items to see more choices.
* Click the "Install" button to install the new software into the folder you selected.
How to use the HyperCard 2.3.5 Updater Application
==================================================
* Double-click on the "HyperCard 2.3.5 Updater" application to open it.
* You will be shown a Read Me document which you may print or save. After you've read the Read Me document. Click the "Continue" button.
* The updater will search for copies of HyperCard 2.3 on any mounted disk to update.
* Select a copy of HyperCard.
* Click the "Update" button.
* You may continue updating as many copies of HyperCard 2.3 that are present, as you wish.
Note: Any copies of the 2.3 version of the HyperCard Player that are present will be shown. The HyperCard Player cannot be updated to version 2.3.5. If you'd like to obtain a copy of the 2.3.5 version of the HyperCard Player from an Apple FTP site you may use the following Internet address:
ftp://ftp.info.apple.com/Apple_Support_Area/Apple.Software.Updates/
US/Macintosh/Utilities/HyperCard_Player_2.3.5.sea.hqx
HyperCard 2.3.5 Update Release Notes
====================================
Changes in HyperCard
--------------------
- HyperCard's performance on machines with large numbers of fonts installed has been vastly improved, particularly on Macintosh computers with PowerPC microprocessors.
- A problem that caused the text of fields to be printed at the resolution of the screen instead of the resolution of the printer has been fixed.
- Problems that caused selections within list fields to be displayed incorrectly have been fixed.
- The "Link To" button in the Button Info dialog once again appears on all systems.
Changes in StackToApp
---------------------
- A problem that caused standalones to be created with a corrupted version of the AddColor external has been fixed.
Changes in the Color Tools Stack
--------------------------------
- A problem was fixed that prevented stacks colorized with Color Tools 2.3 on a Macintosh computer with a PowerPC microprocessor from being used on a different Macintosh computer with a PowerPC microprocessor.
- The Color Tools now work more reliably on Macintosh systems that have the Japanese Language Kit or the Chinese Language Kit installed.
- The "Redraw Screen" command now works properly with stacks that have been colorized with other versions of the Color Tools.
- The "Compact Color Database" command now works properly with colorized cards and backgrounds whose IDs are greater than 32767.
Changes in the Audio Help Stack
-------------------------------
The following changes were made to the Audio Palette to make it work properly on newer Macintosh models, including the Power Macintosh 7200, 7500, 8500, and 9500.
- The Audio Palette now records at the following qualities: Good (22 kHz, 6-to-1 compression), Better (22 kHz, 3-to-1 compression), and Best (22 kHz, no compression). This is a change from older versions of the Audio Palette, which recorded at Good and Best qualities and had a different idea of Good quality (11 kHz, no compression).
- There is now a one-to-one correspondence between compression and quality settings. "No compression" is synonymous with "Best quality," "3-to-1 compression" with "Better quality," and "6-to-1 compression" with "Good quality."
- You can still open and edit sounds recorded with the old Audio Palette at its "Good" quality. When you do this, the new Audio Palette displays the quality as "Other".
- From a script, you can still set the "speed" property of the Audio Palette to "11k". This will allow you to use the old "Good" quality. When you do this, the new Audio Palette displays the quality as "Other".
- The Audio Palette has a new property, "quality". From a script, you can set this property to "Good", "Better", or "Best".
- The documentation in the Audio Help stack has been updated to reflect the changes in the Audio Palette.
Changes in the Power Tools Stack
--------------------------------
- The Super Grouper tool now works more reliably with a wider range of stacks.
- Starting with HyperCard 2.3, the option that allows the Picture XCMD to display a picture from the clipboard requires that the word "clipboard" be quoted, as follows:
Picture "From The Clipboard","clipboard"
The documentation in the Power Tools stack has been updated to reflect this change.
Changes in the Readymade Buttons Stack
--------------------------------------
- The "Show Clipboard Picture" button on the card that demonstrates how to hide and show pictures now works properly.