home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _bd98063550f09318a8714cbf9055d712 < prev    next >
Text File  |  2000-03-23  |  6KB  |  149 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>WWW::Search::AltaVista - class for searching Alta Vista</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::AltaVista - class for searching Alta Vista</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="#options">OPTIONS</A></LI>
  26.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  27.     <LI><A HREF="#how does it work">HOW DOES IT WORK?</A></LI>
  28.     <LI><A HREF="#author and current version">AUTHOR and CURRENT VERSION</A></LI>
  29.     <LI><A HREF="#copyright">COPYRIGHT</A></LI>
  30. </UL>
  31. <!-- INDEX END -->
  32.  
  33. <HR>
  34. <P>
  35. <H1><A NAME="name">NAME</A></H1>
  36. <P>WWW::Search::AltaVista - class for searching Alta Vista</P>
  37. <P>
  38. <HR>
  39. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  40. <UL>
  41. <LI>Linux</LI>
  42. <LI>Solaris</LI>
  43. <LI>Windows</LI>
  44. </UL>
  45. <HR>
  46. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  47. <PRE>
  48.     require WWW::Search;
  49.     $search = new WWW::Search('AltaVista');</PRE>
  50. <P>
  51. <HR>
  52. <H1><A NAME="description">DESCRIPTION</A></H1>
  53. <P>This class is an AltaVista specialization of WWW::Search.
  54. It handles making and interpreting AltaVista searches
  55. <EM><A HREF="http://www.altavista.com">http://www.altavista.com</A></EM>.</P>
  56. <P>This class exports no public interface; all interaction should
  57. be done through WWW::Search objects.</P>
  58. <P>
  59. <HR>
  60. <H1><A NAME="options">OPTIONS</A></H1>
  61. <P>The default is for simple web queries.
  62. Specialized back-ends for simple and advanced web and news searches
  63. are available (see
  64. <A HREF="../../../../site/lib/WWW/Search/AltaVista/Web.html">the WWW::Search::AltaVista::Web manpage</A>,
  65. <A HREF="../../../../site/lib/WWW/Search/AltaVista/AdvancedWeb.html">the WWW::Search::AltaVista::AdvancedWeb manpage</A>,
  66. <A HREF="../../../../site/lib/WWW/Search/AltaVista/News.html">the WWW::Search::AltaVista::News manpage</A>,
  67. <A HREF="../../../../site/lib/WWW/Search/AltaVista/AdvancedNews.html">the WWW::Search::AltaVista::AdvancedNews manpage</A>).
  68. These back-ends set different combinations following options.</P>
  69. <DL>
  70. <DT><STRONG><A NAME="item_search_url%3DURL">search_url=URL</A></STRONG><BR>
  71. <DD>
  72. Specifies who to query with the AltaVista protocol.
  73. The default is at
  74. <CODE>http://www.altavista.com/cgi-bin/query</CODE>;
  75. you may wish to retarget it to
  76. <CODE>http://www.altavista.telia.com/cgi-bin/query</CODE>
  77. or other hosts if you think that they're ``closer''.
  78. <P></P>
  79. <DT><STRONG><A NAME="item_search_debug%2C_search_parse_debug%2C_search_ref_S">search_debug, search_parse_debug, search_ref
  80. Specified at <A HREF="../../../../site/lib/WWW/Search.html">the WWW::Search manpage</A>.</A></STRONG><BR>
  81. <DD>
  82. <DT><STRONG><A NAME="item_pg%3Daq">pg=aq</A></STRONG><BR>
  83. <DD>
  84. Do advanced queries.
  85. (It defaults to simple queries.)
  86. <P></P>
  87. <DT><STRONG><A NAME="item_what%3Dnews">what=news</A></STRONG><BR>
  88. <DD>
  89. Search Usenet instead of the web.
  90. (It defaults to search the web.)
  91. <P></P></DL>
  92. <P>
  93. <HR>
  94. <H1><A NAME="see also">SEE ALSO</A></H1>
  95. <P>To make new back-ends, see <A HREF="../../../../site/lib/WWW/Search.html">the WWW::Search manpage</A>,
  96. or the specialized AltaVista searches described in options.</P>
  97. <P>
  98. <HR>
  99. <H1><A NAME="how does it work">HOW DOES IT WORK?</A></H1>
  100. <P><CODE>native_setup_search</CODE> is called before we do anything.
  101. It initializes our private variables (which all begin with underscores)
  102. and sets up a URL to the first results page in <CODE>{_next_url}</CODE>.</P>
  103. <P><CODE>native_retrieve_some</CODE> is called (from <CODE>WWW::Search::retrieve_some</CODE>)
  104. whenever more hits are needed.  It calls the LWP library
  105. to fetch the page specified by <CODE>{_next_url}</CODE>.
  106. It parses this page, appending any search hits it finds to 
  107. <CODE>{cache}</CODE>.  If it finds a ``next'' button in the text,
  108. it sets <CODE>{_next_url}</CODE> to point to the page for the next
  109. set of results, otherwise it sets it to undef to indicate we're done.</P>
  110. <P>
  111. <HR>
  112. <H1><A NAME="author and current version">AUTHOR and CURRENT VERSION</A></H1>
  113. <P><CODE>WWW::Search::AltaVista</CODE> is written and maintained
  114. by John Heidemann, <<A HREF="mailto:johnh@isi.edu">johnh@isi.edu</A>>.</P>
  115. <P>The best place to obtain <CODE>WWW::Search::AltaVista</CODE>
  116. is from Martin Thurn's WWW::Search releases on CPAN.
  117. Because AltaVista sometimes changes its format
  118. in between his releases, sometimes more up-to-date versions
  119. can be found at
  120. <EM><A HREF="http://www.isi.edu/~johnh/SOFTWARE/WWW_SEARCH_ALTAVISTA/index.html">http://www.isi.edu/~johnh/SOFTWARE/WWW_SEARCH_ALTAVISTA/index.html</A></EM>.</P>
  121. <P>
  122. <HR>
  123. <H1><A NAME="copyright">COPYRIGHT</A></H1>
  124. <P>Copyright (c) 1996-1998 University of Southern California.
  125. All rights reserved.                                            
  126. </P>
  127. <PRE>
  128.  
  129. Redistribution and use in source and binary forms are permitted
  130. provided that the above copyright notice and this paragraph are
  131. duplicated in all such forms and that any documentation, advertising
  132. materials, and other materials related to such distribution and use
  133. acknowledge that the software was developed by the University of
  134. Southern California, Information Sciences Institute.  The name of the
  135. University may not be used to endorse or promote products derived from
  136. this software without specific prior written permission.</PRE>
  137. <P>THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
  138. WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
  139. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.</P>
  140. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  141. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  142. <STRONG><P CLASS=block> WWW::Search::AltaVista - class for searching Alta Vista</P></STRONG>
  143. </TD></TR>
  144. </TABLE>
  145.  
  146. </BODY>
  147.  
  148. </HTML>
  149.