Searching The Perl CD Bookshelf

#

# About Searching this CD

This CD includes search technology from Astaware technologies Inc. Your Web browser uses an ordinary HTML form like this one to perform the search by communicating with a single-purpose Web server, written in Java.

Therefore, in order to search the CD, the search server must be running. In order for the search server to run, you must have a Java interpreter, either the Java Developers' Kit (JDK) or the Java Runtime Engine (JRE). A JRE is provided for some platforms on this CD; you may already have the JDK installed as part of your operating system. If you haven't run the server before, or if you're having difficulty, please see below.

The search engine supports basic Boolean operators: `AND`, `OR`, and `NOT`. You can use these to refine your search. Example:

>     pipe AND stderr NOT stdout

You can use an asterisk (`*`) as a wildcard operator:

`bob*`
  will match "Bob", "bobwhite", and "bobsled".
`*bob`
  will match "Bob", "kabob", and "nabob".
`*bob*`
  will match "Bob", "bobsled", "kabob", and "discombobulate".

The Results report format setting controls the style of report received. A Simple report will just list the documents found and a relevancy ranking; an Expanded report will give the first section of the document's content.

The search engine does not search for punctuation; it only indexes words of letters and numbers. For example, to find `<STDIN>`, search for `STDIN` or `stdin` (case does not matter). Note that there is an index available which indexes symbols and keywords; this can also be useful for finding concepts whose names do not necessarily appear literally in the text of a book.

Some punctuation can be used as shortcuts for Boolean keywords:

`&`
  `AND`
`|`
  `OR`
`!`
  `NOT`

The example search above can therefore be entered as

>     pipe & stderr ! stdout

If you use any of these characters in a context where the search engine does not understand them, you will get an "Invalid response" error message. Correct the syntax of your search expression and try again.

## Proxy Servers

The search server uses `localhost` (IP address `127.0.0.1`, which is always the current machine) to perform searches. If you use a proxy server, make sure that `localhost` is excluded from the proxy. You will find this setting within your Internet options under your browser's proxy settings. Check with your system administrator to see if other advanced proxy server settings are necessary.

### In Netscape Communicator

1. Select EditPreferences.

2. Under the Advanced section, select Proxies.

3. Select Manual proxy configuration and click View....

4. In the No Proxy for: box, enter `localhost`.

### In Microsoft Internet Explorer

1. Select ViewInternet Options.... (In MSIE 5.0, select ToolsInternet Options....)

2. Select the Connections tab.

3. Click LAN Settings....

4. In the Proxy Server section, click Advanced....

5. In the Exceptions box, enter `localhost`.

## Using the Search Server

- Are you using UNIX?
- Are you running Windows 95, Windows 98, or Windows NT?
- Are you using a Macintosh?
- Are you using something else?