home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _cb70bc86c119ceb57fd856819a6a0dd8 < prev    next >
Text File  |  2000-03-23  |  5KB  |  137 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>WWW::Search::NorthernLight - class for searching NorthernLight</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::NorthernLight - class for searching NorthernLight</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="#testing">TESTING</A></LI>
  28.     <LI><A HREF="#author">AUTHOR</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::NorthernLight - class for searching NorthernLight</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.     use WWW::Search;
  50.     my $oSearch = new WWW::Search('NorthernLight');
  51.     my $sQuery = WWW::Search::escape_query("+sushi restaurant +Columbus Ohio");
  52.     $oSearch->native_query($sQuery);
  53.     while (my $oResult = $oSearch->next_result()) {
  54.         print $oResult->url, "\n";
  55.     }</PRE>
  56. <P>
  57. <HR>
  58. <H1><A NAME="description">DESCRIPTION</A></H1>
  59. <P>This class is a NorthernLight specialization of WWW::Search.
  60. It handles making and interpreting NorthernLight searches
  61. <EM><A HREF="http://www.northernlight.com">http://www.northernlight.com</A></EM>.</P>
  62. <P>Northern Light supports full Boolean capability (AND,
  63. OR, NOT), including parenthetical ``expressions'', in
  64. all searches. There is no limit to the level of nesting
  65. which you can use in a query.</P>
  66. <P>This class exports no public interface; all interaction should
  67. be done through <A HREF="../../../../site/lib/WWW/Search.html">the WWW::Search manpage</A> objects.</P>
  68. <P>
  69. <HR>
  70. <H1><A NAME="see also">SEE ALSO</A></H1>
  71. <P>To make new back-ends, see <A HREF="../../../../site/lib/WWW/Search.html">the WWW::Search manpage</A>.</P>
  72. <P>
  73. <HR>
  74. <H1><A NAME="how does it work">HOW DOES IT WORK?</A></H1>
  75. <P><CODE>native_setup_search</CODE> is called (from <CODE>WWW::Search::setup_search</CODE>)
  76. before we do anything.  It initializes our private variables (which
  77. all begin with underscore) and sets up a URL to the first results
  78. page in <CODE>{_next_url}</CODE>.</P>
  79. <P><CODE>native_retrieve_some</CODE> is called (from <CODE>WWW::Search::retrieve_some</CODE>)
  80. whenever more hits are needed.  It calls <CODE>WWW::Search::http_request</CODE>
  81. to fetch the page specified by <CODE>{_next_url}</CODE>.
  82. It then parses this page, appending any search hits it finds to 
  83. <CODE>{cache}</CODE>.  If it finds a ``next'' button in the text,
  84. it sets <CODE>{_next_url}</CODE> to point to the page for the next
  85. set of results, otherwise it sets it to undef to indicate we''re done.</P>
  86. <P>
  87. <HR>
  88. <H1><A NAME="testing">TESTING</A></H1>
  89. <P>This module adheres to the <CODE>WWW::Search</CODE> test suite mechanism. 
  90. See $TEST_CASES below.</P>
  91. <P>
  92. <HR>
  93. <H1><A NAME="author">AUTHOR</A></H1>
  94. <P>This Backend is will now be maintained and supported by Jim Smyser.
  95. Flames to: <<A HREF="mailto:jsmyser@bigfoot.com">jsmyser@bigfoot.com</A>></P>
  96. <P><CODE>WWW::Search::NorthernLight</CODE> was originally written by Andreas Borchert
  97. based on <CODE>WWW::Search::Excite</CODE>.</P>
  98. <P>
  99. <HR>
  100. <H1><A NAME="legalese">LEGALESE</A></H1>
  101. <P>THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
  102. WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  103. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.</P>
  104. <P>
  105. <HR>
  106. <H1><A NAME="version history">VERSION HISTORY</A></H1>
  107. <P>2.04 
  108. Mainly Tag stripping that was getting bad and causing undesirable 
  109. formatting in the title and description return.</P>
  110. <P>2.03
  111. Next Page url change and weeding out a new edit search url.</P>
  112. <P>2.02
  113. Minor parsing change to get the new description line that had changed.</P>
  114. <P>2.01
  115. typo and new test mechanism</P>
  116. <P>1.06
  117. Slight reformat change.</P>
  118. <P>1.05
  119. Fixed 'next' page tag recognition, this changed slightly. 
  120. Whitespace removal in description that was really BAD with
  121. some hits. Ignoring internal NorthernLight URL's.</P>
  122. <P>1.04
  123. Slight adjustments to formatting. Returning score and date
  124. with description.</P>
  125. <P>1.03
  126. Slight format change by NL that was making next page hits flakey
  127. corrected. Misc. code clean up.</P>
  128. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  129. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  130. <STRONG><P CLASS=block> WWW::Search::NorthernLight - class for searching NorthernLight</P></STRONG>
  131. </TD></TR>
  132. </TABLE>
  133.  
  134. </BODY>
  135.  
  136. </HTML>
  137.