WD98: Macintosh: Contents of the Bookshelf 98 Read Me

ID: Q186825


The information in this article applies to:


SUMMARY

The "Bookshelf 98 Read Me" is a SimpleText file that contains supplemental information about installing and using Microsoft Bookshelf 98 for Macintosh. The More Information section of this article contains the complete text of this file, which is located in the Bookshelf 98 folder on your Macintosh hard disk after you install Microsoft Bookshelf 98.


MORE INFORMATION


Microsoft Bookshelf 98 Read Me
------------------------------

This file contains information on the following topics:

   1. SYSTEM REQUIREMENTS FOR RUNNING MICROSOFT BOOKSHELF
         - What you need to run Bookshelf 98
   2. MEMORY USE
         - Memory needed to run Bookshelf 98
         - Running on low-memory machines
   3. PERFORMANCE
         - Tips on how to increase Bookshelf's speed
   4. SCREEN SIZES AND COLOR CONFIGURATION
         - What makes Bookshelf 98 look best
   5. SOUND PROBLEMS
         - Common problems playing sounds and how to fix them
   6. PRINTING AND COPYING
         - How to print and copy information from Bookshelf 98
   7. SCRIPTING
         - How to automate Bookshelf 98 using AppleScript
   8. TROUBLESHOOTING
         - Known problems and ways to work around them
   9. SPECIAL INFORMATION ABOUT INTERNET CONFIG
         - Information on how Bookshelf 98 uses Internet Config to access
           the Internet.


SYSTEM REQUIREMENTS FOR RUNNING MICROSOFT BOOKSHELF
---------------------------------------------------

To install and run Microsoft(r) Bookshelf(r) 98 you need:

 - Any Apple Power Macintosh or Macintosh with a 25 MHz 68030 processor
   (or faster) (includes Macintosh IIci, LCIII, Performa 450 and later
   models)
 - Monitor supporting at least 256 colors and 640x480 or higher resolution
 - System 7.1 or later
 - At least 8 MB of random-access memory (RAM) (12MB is recommended for
   System 7.5 and above)
 - Double-speed (or faster) CD-ROM drive

You can run Bookshelf 98 directly from the compact disc. To play the movies
and hear the sounds, QuickTime(tm) 2.0 or later must be installed in your
System Folder. If Bookshelf 98 can't find these files, it will prompt you
to run the Installer. You can also install QuickTime manually by dragging
the files from the System Files folder on the CD onto your System Folder
icon.

The Bookshelf 98 Installer will add all necessary files to your System
Folder. It will also copy the Bookshelf 98 program to a folder on your hard
disk titled "Bookshelf 98". Installing the application on to your hard
drive occupies about 8 MB of hard drive space, it makes the program launch
and run noticeably faster. All text, sounds, and images remain on the
Bookshelf 98 disc, so you still need to insert the compact disc to run
Bookshelf.

For a record of which files get installed, check the Installer Log File
created by the Bookshelf 98 Installer on the top level of your hard drive.

Note: Some virus protection software may confuse the Installer program's
necessary actions with behaviors associated with a virus, possibly
disrupting the installation process. It is recommended that you disable any
virus protection software before installing Bookshelf 98, then reenable it
after the installation.

MEMORY USE
----------

Bookshelf 98 will run on any Macintosh with 8 MB of RAM. However, if 4 MB
of memory are not free when you launch the application, a warning message
will be displayed indicating there is insufficient memory available.

Most systems with 8 MB of RAM will not experience problems, but if your
system software uses more than 4 MB you may need to adjust memory usage for
Bookshelf 98 to run properly. If you have System 7.5 or greater installed
on your computer, your system software may take up more than 6 MB of RAM.
For users running System 7.5 or greater, we recommend at least 12 MB of
RAM.

Some general suggestions for optimizing memory usage follow:

 - Run only one application at a time. If other applications are running,
   close them, and then relaunch Bookshelf.

 - Turn on Virtual Memory. Virtual Memory allows you to increase the amount
   of available memory by using space on your computer's hard disk to
   simulate RAM. Although using virtual memory may slow down performance,
   the extra available memory may cause applications like Bookshelf 98 to
   be allocated more memory at start up or allow more applications to be
   run simultaneously. To turn on Virtual Memory, open the Memory control
   panel, switch the Virtual Memory radio button to on, and then restart
   your computer.

 - Reduce the amount of memory being used by your system software. To do
   this, return to the Finder and select About This Macintosh... (or About
   This Computer... if you're running System 7.5.5 or later) from the Apple
   menu at the top left corner of the screen. The Largest Unused Block
   needs to be greater than 4096K to run Bookshelf 98. If the only item
   listed in the About This Macintosh dialog is System Software and the
   Largest Unused Block is less than 4096K, reduce the amount of memory
   used by your system software. Refer to your Macintosh documentation for
   details on how to do this, but some general suggestions follow:

      a. Open the Memory Control Panel and check the Disk Cache setting.
         Set the Disk Cache setting to the lowest amount possible. For more
         details on Disk Cache settings, check the PERFORMANCE section.

      b. Fonts and sounds use system memory. You can make more memory
         available by removing those you aren't using. However, make sure
         that you leave the Arial, Symbol, Times New Roman, and Bookshelf
         Fonts as these are required by Bookshelf 98.

      c. Third-party system extensions such as screen savers, fax software,
         desktop pictures, menu-modifying utilities, and other system
         enhancements increase the amount of memory required by your system
         software. Removing some or all of these extensions will increase
         the amount of memory available to applications. Be sure that you
         save anything you remove from your System Folder and place it in a
         separate folder on your hard disk so that you can replace it
         later. You can use Apple's Extension Manager or an equivalent
         third-party utility to do this. Do not to remove your CD-ROM
         driver software, or QuickTime as these extensions are necessary to
         run Bookshelf 98.

For support on Mac OS memory management, please contact Apple Computer,
Inc.

PERFORMANCE
-----------

If Bookshelf 98 seems to be running slowly or its audio and video clips are
choppy or interrupted, there are a number of things which may help:

 - If you have over 8 MB of available hard drive space, you can install the
   Bookshelf 98 application to your computer's hard drive rather than
   running it directly off the CD-ROM. To install the application to your
   computer's hard drive, double-click the Installer icon on the Bookshelf
   98 disc and select Easy Install.

 - If less than 5 MB of memory are free when you start Bookshelf, you may
   notice some performance problems. Check the previous section, MEMORY USE
   for tips on freeing memory.

 - Increase the preferred size for Bookshelf's memory allocation. Microsoft
   Bookshelf 98 is preset to a suggested memory size of 5000K. If there is
   sufficient additional memory available to run Bookshelf, you can
   increase the amount of memory the program requests by selecting the
   Microsoft Bookshelf 98 application icon on your hard drive, choosing Get
   Info from the File menu, and then changing the preferred size in the
   area titled "Memory Requirements".

   Note: If the Bookshelf 98 application is running or busy, you will not
   be able to change these numbers. If you encounter this problem, quit
   Bookshelf and try again. If this persists, restart your computer and try
   again.

 - If you are using Virtual Memory to expand available memory to more than
   double physical RAM capacity, you may find that Bookshelf 98 runs
   slowly. For best performance on a 68K Macintosh, turn off Virtual Memory
   or reduce its allocated size in the Memory control panel.

 - Bookshelf 98 is designed to work properly on a CD-ROM drive with a
   150K/sec transfer rate or faster. A double-speed CD-ROM drive or one
   with a faster transfer rate will provide even better performance in some
   areas. If your CD-ROM drive has a sustained transfer rate of less than
   150K/sec, it may not be able to supply audio and video information to
   the Macintosh at the speed required. This problem can only be fixed by
   upgrading to a faster CD-ROM drive. If you suspect a problem with your
   drive, ensure that it is properly terminated and that its software is
   properly installed. For details on SCSI termination, see your Macintosh
   or CD-ROM drive documentation, or contact your Apple dealer.

 - Enable the Modern Memory Manager. On Power Macintosh computers, the
   Modern Memory Manager offers better performance than the old 68K Memory
   Manager because it runs in the native PowerPC environment and has been
   optimized to improve heap management. To turn on the Modern Memory
   Manager, open the Memory control panel, switch the Modern Memory Manager
   radio button to On, and then restart your computer.

 - Increase the size of your Disk Cache. In the Memory control panel, you
   can set aside a portion of your RAM to store recently used information
   read from your CD-ROM drive or hard disk. A larger cache can improve
   performance considerably because RAM is much faster than CD-ROMs or hard
   disks.

   Note: On systems earlier than 7.5, setting your cache any higher than
   512K will cause degraded performance. On System 7.5 and later, Apple
   recommends setting your Disk Cache to 32K per MB of installed RAM for
   optimal performance.

 - Turn off File Sharing. File Sharing turns your Macintosh into a file
   server, letting you share folders and files on your hard disk with other
   people on a network. Maintaining File Sharing, however, takes
   considerable memory and processing power and you may notice degraded
   performance when running Bookshelf 98. To disable File Sharing, open the
   Sharing Setup control panel and click the "Stop" button for File
   Sharing. The button name should change to "Start".

 - A dirty or scratched compact disc can cause your drive to perform
   poorly. Other symptoms are "Cannot Read" error messages and ceaseless
   spinning of the CD-ROM (these appear to cause the computer to "hang").
   Make sure the bottom surface of the Bookshelf 98 disc is clean and
   undamaged.

 - If you are running QuickTime 2.0 or later and find that the video clips
   and animations are not running smoothly in Bookshelf 98, you may
   consider upgrading to a more recent version of QuickTime.

QuickTime 2.5 is available for installation on the Bookshelf 98 CD. To
install this version, double-click the Install Bookshelf 98 icon on the
Bookshelf 98 CD. Then, within the installer, select the Custom Install
option and install the QuickTime option appropriate for your Macintosh.
Alternatively, the current version is available from Apple's QuickTime Web
site.

QuickTime support and upgrades are available on http://quicktime.apple.com.

SCREEN SIZES AND COLOR CONFIGURATION
------------------------------------

On startup, Bookshelf 98 checks your monitor to ensure your computer is set
for at least 256 colors. If your monitor is set to a lower configuration,
but the settings can be adjusted to run in 256 colors, you will be prompted
to change the settings.

Bookshelf 98 will run on any 256-color, 640x480 (13-inch) or higher
resolution Macintosh compatible monitor, although Bookshelf's video clips
and still images look best in 16-bit color (thousands of colors) or 24-bit
color (millions of colors).

Note: Running in 24-bit color (millions of colors) will slow performance
and cause Bookshelf 98 to use memory more quickly. If your Macintosh
normally runs in this color mode and you get out of memory messages, you
can increase the amount of memory Bookshelf 98 requests by clicking the
Microsoft Bookshelf 98 icon, choosing Get Info from the File menu, and then
changing the preferred size in the area titled "Memory Requirements".

Bookshelf 98 is not designed to run in black and White, in 16 colors, or on
monitors displaying less than 640x480 pixels (e.g., Color Classics, most
PowerBooks and all 12 inch Apple monitors).

SOUND PROBLEMS
--------------

If the audio in Bookshelf 98 is missing or interrupted, check the
following:

 - Sounds will be inaudible if the sound level is turned down. To set the
   sound level, open the Sound control panel and experiment with the
   speaker volume setting until you find a comfortable sound level. If you
   set the sound level to maximum, you may get sound distortion, just as
   you might on a stereo system. With external speakers, be sure they are
   connected properly and turned on; you can usually adjust sound level
   with the external speaker volume knob as well as with the Sound control
   panel.

 - If Virtual Memory is enabled on your Macintosh, sounds may be choppy.
   When Virtual Memory is turned on, sounds are sometimes temporarily
   stored on the hard disk rather than in physical RAM. For optimal
   performance, Virtual Memory should be turned off. To disable Virtual
   Memory, open the Memory control panel, click the Virtual Memory Off
   button, and then restart your computer.

   Note: You must have a sufficient amount of RAM to run your both your
   System Software and Bookshelf 98 (and any other applications) with
   Virtual Memory turned off. Also note that it may not be appropriate to
   turn off Virtual Memory on a Power Macintosh. Please see your manual for
   more information about Power Macintoshes and Virtual Memory.

 - In low memory situations, sounds may not load or play. If you cannot get
   a sound to play and are sure that your Sound control panel is set
   correctly, or you are receiving error messages when attempting to play
   sounds, you may need to allocate more memory for Bookshelf. See the
   MEMORY USE section for suggestions on how to solve memory problems.

 - Some sounds used in Bookshelf 98 are stored on the disc in a compressed
   format. In order to be played, the sound must be read from the disc and
   decompressed. Older or slower Macintoshes (such as the Macintosh IIci
   and Macintosh LC III) may experience interruptions in audio playback.

 - In some situations, QuickTime 2.0 and Sound Manager 3.0 may have
   insufficient system memory available to play sounds. Upgrading to
   QuickTime 2.5, included with Bookshelf 98, should improve the system's
   ability to play sounds under these conditions.

 - Version 1.5.1 of Connectix RAM Doubler(tm) has a known bug that prevents
   audio and video clips from playing properly on Power Macintosh models.
   To obtain upgrade information, contact Connectix Corporation. For RAM
   Doubler(tm) support see http://www.connectix.com.

 - There are some incompatibilities with Now Menus and Bookshelf 98 audio.
   Adjusting the volume of the audio via the Now Menus customized menus
   should be avoided while Bookshelf 98 is running. For Now Menus support
   see http://www.nowsoft.com.

PRINTING AND COPYING
--------------------

You can print or copy from any article within Bookshelf 98 by selecting a
range of text and choosing the appropriate command from the File or Edit
menu. To copy a media element, select it by holding down the Control key
and then click on the image. In the shortcut menu that appears, choose
Copy. Please note that sounds cannot be copied due to copyright
restrictions.

If you find that printed text is improperly formatted or that special
characters do not print correctly, try the following:

 - Turn off Background Printing. Bookshelf 98 stores its custom TrueType
   fonts within the application. This provides Bookshelf 98 access to these
   custom fonts without taking up space on your hard drive. However,
   because many printer drivers launch a separate application to manage the
   printer queue and handle print jobs in the background, printing errors
   may result when Background Printing is enabled. To disable Background
   Printing, open the Chooser, select the active printer and switch the
   Background Printing radio button to off.

   Note: Background Printing with Bookshelf 98 requires that the Bookshelf
   TrueType fonts are installed to the Fonts folder on your hard drive. To
   install these fonts, double-click on the Install Bookshelf 98 icon on
   the Bookshelf 98 CD. Then, within the installer, select the Custom
   Install option and select the Bookshelf TrueType Fonts option.

SCRIPTING
---------

You can use Microsoft Bookshelf to look up and define words from
AppleScript, QuicKeys, Userland Frontier or any OSA-compliant scripting
environment. The Microsoft Bookshelf custom AppleEvent suite is defined as
follows:

Bookshelf Suite: Events to look up words or phrases using Microsoft
Bookshelf

 Find: Search for a word or phrase in a Bookshelf reference source
   Find  string
      [in  book]  -- Specific reference source to search

 Contents: Search for a word or phrase in the table of contents
   Contents  string
      [in  book]  -- Specific reference source to search

 Define: Define a word or phrase
   Define  string

 Enumeration book: A Microsoft Bookshelf reference source
   All  -- All books contained within Microsoft Bookshelf
   Dictionary  -- The American Heritage Dictionary of the English Language
   Thesaurus  -- The Original Roget's Thesaurus of English Words and
 Phrases
   Quotations  -- The Columbia Dictionary of Quotations
   Encyclopedia  -- The Encarta 98 Desk Encyclopedia
   Atlas  -- The Encarta 98 Desk World Atlas
   Chronology  -- The People's Chronology
   Almanac  -- The World Almanac(r) and Book of Facts 1997
   Internet  -- The Microsoft Bookshelf Internet Directory 98
   Computer -- The Microsoft Bookshelf Computer and Internet Dictionary 98

Example:

 tell application "Microsoft Bookshelf"
   activate
   Contents "Macintosh" in Internet
 end tell

The above AppleScript code will look up all articles in the Internet
Directory that contain the word "Macintosh".

Microsoft does not provide AppleScript support. If you are interested in
finding out more about AppleScript, please contact Apple Computer, Inc. or
see their web site at http://www.apple.com.

TROUBLESHOOTING
---------------

If you find that you are experiencing trouble, first check the following:

 - Wrong or Multiple Versions of QuickTime(tm)

   The entire QuickTime suite contains many files. Bookshelf 98 installs
   only those that it requires. These are QuickTime(tm), QuickTime(tm)
   PowerPlug (for Power Mac only), QuickTime(tm) Musical Instruments, and
   QuickTime(tm) Settings. The first three of these are extensions, while
   the QuickTime(tm) Settings file is a Control Panel. Depending on the
   additional software you have installed, you may have other QuickTime(tm)
   components.

   On startup, you may encounter an error telling you, "QuickTime
   installation failed because it was already installed." This indicates
   that there is more than one copy of a QuickTime file installed in your
   System Folder. To fix this problem, make sure that you have the most
   recent version of the QuickTime components installed. To determine which
   is the most current, check the version number in the Get Info window
   (select the file, then choose Get Info from the File menu) for each of
   the QuickTime files in your System Folder. Be sure to keep QuickTime(tm)
   files that are the most recent and move the older ones to a folder on
   your desktop. Then, restart your computer and install Bookshelf 98.

   During the Bookshelf 98 installation, the Installer checks the versions
   of Sound Manager and each QuickTime component present on your Macintosh
   and, if you don't have them installed, adds them, or if they are older
   than version 2.5, replaces them with newer versions. However, the
   Installer will only replace older versions if they possess the correct
   name; it will not remove versions of files if they have been renamed.
   For example, if you renamed a QuickTime file to "Old QuickTime", the
   Bookshelf 98 Installer would install another copy of QuickTime, but
   would fail to remove the incorrectly named version. The same would
   happen if another installer application placed a file, "QuickTime 2.1",
   in the Extensions folder.

 - Font Display Problems

   Microsoft Bookshelf 98 uses custom fonts to represent special and
   international characters. These characters usually don't correspond to
   special characters within the standard Macintosh character set and will
   appear as inappropriate or non-printing characters when copied to an
   application such as SimpleText. However, these special and international
   characters will print correctly if you print from Bookshelf 98 or
   install the Bookshelf 98 Fonts and paste into an applications that
   support Rich Text Format (RTF) such as Microsoft Office and Microsoft
   Works.

 - Unsuccessful searches in Quick Zip Code

   In some instances the Quick Zip Code may be unable to suggest a zip code
   based on a street address alone. In this case, try using a specific city
   name (spelled correctly) and/or a state name to narrow down zip code
   information.

 - Internet Connection Difficulties

   Depending on your Internet connection, it may take up to several minutes
   for your browser to successfully connect with a site that you have
   launched from the Internet Directory. You should wait to see if the
   connection is successful before returning to the Internet Directory and
   attempting to initiate another link. Attempting to connect with multiple
   Internet sites simultaneously is not recommended.

SPECIAL INFORMATION ABOUT BOOKSHELF 98 AND THE INTERNET
-------------------------------------------------------

For the online features in Bookshelf 98 to work, you will need access to
the Internet through an Internet Service Provider (ISP). These online
features include Uniform Resource Locators (URL) in the Internet Directory
and in the Help Menu.

You may already have an ISP through your employer or academic institution.
However, if you want to use the Internet for personal use, you may need to
find an ISP that sells Internet access to the general public. If you use an
ISP with proprietary software, be sure to ask if they have a Macintosh
version - some are Windows-only - and find out if the Macintosh version has
similar features to the Windows version.

Most Macintosh users access the Internet with their modem through a Serial
Line Internet Protocol (SLIP) or Point to Point Protocol (PPP) account
using a freeware control panel (although there are commercial versions and
Apple has recently released its own PPP control panel designed for use with
Open Transport 1.1.2). Whether you will use SLIP or PPP depends on what
software you have and which protocol your ISP supports, but PPP is the more
flexible protocol and has lately become much more prevalent. These accounts
let you run graphical Internet applications that work and feel just like
Macintosh applications should. If your computer has enough memory, you can
even run several Internet programs concurrently with Bookshelf.

Setting up a SLIP/PPP control panel and configuring the MacTCP or the
TCP/IP control panel (included with Open Transport in System 7.5.2 and
later) can be a bit overwhelming. Your ISP should walk you through this
process, providing you with critical information like Domain Name Server
(DNS) addresses and search domains, as well as the essential phone numbers
and modem settings to get you up and running on their service.

When Bookshelf 98 launches an Internet application, the browser assumes
that you have a TCP/IP connection already established. Some SLIP/PPP
control panels will automatically dial up and initiate a session when you
launch an Internet application, but often the time lag required for dialing
and negotiating the connection exceeds the timeout on the request. So you
should usually connect to your ISP prior to using the Internet Directory or
other features that connect you to the Internet.

Depending on the speed of your Internet connection, it may take up to
several minutes for your Web browser to successfully connect with a site
that you have launched from Bookshelf 98. You should wait to see if the
connection is successful before returning to Bookshelf and attempting to
initiate another link. Attempting to connect with multiple Internet sites
simultaneously is not recommended.

Bookshelf 98 uses software called Internet Config to determine which Web
browser should be used to connect to the Web. If you aren't currently using
Internet Config, it will be installed for you when you run the Bookshelf 98
Installer. Also your Internet Preferences will be preset to use Internet
Explorer to handle the following Internet resource types: Web (http), FTP
(ftp), Gopher (gopher), Email (mailto) and Usenet Newsgroups (news). If you
want to use a different browser or override any of these defaults, you can
start the Internet Config application and change the Helper application for
that resource type.

Note: For more information on Internet Config, please see the User
Documentation provided in the Internet Config 1.3 folder.

HOW TO CHOOSE YOUR BROWSER WITH INTERNET CONFIG:

If Internet Config is not set up properly, you may see the following error
message:

   Internet Config is not properly installed. Please launch Internet
   Config and ensure that you have a valid helper application selected
   for this Internet resource type.

Or you may simply click on an Internet Link in Bookshelf 98 and have
nothing happen. If this is the case you need to use Internet Config to
select your HTTP Helper application. To select the helper application, do
the following:

1. Locate and open the Internet Config 1.3 folder on your hard drive.

2. Double-click the Internet Config application icon.

3. In the Window menu, choose the Helpers item.

4. Select the HTTP icon, and then click Change.

5. Click Choose Helper.

6. Navigate to the location of your web browser on your hard drive.

7. Select the application, and then click Open.

8. Click OK.

9. On the File menu, click Quit and then click "OK" when prompted to Save
   the changes. 

Additional query words: readme


Keywords          : kbreadme 
Version           : MACINTOSH:98
Platform          : 
Issue type        : 

Last Reviewed: May 26, 1999