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 the WWW::Search manpage, 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 - <[email protected]>.
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.