.\" 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::AdvancedWeb 3pm"
.TH WWW::Search::AltaVista::AdvancedWeb 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::AdvancedWeb \- class for advanced Alta Vista web searching
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 8
\&  use WWW::Search;
\&  my $search = new WWW::Search(\*(AqAltaVista::AdvancedWeb\*(Aq);
\&  $search\->native_query(WWW::Search::escape_query(\*(Aq(bmw AND mercedes) AND NOT (used OR Ferrari)\*(Aq));
\&  $search\->maximum_to_retrieve(\*(Aq100\*(Aq); 
\&  while (my $result = $search\->next_result())
\&    {
\&    print $result\->url, "\en";
\&    }
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Class hack for Advance AltaVista web search mode originally written by  
John Heidemann \fIhttp://www.altavista.com\fR.
.PP
This hack now allows for AltaVista AdvanceWeb search results
to be sorted and relevant results returned first. Initially, this 
class had skiped the 'r' option which is used by AltaVista to sort
search results for relevancy. Sending advance query using the 
\&'q' option resulted in random returned search results which made it 
impossible to view best scored results first.
.PP
This class exports no public interface; all interaction should
be done through WWW::Search objects.
.SH "HELP"
.IX Header "HELP"
Use \s-1AND\s0 to join two terms that must both be present for a
document to count as a match.
.PP
Use \s-1OR\s0 to join two terms if either one counts.
.PP
Use \s-1AND\s0 \s-1NOT\s0 to join two terms if the first must be present and
the second must \s-1NOT\s0.
.PP
Use \s-1NEAR\s0 to join two terms if they both must appear and be within
10 words of each other.
.PP
Try this example:
.PP
cars \s-1AND\s0 bmw \s-1AND\s0 mercedes
.PP
You don't have to capitalize the \*(L"operators\*(R" \s-1AND\s0, \s-1OR\s0, \s-1AND\s0 \s-1NOT\s0, or
\&\s-1NEAR\s0. But many people do to make it clear what is a query term
and what is an instruction to the search engine.
.PP
One other wrinkle that's very handy: you can group steps together
with parentheses to tell the system what order you want it to
perform operations in.
.PP
(bmw \s-1AND\s0 mercedes) \s-1NEAR\s0 cars \s-1AND\s0 \s-1NOT\s0 (used \s-1OR\s0 Ferrari)
.PP
Keep in mind that grouping should be used as much as possible
because if you attempt to enter a long query using \s-1AND\s0 to join
the words you may not receive any results because the entire
query would be like one long phrase. For best reuslts follow
the example herein.
.SH "AUTHOR"
.IX Header "AUTHOR"
\&\f(CW\*(C`WWW::Search\*(C'\fR hack by Jim Smyser, <jsmyser@bigfoot.com>.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (c) 1996 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.
.SH "VERSION HISTORY"
.IX Header "VERSION HISTORY"
2.07 \- unescape URLs, and bugfix for undefined \f(CW$hit\fR
.PP
2.06 \- do not use \s-1URI::URL\s0
.PP
2.02 \- Added \s-1HELP\s0 \s-1POD\s0. Misc. Clean-up for latest changes.
.PP
2.01 \- Additional query modifiers added for even better results.
.PP
2.0 \- Minor change to set lowercase Boolean operators to uppercase.
.PP
1.9 \- First hack version release.
.SS "native_setup_search"
.IX Subsection "native_setup_search"
This private method does the heavy lifting after \fInative_query()\fR is called.