(cherry picked from commit d4913ed)

Feed::utf8_for_xml() method used in the Feed::makeNode() method.

This also makes pagination work with RSS1 feeds. The method parameter for the feed URL itself was removed, because RFC 5005 only specifies the other four link relations. The URL to the feed can be set with the setSelfLink method.

- 'addCDATAEncoding' accepts array of properties that are added to
'\Feed->CDATAEncoding' array
- provides more flexibility for folks that need finer control over the
way property values are rendered

RSS2 constant is defined under Feed class

classes that are not part of the class namespace should have qualified names

Since this project requires PHP >= 5.3 anyway, the check for this version is not needed anymore in Item.php.

This was previously already possible by using the custom addElement function.

The namespace prefix and name can be set by invoking the addNamespace method of the Feed class.

See http://validator.w3.org/feed/docs/warning/MissingAtomSelfLink.html

It's actually the MIME type which is returned and then used for the HTTP Content-Type header field.

A minimal set of changes to support PSR-0-style autoloading:

- rename base class to \FeedWriter\Feed and FeedItem to \FeedWriter\Item
- break types out into \FeedWriter\ATOM, \FeedWriter\RSS1, and
  \FeedWriter\RSS2
- use class constants for versions
- make generateFeed() return a string rather than doing any IO itself
- add printFeed() to do output, if needed

My rationale for the last 2 items on that list is that our web framework
expects me to pass around strings, not do direct IO. I imagine needing
to grab the output and stash it in a variable or what-have-you is
a common use case, and it felt silly to have to wrap this in an
output buffer to accomplish that.

The FeedWriter class is now abstract, which means it is not possible to directly create an instance of it. Use the new wrapper classes in FeedTypes.php instead. This also obsoletes the constructor's version parameter for end-users.

* Only accept instances of FeedItem
* Only accept instances of FeedItem with the same feed type

* Fixed spelling mistakes
* All \n's were replaced by PHP_EOL's

APC shouldn't have to open files more than once, but it does if you use require_once instead of require. More details here:
http://www.techyouruniverse.com/software/php-performance-tip-require-versus-require_once

This time using htmlspecialchars instead of htmlentities, because we need a encoding for XML, not for HTML.

So this has now not to be done by the user. Another benefit of this change: The examples do work now. ;-)

(SVN import from repo. "www" @ revision 615, made by "Michi" on Oktober 31, 2010 (02:39:15))