NAME

WWW::Search::OpenDirectory - class for searching dmoz.org!

SYNOPSIS

require WWW::Search;
$search = new WWW::Search('OpenDirectory');

DESCRIPTION

This class uses the Open Directory engine http://dmoz.org. Yahoo! type directory that is user maintained. Very nice!

Seperate search terms with 'and' to include all words. Accepts double quotes for phrase searching: "Tour de France"

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

SEE ALSO

To make new back-ends, see WWW::Search, or the specialized AltaVista searches described in options.

HOW DOES IT WORK?

native_setup_search is called before we do anything. It initializes our private variables (which all begin with underscores) and sets up a URL to the first results page in {_next_url}.

native_retrieve_some is called (from WWW::Search::retrieve_some) whenever more hits are needed. It calls the LWP library to fetch the page specified by {_next_url}. It parses this page, appending any search hits it finds to {cache}. If it finds a ``next'' button in the text, it sets {_next_url} to point to the page for the next set of results, otherwise it sets it to undef to indicate we're done.

AUTHOR

WWW::Search::OpenDirectory is written and maintained by Jim Smyser - <jsmyser@bigfoot.com>.

TESTING

This module adheres to the WWW::Search test suite mechanism. See $TEST_CASES below.

LEGALESE

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

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

2.01 New test mechanism.

1.02 Format changes.