Devil Killer Is Here MiNi Shell
MiNi SheLL

Current Path : /proc/thread-self/root/usr/local/man/man3/
Linux boscustweb5005.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.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 3"
.TH XML::Atom::Syndication 3 "2006-08-17" "perl v5.8.8" "User Contributed Perl Documentation"
.SH "NAME"
XML::Atom::Syndication \- a portable client for 
consuming RFC 4287 Atom Syndication Feeds.
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This project is the result of scratching ones own itch. I
was writing some web software needed a full-featured library
for working with Atom feeds that was easy to distribute and
install on wide range of environments. Many of my software's
target audience are relative novices working with low-cost
shared hosting environments. (A significant number don't
even have shell access!) Creating a library that was easy to
install even by \s-1FTP\s0 was a paramount requirement that many
other options failed to meet.
.PP
Originally the module began as a very spartan XPath driven
interface. At the time the format had just been introduced
and was still vague and very extremely volatile. It was a
pretty wretched piece of software, but it got me through
while the Atom Working Group worked out the details of the
Atom Syndication Format.
.PP
Since that time the Atom Syndication Format (\s-1ASF\s0) has made
its way through numerous drafts and is now an approved
standard of the \s-1IETF\s0 as \s-1RFC\s0 4287.
.PP
Beginning with version 0.9, XML::Atom::Syndication has been
completely rewritten to provide better functionality and
structure in working with a stable Atom format
specification.
.PP
The interface and a fair bit of the code was based on that
of XML::Atom. It owes a great deal to its authors, Ben
Trott and Tatsuhiko Miyagawa, and all its contributors.
.PP
As of version 0.16, XML::Atom defaults to version 0.3 which
is now deprecated.  Baseline 1.0 support has been built-in
however many of the changes that were introduced (category
elements, dropping the mode attribute in the content
construct) have yet to be implemented. I'm sure this will
change eventually, but it currently is a differentiator
between the two implementations. XML::Atom::Syndication
supports 0.3, but defaults 1.0.
.PP
More importantly this implementation is not tied to specific
\&\s-1XML\s0 parsers \*(-- XML::LibXML or XML::XPath (expat) as is the
case with XML::Atom. Both of these parsers libraries require
compilation  which can be a major hurdle if you are not in
charge of your hosting environment. By using \s-1SAX\s0 at the
core, this Atom implementation will work with whatever
parser it can find including the default pure perl option
that \s-1XML::SAX\s0 is distributed with.
.PP
Unlike XML::Atom, this distribution focuses on the Atom
syndication format and not the publishing protocol. The
publishing protocol is still being worked out and is not an
official standard at this time.
.Sh "\s-1ENCODING\s0"
.IX Subsection "ENCODING"
Perl has a spotty history of supporting international
character sets prior to version 5.8.1. All caveats and
cautions apply when using this package with character sets
other then \s-1ASCII\s0 with versions of Perl before that time.
.PP
When used with Perl 5.8.1 and higher XML::Atom::Syndication
will look for the encoding in the \s-1XML\s0 declaration and
convert it to \s-1UTF\-8\s0 right before parsing. This simplifies
further processing a great deal. Perl 5.8+ uses \s-1UTF\-8\s0
internally and numerous other modules (such as
XML::Writer) will only work with \s-1UTF\-8\s0 encoded content.
.PP
I found this also has the added benefit of making this
package more portable. Perl's built-in encoding converters
are more extensive then what typically ships with the
standard parser. By converting to \s-1UTF\-8\s0 using Perl's system
before parsing the potential for an encoding module
dependency is eliminated. All \s-1XML\s0 parsers must support
\&\s-1UTF\-8\s0.
.PP
All output using XML::Atom::Syndication::Writer will be
in \s-1UTF\-8\s0 regardless of the original encoding before parsing.
.SH "DEPENDENCIES"
.IX Header "DEPENDENCIES"
.IP "XML::Elemental 2.0" 4
.IX Item "XML::Elemental 2.0"
.PD 0
.IP "XML::Writer 0.600" 4
.IX Item "XML::Writer 0.600"
.IP "Class::ErrorHandler" 4
.IX Item "Class::ErrorHandler"
.IP "MIME::Base64" 4
.IX Item "MIME::Base64"
.PD
.SH "SEE ALSO"
.IX Header "SEE ALSO"
XML::Atom, \s-1XML::RAI\s0
.PP
http://www.atomenabled.org/developers/syndication/atom\-format\-spec.php
.SH "LICENSE"
.IX Header "LICENSE"
The software is released under the Artistic License. The
terms of the Artistic License are described at
<http://www.perl.com/language/misc/Artistic.html>.
.SH "AUTHOR & COPYRIGHT"
.IX Header "AUTHOR & COPYRIGHT"
Except where otherwise noted, XML::Atom::Syndication is
Copyright 2004\-2006, Timothy Appnel, tima@cpan.org.
All rights reserved.
Creat By MiNi SheLL
Email: devilkiller@gmail.com