home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _942777fddc70da8632a5da86d1c71dbf < prev    next >
Text File  |  2000-03-23  |  4KB  |  115 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>WWW::Search::OpenDirectory - class for searching dmoz.org!</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> WWW::Search::OpenDirectory - class for searching dmoz.org!</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  26.     <LI><A HREF="#how does it work">HOW DOES IT WORK?</A></LI>
  27.     <LI><A HREF="#author">AUTHOR</A></LI>
  28.     <LI><A HREF="#testing">TESTING</A></LI>
  29.     <LI><A HREF="#legalese">LEGALESE</A></LI>
  30.     <LI><A HREF="#version history">VERSION HISTORY</A></LI>
  31. </UL>
  32. <!-- INDEX END -->
  33.  
  34. <HR>
  35. <P>
  36. <H1><A NAME="name">NAME</A></H1>
  37. <P>WWW::Search::OpenDirectory - class for searching dmoz.org!</P>
  38. <P>
  39. <HR>
  40. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  41. <UL>
  42. <LI>Linux</LI>
  43. <LI>Solaris</LI>
  44. <LI>Windows</LI>
  45. </UL>
  46. <HR>
  47. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  48. <PRE>
  49.     require WWW::Search;
  50.     $search = new WWW::Search('OpenDirectory');</PRE>
  51. <P>
  52. <HR>
  53. <H1><A NAME="description">DESCRIPTION</A></H1>
  54. <P>This class uses the Open Directory engine <EM><A HREF="http://dmoz.org">http://dmoz.org</A></EM>.
  55. Yahoo! type directory that is user maintained. Very nice!</P>
  56. <P>Seperate search terms with 'and' to include all words. Accepts
  57. double quotes for phrase searching: ``Tour de France''</P>
  58. <P>This class exports no public interface; all interaction should
  59. be done through WWW::Search objects.</P>
  60. <P>
  61. <HR>
  62. <H1><A NAME="see also">SEE ALSO</A></H1>
  63. <P>To make new back-ends, see <A HREF="../../../../site/lib/WWW/Search.html">the WWW::Search manpage</A>,
  64. or the specialized AltaVista searches described in options.</P>
  65. <P>
  66. <HR>
  67. <H1><A NAME="how does it work">HOW DOES IT WORK?</A></H1>
  68. <P><CODE>native_setup_search</CODE> is called before we do anything.
  69. It initializes our private variables (which all begin with underscores)
  70. and sets up a URL to the first results page in <CODE>{_next_url}</CODE>.</P>
  71. <P><CODE>native_retrieve_some</CODE> is called (from <CODE>WWW::Search::retrieve_some</CODE>)
  72. whenever more hits are needed.  It calls the LWP library
  73. to fetch the page specified by <CODE>{_next_url}</CODE>.
  74. It parses this page, appending any search hits it finds to 
  75. <CODE>{cache}</CODE>.  If it finds a ``next'' button in the text,
  76. it sets <CODE>{_next_url}</CODE> to point to the page for the next
  77. set of results, otherwise it sets it to undef to indicate we're done.</P>
  78. <P>
  79. <HR>
  80. <H1><A NAME="author">AUTHOR</A></H1>
  81. <P><CODE>WWW::Search::OpenDirectory</CODE> is written and maintained
  82. by Jim Smyser - <<A HREF="mailto:jsmyser@bigfoot.com">jsmyser@bigfoot.com</A>>.</P>
  83. <P>
  84. <HR>
  85. <H1><A NAME="testing">TESTING</A></H1>
  86. <P>This module adheres to the <CODE>WWW::Search</CODE> test suite mechanism. 
  87. See $TEST_CASES below.</P>
  88. <P>
  89. <HR>
  90. <H1><A NAME="legalese">LEGALESE</A></H1>
  91. <P>Copyright (c) 1996-1999 University of Southern California.
  92. All rights reserved.                                            
  93. </P>
  94. <PRE>
  95.  
  96. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
  97. WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  98. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.</PRE>
  99. <P>
  100. <HR>
  101. <H1><A NAME="version history">VERSION HISTORY</A></H1>
  102. <P>2.01
  103. New test mechanism.</P>
  104. <P>1.02
  105. Format changes.</P>
  106. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  107. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  108. <STRONG><P CLASS=block> WWW::Search::OpenDirectory - class for searching dmoz.org!</P></STRONG>
  109. </TD></TR>
  110. </TABLE>
  111.  
  112. </BODY>
  113.  
  114. </HTML>
  115.