SEARCH-ENGINE INTERFACE

CONTENTS
    LICENCE
    INTRODUCTION
    MANIFEST
    INSTALL
    NOTES


LICENCE

This software is subject to the terms given in the accompanying
file, LICENCE.  Please read it.


INTRODUCTION

This is a MOO-code package written for JHCore-based MOO servers.
some modification may be required to allow the software to work on
other platforms.

The Search-Engine Interface is an object that takes search-terms
and forms a viable search URL which can be processed by a webbrowser.
You control the Search-Engine Interface by speaking to it, using
a 'directed-say' command.

For example you can search the web for information about Honda
Automobiles by typing a command like:

    `google honda automobiles

If your client supports the dns-com-awns-displayurl MCP/2.1 package
then your client will open a webbrowser and pass the URL to it.
This will send a request to the search engine which will display
the results in the webbrowser.

If your client doesn't support dns-com-awns-displayurl then the
interface will send you the following string which contains the
search URL:

    SHOWURL http://.../

The Interface will remember the last set of search-terms spoken to
it, but not the name of the person who spoke.  Asking the Interface
to 'show me' will repeat the query.


MANIFEST

    README			this file
    LICENCE			licence terms for this package 
    google.moo			a MOO code @dump


INSTALL

As a non-wizard user port the MOO-code in the *.moo files.  You'll
need to load each file into a text editor and use search and replace
functions to replace the following strings with their relevant
values:

    __NEW__		object id of newly @create'd package


NOTES

This object makes use of the directed_speech event which is normally
broadcast by the Stage Talk Feature Object (__STFO__).   MOOs based on the
December '98 JHCore need to be modified slightly to ensure that
the Stage Talk Feature Object works properly.

Edit the verb __STFO__:` and change the last 'else/endif' block to
look like this:

--- cut here ---
else
  $you:say_action(this.((dobj == {{player}}) ? "toself_msg" | "to_msg"));
  event = {{"speaker", player}, {"targets", dobj[1]}, {"speech", argstr}};
  player.location:broadcast_event_directed_speech(event);
endif
--- cut here ---

The MCP/2.1 package dns-com-awns-displayurl is available here:

    http://www.awns.com/mcp/

A displayurl.tcl plugin is available for the tkMOO-light client which
supports the dns-com-awns-displayurl package:

    http://www.awns.com/tkMOO-light/plugins/