/usr/share/doc/libwww-opensearch-perl/README is in libwww-opensearch-perl 0.17-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 | NAME
WWW::OpenSearch - Search A9 OpenSearch compatible engines
SYNOPSIS
use WWW::OpenSearch;
my $url = "http://bulkfeeds.net/opensearch.xml";
my $engine = WWW::OpenSearch->new($url);
my $name = $engine->description->ShortName;
my $tags = $engine->description->Tags;
# Perform search for "iPod"
my $response = $engine->search("iPod");
for my $item (@{$response->feed->items}) {
print $item->{description};
}
# Retrieve the next page of results
my $next_page = $response->next_page;
for my $item (@{$next_page->feed->items}) {
print $item->{description};
}
DESCRIPTION
WWW::OpenSearch is a module to search A9's OpenSearch compatible search
engines. See http://opensearch.a9.com/ for details.
CONSTRUCTOR
new( $url )
Constructs a new instance of WWW::OpenSearch using the given URL as the
location of the engine's OpenSearch Description document (retrievable
via the description_url accessor).
METHODS
fetch_description( [ $url ] )
Fetches the OpenSearch Descsription found either at the given URL or at
the URL specified by the description_url accessor. Fetched description
may be accessed via the description accessor.
search( $query [, \%params] )
Searches the engine for the given query using the given search
parameters. Valid search parameters include:
* startPage
* totalResults
* startIndex
* itemsPerPage
See http://opensearch.a9.com/spec/1.1/response/#elements for details.
do_search( $url [, $method] )
Performs a request for the given URL and returns a
WWW::OpenSearch::Response object. Method defaults to 'GET'.
ACCESSORS
description_url( [$description_url] )
agent( [$agent] )
description( [$description] )
AUTHOR
Brian Cassidy <bricas@cpan.org>
Tatsuhiko Miyagawa <miyagawa@bulknews.net>
COPYRIGHT AND LICENSE
Copyright 2005-2013 by Tatsuhiko Miyagawa and Brian Cassidy
This library is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
|