Devil Killer Is Here MiNi Shell
MiNi SheLL

Current Path : /proc/thread-self/root/usr/local/man/man3/
Linux boscustweb5002.eigbox.net 5.4.91 #1 SMP Wed Jan 20 18:10:28 EST 2021 x86_64
Current File : //proc/thread-self/root/usr/local/man/man3/XML::Atom::Syndication::Feed.3
.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.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.  | will give a
.\" real vertical bar.  \*(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-|\(bv\*(Tr
.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\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" 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 "XML::Atom::Syndication::Feed 3"
.TH XML::Atom::Syndication::Feed 3 "2006-08-17" "perl v5.8.8" "User Contributed Perl Documentation"
.SH "NAME"
XML::Atom::Syndication::Feed \- class representing an Atom feed
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 4
\&    use XML::Atom::Syndication::Feed;
\&    use XML::Atom::Syndication::Entry;
\&    use XML::Atom::Syndication::Text;
\&    use XML::Atom::Syndication::Content;
.Ve
.PP
.Vb 12
\&    # create a feed
\&    my $feed = XML::Atom::Syndication::Feed->new;
\&    $feed->title('My Weblog');
\&    my $entry = XML::Atom::Syndication::Entry->new;
\&    my $title = XML::Atom::Syndication::Text->new(Name=>'title');
\&    $title->body('First Post');
\&    $entry->title($title);
\&    my $content = XML::Atom::Syndication::Content->new('Post Body');
\&    $entry->content($content);
\&    $feed->add_entry($entry);
\&    $feed->insert_entry($entry);
\&    print $feed->as_xml;
.Ve
.PP
.Vb 4
\&    # list entry titles of index.atom file
\&    my $feed2 = XML::Atom::Syndication::Feed->new('index.atom');
\&    my @entries = $feed->entries;
\&    print $_->title->body."\en" for @entries;
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
XML::Atom::Syndication::Feed element is the document (i.e.,
top\-level) element of an Atom Feed Document, acting as a
container for metadata and data associated with the feed.
Its element children consist of metadata elements followed
by zero or more entry child elements.
.SH "METHODS"
.IX Header "METHODS"
XML::Atom::Syndication::Feed is a subclass of
XML::Atom::Syndication::Object (via
XML::Atom::Syndication:::Thing) that it inherits numerous
methods from. You should already be familiar with this base
class before proceeding.
.IP "Class\->new(%params)" 4
.IX Item "Class->new(%params)"
In addition to the keys recognized by its superclass
(XML::Atom::Syndication::Object) this class recognizes a
\&\f(CW\*(C`Stream\*(C'\fR element. The value of this element can be a \s-1SCALAR\s0
or \s-1FILEHANDLE\s0 (\s-1GLOB\s0) to a valid Atom document. The \f(CW\*(C`Stream\*(C'\fR
element takes precedence over the standard \f(CW\*(C`Elem\*(C'\fR element.
.IP "inner_atom($atom_markup_string)" 4
.IX Item "inner_atom($atom_markup_string)"
This is a convenience method for quickly setting
the child Atom elements of the feed with a string.
The string must also be well-formed \s-1XML\s0. This
method will replaces any existing child elements.
All elements are presumed to be in the same Atom
namespace as the feed object.
.Sp
This method is similar to the innerHTML property
found in JavaScript.
.IP "author" 4
.IX Item "author"
Indicates the author of the feed.
.Sp
This accessor returns a XML::Atom::Syndication::Person
object. This element can be set using a string and hash
reference or by passing in an object. See Working with
Object Setters in XML::Atom::Syndication::Object for more
detail.
.IP "category" 4
.IX Item "category"
Conveys information about a category associated with an feed.
.Sp
This accessor returns a XML::Atom::Syndication::Category
object. This element can be set using a string and hash
reference or by passing in an object. See Working with
Object Setters in XML::Atom::Syndication::Object for more
detail.
.IP "contributor" 4
.IX Item "contributor"
Indicates a person or other entity who contributed to the
feed.
.Sp
This accessor returns a XML::Atom::Syndication::Person
object. This element can be set using a string and hash
reference or by passing in an object. See Working with
Object Setters in XML::Atom::Syndication::Object for more
detail.
.IP "generator" 4
.IX Item "generator"
Identifies the agent used to generate a feed for debugging
and other purposes. 
.Sp
This accessor returns a XML::Atom::Syndication::Generator
object. This element can be set using a string and hash
reference or by passing in an object. See Working with
Object Setters in XML::Atom::Syndication::Object for more
detail.
.IP "icon" 4
.IX Item "icon"
An \s-1IRI\s0 reference [\s-1RFC3987\s0] which identifies an image which
provides iconic visual identification for a feed.
.Sp
This accessor returns a string. You can set this attribute
by passing in an optional string.
.IP "id" 4
.IX Item "id"
A permanent, universally unique identifier for a feed.
.Sp
This accessor returns a string. You can set this attribute
by passing in an optional string.
.IP "link" 4
.IX Item "link"
Defines a reference from an entry to a Web resource.
.Sp
This accessor returns a XML::Atom::Syndication::Link
object. This element can be set using a string and hash
reference or by passing in an object. See Working with
Object Setters in XML::Atom::Syndication::Object for more
detail.
.IP "logo" 4
.IX Item "logo"
An \s-1IRI\s0 reference [\s-1RFC3987\s0] which identifies an image which
provides visual identification for a feed.
.Sp
This accessor returns a string. You can set this attribute
by passing in an optional string.
.IP "published" 4
.IX Item "published"
A date indicating an instance in time associated with an
event early in the life of the entry.
.Sp
This accessor returns a string. You can set this attribute
by passing in an optional string. Dates values \s-1MUST\s0 conform
to the \*(L"date\-time\*(R" production in [\s-1RFC3339\s0].
.IP "rights" 4
.IX Item "rights"
Conveys information about rights held in and over an entry
or feed.
.Sp
This accessor returns a XML::Atom::Syndication::Text
object. This element can be set using a string and hash
reference or by passing in an object. See Working with
Object Setters in XML::Atom::Syndication::Object for more
detail.
.IP "subtitle" 4
.IX Item "subtitle"
Conveys a human-readable description or subtitle of a feed.
.Sp
This accessor returns a XML::Atom::Syndication::Text
object. This element can be set using a string and hash
reference or by passing in an object. See Working with
Object Setters in XML::Atom::Syndication::Object for more
detail.
.IP "title" 4
.IX Item "title"
Conveys a human-readable title for a feed.
.Sp
This accessor returns a XML::Atom::Syndication::Text
object. This element can be set using a string and hash
reference or by passing in an object. See Working with
Object Setters in XML::Atom::Syndication::Object for more
detail.
.IP "updated" 4
.IX Item "updated"
The most recent instance in time when an entry or feed was
modified in a way the publisher considers significant. 
.Sp
This accessor returns a string. You can set this attribute
by passing in an optional string. Dates values \s-1MUST\s0 conform
to the \*(L"date\-time\*(R" production in [\s-1RFC3339\s0].
.Sh "\s-1ENTRIES\s0"
.IX Subsection "ENTRIES"
.IP "$feed\->add_entry($entry)" 4
.IX Item "$feed->add_entry($entry)"
Appends a XML::Atom::Syndication::Entry object to the
feed. The new entry is placed after all existing entries in
the feed
.IP "$feed\->insert_entry($entry)" 4
.IX Item "$feed->insert_entry($entry)"
Inserts a XML::Atom::Syndication::Entry object \fIbefore\fR
all other existing entries in the feed.
.IP "$feed\->entries" 4
.IX Item "$feed->entries"
Returns an ordered \s-1ARRAY\s0 of XML::Atom::Syndication::Entry objects 
representing the feed's entries.
.Sh "\s-1DEPRECATED\s0"
.IX Subsection "DEPRECATED"
.IP "copyright" 4
.IX Item "copyright"
This element was renamed \f(CW\*(C`rights\*(C'\fR in version 1.0 of the format.
.IP "created" 4
.IX Item "created"
This element was removed from version 1.0 of the format.
.IP "info" 4
.IX Item "info"
This element was removed from version 1.0 of the format.
.IP "modified" 4
.IX Item "modified"
This element was renamed \f(CW\*(C`updated\*(C'\fR in version 1.0 of the format.
.IP "tagline" 4
.IX Item "tagline"
This element was renamed \f(CW\*(C`subtitle\*(C'\fR in version 1.0 of the format.
.IP "version" 4
.IX Item "version"
This attribute was removed from version 1.0 of the format.
.SH "AUTHOR & COPYRIGHT"
.IX Header "AUTHOR & COPYRIGHT"
Please see the XML::Atom::Syndication manpage for author,
copyright, and license information.
Creat By MiNi SheLL
Email: devilkiller@gmail.com