This file is indexed.

/usr/share/doc/libxml-atom-fromowl-perl/README is in libxml-atom-fromowl-perl 0.102-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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
NAME
    XML::Atom::FromOWL - export RDF data to Atom

SYNOPSIS
     use LWP::UserAgent;
     use XML::Atom::OWL;
     use XML::Atom::FromOWL;
 
     my $ua       = LWP::UserAgent->new;
     my $r        = $ua->get('http://intertwingly.net/blog/index.atom');
     my $atomowl  = XML::Atom::OWL->new($r->decoded_content, $r->base);
     my $model    = $atomowl->consume->graph;  ## an RDF::Trine::Model
 
     my $exporter = XML::Atom::FromOWL->new;
     print $_->as_xml
            foreach $exporter->export_feeds($model);

DESCRIPTION
    This module reads RDF and writes Atom feeds. It does the reverse of
    XML::Atom::OWL.

  Constructor
    *   `new(%options)`

        Returns a new XML::Atom::FromOWL object.

        There are no valid options at the moment - the hash is reserved for
        future use.

  Methods
    *   `export_feeds($input, %options)`

        Returns a list of feeds found in the input, in no particular order.

        The input may be a URI, file name, RDF::Trine::Model or anything else
        that can be handled by the `parse` function of RDF::TrineX::Functions.

        Each item in the list returned is an XML::Atom::Feed.

    *   `export_feed($input, $subject, %options)`

        As per `export_feeds` but exports just a single feed.

        The subject provided must be an RDF::Trine::Node::Blank or
        RDF::Trine::Node::Resource of type awol:Feed.

    *   `export_entries($input, %options)`

        Returns a list of entries found in the input, in no particular order.

        The input may be a URI, file name, RDF::Trine::Model or anything else
        that can be handled by the `parse` function of RDF::TrineX::Functions.

        Each item in the list returned is an XML::Atom::Entry.

    *   `export_entry($input, $subject, %options)`

        As per `export_entry` but exports just a single entry.

        The subject provided must be an RDF::Trine::Node::Blank or
        RDF::Trine::Node::Resource of type awol:Entry.

  RDF Input
    Input is expected to use AtomOwl
    <http://bblfish.net/work/atom-owl/2006-06-06/#>.

  Feed Output
    This module doesn't attempt to enforce many of OWL's semantic constraints
    (e.g. it doesn't enforce that an entry has only one title). It relies on
    XML::Atom::Feed and XML::Atom::Entry for that sort of thing, but if your
    input is sensible that shouldn't be a problem.

SEE ALSO
    XML::Atom::OWL, HTML::Microformats, RDF::TrineX::Functions,
    XML::Atom::Feed, XML::Atom::Entry.

    <http://bblfish.net/work/atom-owl/2006-06-06/>.

    <http://www.perlrdf.org/>.

AUTHOR
    Toby Inkster <tobyink@cpan.org>.

COPYRIGHT AND LICENCE
    This software is copyright (c) 2011-2012 by Toby Inkster.

    This is free software; you can redistribute it and/or modify it under the
    same terms as the Perl 5 programming language system itself.

DISCLAIMER OF WARRANTIES
    THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
    WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
    MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.