Searching The Perl CD Bookshelf on a Macintosh

#

# About Searching on a Macintosh

Due to the lack of a command line on the Macintosh, using Java applications is a little bit complicated. If you follow these steps, running the search server should not be too painful.

NOTE: This search engine requires MRJ (MacOS Runtime for Java) 2.0. If you have upgraded to MRJ 2.1 or got it with a recent copy of the MacOS, the search engine will not work. To check your version of MRJ, go into your System Folder, then to Extensions, and then to MRJ Libraries. Select MRJLib and select FileGet Info (command-i). It should say, "MacOS Runtime for Java 2.0".

1. In the mac folder on the CD is a BinHex file called macsearch.hqx. De-BinHex it; you may be able to double-click on it to do this, or you may need to open it with an expander like UnStuffIt. That will create an Applescript application called Start Search Service. (If you had to do this manually, the next step will fail, but do it anyway.)
2. Run Start Search Service. It should copy some files into your Preferences folder and create an alias on your desktop called NRSearch. If this step fails part way through, go to Installing the Server Manually below.
3. Run NRSearch. You will see a console window while the search server is running. Quitting the application will shut down the search server.

You can safely move the NRSearch alias anywhere you like without affecting the performance of the search engine. You should not move the NRPrefs folder from your Preferences folder, or change any of the files inside that folder.

### Installing the Server Manually

The Start Search Service script performs a number of steps. If it fails, you need to determine where it failed and complete the process.

1. The script should copy the NRPrefs folder from the mac folder on the CD into your Preferences folder in your System Folder. If that didn't happen, copy it now.

2. Next, you'll need to de-BinHex NRSearch.hqx in that folder; this is probably where the script failed.

3. For convenience, you should make an alias to the resulting NRSearch and copy it somewhere handy, like the Desktop.