.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" 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" ''
.    ds C`
.    ds C'
'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 >0, 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.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "WWW::Search::Yahoo::News::Advanced 3pm"
.TH WWW::Search::Yahoo::News::Advanced 3pm "2018-11-25" "perl v5.28.0" "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::Yahoo::News::Advanced \- search Yahoo!News using the
"advanced" interface
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 8
\&  use WWW::Search;
\&  my $oSearch = new WWW::Search(\*(AqYahoo::News::Advanced\*(Aq);
\&  my $sQuery = WWW::Search::escape_query("George Lucas");
\&  $oSearch\->date_from(\*(Aq7 days ago\*(Aq);
\&  $oSearch\->date_to  (\*(Aqnow\*(Aq);
\&  $oSearch\->native_query($sQuery);
\&  while (my $oResult = $oSearch\->next_result())
\&    print $oResult\->url, "\en";
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This class is a Yahoo! News specialization of WWW::Search.  It
handles making and interpreting searches on Yahoo! News
\&\fIhttp://news.yahoo.com\fR using the Advanced search interface.
.PP
This class exports no public interface; all interaction should
be done through WWW::Search objects.
.SH "NOTES"
.IX Header "NOTES"
This backend supports narrowing the search by date-range.
Use \fBdate_from()\fR and \fBdate_to()\fR to set the endpoints of the desired date range.
You can use any date format supported by the Date::Manip module.
.PP
\&\s-1NOTE\s0 that Yahoo only seems to keep the last 60 days worth of news in its searchable index.
.PP
At one time, News.yahoo.com would die if the unescaped query is longer
than 485 characters or so.  This backend does \s-1NOT\s0 check for that.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
To make new back-ends, see WWW::Search.
.SH "BUGS"
.IX Header "BUGS"
To report a new bug, please use
https://rt.cpan.org/Ticket/Create.html?Queue=WWW\-Search\-Yahoo
.SH "AUTHOR"
.IX Header "AUTHOR"
\&\f(CW\*(C`WWW::Search::Yahoo::News::Advanced\*(C'\fR is maintained by Martin Thurn
(mthurn@cpan.org).
.SH "LEGALESE"
.IX Header "LEGALESE"
Copyright (C) 1998\-2009 Martin 'Kingpin' Thurn
.PP
\&\s-1THIS SOFTWARE IS PROVIDED \*(L"AS IS\*(R" AND WITHOUT ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.\s0