SYNOPSIS

use WWW::Search;
my $oSearch = new WWW::Search('AltaVista::Intranet',
(_host => 'copper', _port => 9000),);
my $sQuery = WWW::Search::escape_query("+investment +club");
$oSearch->native_query($sQuery);
while (my $oResult = $oSearch->next_result())
{ print $oResult->url, "\n"; }

DESCRIPTION

This class implements a search on AltaVista's Intranet (``AVI'') Search.

This class exports no public interface; all interaction should be done through WWW::Search objects.

NOTES

If your query includes characters outside the 7-bit ascii, you must tell AVI how to interpret 8-bit characters. Add an option for 'enc' to the native_query() call:

  $oSearch->native_query(WWW::Search::escape_query('Zu.rich'),
                         { 'enc' => 'iso88591'},
                        );

Hopefully the correct values for various languages can be found in the AVI documentation (sorry, I haven't looked).

TESTING

There is no standard built-in test mechanism for this module, because very few users of WWW::Search will have AVI installed on their intranet. (How's that for an excuse? ;-)

AUTHOR

"WWW::Search::AltaVista::Intranet" was written by Martin Thurn <[email protected]>

COPYRIGHT

Copyright (c) 1996 University of Southern California. All rights reserved.

Redistribution and use in source and binary forms are permitted provided that the above copyright notice and this paragraph are duplicated in all such forms and that any documentation, advertising materials, and other materials related to such distribution and use acknowledge that the software was developed by the University of Southern California, Information Sciences Institute. The name of the University may not be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

VERSION HISTORY

If it''s not listed here, then it wasn''t a meaningful nor released revision.

2.04, 2000-03-09

Added pod for selecting query language encoding

2.03, 2000-02-14

Added support for score/rank (thanks to Peter bon Burg <[email protected]>)

2.02, 1999-11-29

Fixed to work with latest version of AltaVista.pm

1.03, 1999-06-20

First publicly-released version.

native_setup_search

This private method does the heavy lifting after native_query() is called.

native_retrieve_some

This private method does the heavy lifting of communicating with the server.