.\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.19) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "WWW::Search::AltaVista 3pm" .TH WWW::Search::AltaVista 3pm "2011-11-02" "perl v5.12.4" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" WWW::Search::AltaVista \- class for searching www.altavista.com .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 2 \& require WWW::Search; \& $search = new WWW::Search(\*(AqAltaVista\*(Aq); .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" This class is an AltaVista specialization of WWW::Search. It handles making and interpreting AltaVista searches \&\fIhttp://www.altavista.com\fR. .PP This class exports no public interface; all interaction should be done through WWW::Search objects. .SH "OPTIONS" .IX Header "OPTIONS" The default is \*(L"any of these words\*(R" (\s-1OR\s0 of query terms). .IP "aqa=all+of+these+words" 8 .IX Item "aqa=all+of+these+words" Add the \s-1AND\s0 of these words to the query. .IP "aqp=this+exact+phrase" 8 .IX Item "aqp=this+exact+phrase" Add \*(L"this exact phrase\*(R" to the query. .IP "aqo=any+of+these+words" 8 .IX Item "aqo=any+of+these+words" Add the \s-1OR\s0 of these words to the query. This is where the query is placed by default. .IP "aqn=none+of+these+words" 8 .IX Item "aqn=none+of+these+words" Add \s-1NOT\s0 these words to the query. .IP "aqb=(boolean+AND+expression)+NEAR+entry" 8 .IX Item "aqb=(boolean+AND+expression)+NEAR+entry" Add a boolean expression to the query. Operators are \s-1AND\s0, \s-1OR\s0, \s-1AND\s0 \s-1NOT\s0, and \s-1NEAR\s0. In the browser interface, the boolean expression can not be combined with any other query types listed above. You should probably build the boolean expression with parentheses and spaces and urlescape it. .IP "aqs=these+words" 8 .IX Item "aqs=these+words" Pages containing \*(L"these words\*(R" will be ranked highest. .IP "kgs=[0,1]" 8 .IX Item "kgs=[0,1]" To restrict the search to U.S. websites, set kgs=1. The default is world-wide, kgs=0. .IP "kls=[0,1]" 8 .IX Item "kls=[0,1]" To restrict the search to pages in English and Spanish, set kls=1. The default is no language restrictions, kls=0. .IP "filetype=[html,pdf]" 8 .IX Item "filetype=[html,pdf]" To restrict the search to \s-1HTML\s0 pages only, set filetype=html. To restrict the search to \s-1PDF\s0 pages only, set filetype=pdf. The default is no restriction on page type, filetype=. .IP "rc=dmn&swd=net+org+or.jp" 8 .IX Item "rc=dmn&swd=net+org+or.jp" To restrict the search to pages from certain domains, set rc=dmn and set swd to a list of desired toplevel domains. .IP "rc=url&lh=www.sandcrawler.com/SWB" 8 .IX Item "rc=url&lh=www.sandcrawler.com/SWB" To restrict the search to pages from a particular site, set rc=url and set lh to the site name and path. Leave off the http:// from the site. .SH "PUBLIC METHODS" .IX Header "PUBLIC METHODS" .SS "gui_query" .IX Subsection "gui_query" Call this instead of \fInative_query()\fR if you want to get the same results as your average Joe web surfer. .SH "PRIVATE METHODS" .IX Header "PRIVATE METHODS" .SS "native_setup_search" .IX Subsection "native_setup_search" This private method does the heavy lifting after you call \fInative_query()\fR or \fIgui_query()\fR. .SS "parse_tree" .IX Subsection "parse_tree" This private method does the hard work of parsing the results out of the \s-1HTML\s0. .SH "BUGS" .IX Header "BUGS" .IP "Not all of the above options have been tested." 4 .IX Item "Not all of the above options have been tested." .PD 0 .ie n .IP "Please report bugs and send feature requests via email to ""bug\-WWW\-Search\-AltaVista@rt.cpan.org"", or via the web interface at https://rt.cpan.org/NoAuth/Bugs.html?Dist=WWW\-Search\-AltaVista ." 4 .el .IP "Please report bugs and send feature requests via email to \f(CWbug\-WWW\-Search\-AltaVista@rt.cpan.org\fR, or via the web interface at https://rt.cpan.org/NoAuth/Bugs.html?Dist=WWW\-Search\-AltaVista ." 4 .IX Item "Please report bugs and send feature requests via email to bug-WWW-Search-AltaVista@rt.cpan.org, or via the web interface at https://rt.cpan.org/NoAuth/Bugs.html?Dist=WWW-Search-AltaVista ." .PD .SH "SEE ALSO" .IX Header "SEE ALSO" To make new back-ends, see WWW::Search, or the specialized AltaVista searches described in options. .SH "AUTHOR" .IX Header "AUTHOR" Written by John Heidemann, \f(CW\*(C`johnh@isi.edu\*(C'\fR; maintained by Martin Thurn, \f(CW\*(C`mthurn@cpan.org\*(C'\fR. .SH "LICENSE" .IX Header "LICENSE" This software is released under the same license as Perl itself. .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (c) 1996\-1998 University of Southern California. All rights reserved. .PP Redistribution and use in source and binary forms are permitted provided that the above copyright notice and this paragraph are duplicated in all such forms and that any documentation, advertising materials, and other materials related to such distribution and use acknowledge that the software was developed by the University of Southern California, Information Sciences Institute. The name of the University may not be used to endorse or promote products derived from this software without specific prior written permission. .PP \&\s-1THIS\s0 \s-1SOFTWARE\s0 \s-1IS\s0 \s-1PROVIDED\s0 \*(L"\s-1AS\s0 \s-1IS\s0\*(R" \s-1AND\s0 \s-1WITHOUT\s0 \s-1ANY\s0 \s-1EXPRESS\s0 \s-1OR\s0 \s-1IMPLIED\s0 \&\s-1WARRANTIES\s0, \s-1INCLUDING\s0, \s-1WITHOUT\s0 \s-1LIMITATION\s0, \s-1THE\s0 \s-1IMPLIED\s0 \s-1WARRANTIES\s0 \s-1OF\s0 \&\s-1MERCHANTABILITY\s0 \s-1AND\s0 \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0.