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::Source.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::Source 3"
.TH XML::Atom::Syndication::Source 3 "2006-08-17" "perl v5.8.8" "User Contributed Perl Documentation"
.SH "NAME"
XML::Atom::Syndication::Source \- class representing an Atom
source element
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
If an Atom entry is copied from one feed into another feed,
then the source atom:feed's metadata (all child elements of
atom:feed other than the atom:entry elements) \s-1MAY\s0 be
preserved within the copied entry by adding an atom:source
child element, if it is not already present in the entry,
and including some or all of the source feed's Metadata
elements as the atom:source element's children. Such
metadata \s-1SHOULD\s0 be preserved if the source atom:feed
contains any of the child elements atom:author,
atom:contributor, atom:rights, or atom:category and those
child elements are not present in the source atom:entry.
.PP
The source element is designed to allow the aggregation
of entries from different feeds while retaining information
about an entry's source feed. For this reason, Atom
Processors which are performing such aggregation \s-1SHOULD\s0
include at least the required feed-level Metadata elements
(id, title, and updated) in the source element.
.PP
Essentially the source element contains any or all of the
elements that can be found in a feed element except for
published and atom entry elements.
.SH "METHODS"
.IX Header "METHODS"
XML::Atom::Syndication::Source is a subclass of
XML::Atom::Syndication::Object (via
XML::Atom::Syndication::Thing) that it inherits
a number of methods from. You should already be
familiar with this base class before proceeding.
.IP "Class\->new(%params);" 4
.IX Item "Class->new(%params);"
Constructor. A \s-1HASH\s0 can be passed to initialize the object. Recognized 
keys are:
.RS 4
.IP "Elem" 4
.IX Item "Elem"
A XML::Elemental::Element that will be used as the source for this object. 
This object can be retrieved or set using the \f(CW\*(C`elem\*(C'\fR method.
.IP "Namespace" 4
.IX Item "Namespace"
A string containing the namespace \s-1URI\s0 for the element.
.IP "Version" 4
.IX Item "Version"
A \s-1SCALAR\s0 contain the Atom format version. This hash key can
optionally be used instead of setting the element official
Atom Namespace URIs using the Namespace key. Recognized
values are 1.0 and 0.3. 1.0 is used as the default if
Namespace and Version are not defined.
.RE
.RS 4
.RE
.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 source 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 source object.
.Sp
This method is similar to the innerHTML property
found in JavaScript.
.IP "author" 4
.IX Item "author"
Indicates the author of the source 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 a source 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
source 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 source 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 "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 source
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 source 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 "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