Author: as
Date: Mon Mar  3 15:53:46 2008
New Revision: 7501

Log:
- Some more details about the generated feed.

Modified:
    trunk/Feed/docs/tutorial.txt
    trunk/Feed/src/feed.php

Modified: trunk/Feed/docs/tutorial.txt
==============================================================================
--- trunk/Feed/docs/tutorial.txt [iso-8859-1] (original)
+++ trunk/Feed/docs/tutorial.txt [iso-8859-1] Mon Mar  3 15:53:46 2008
@@ -210,7 +210,9 @@
         echo $module->getNamespace();
     }
 
-- generate an XML document from the ezcFeed object. Example::
+- generate an XML document from the ezcFeed object. The result string should be
+  saved to a file, and a link to a file made accessible. See
+  `Provide access to feeds in a web application`_. Example::
 
     $xml = $feed->generate();
 
@@ -473,6 +475,9 @@
 .. include:: examples/feed_creator/data/news.xml
    :literal:
 
+See the section `Provide access to feeds in a web application`_ for details on
+how to provide access to the generated XML feed.
+
 
 Best practices
 ==============
@@ -488,13 +493,6 @@
 
 All ATOM feeds must be identified with the *application/atom+xml* media type.
 Use the getContentType() method of ezcFeed to get this string.
-
-
-Self link
-`````````
-
-All ATOM feeds should have a *link* feed element with *rel="self"* which
-points back to the feed itself (with the *href* attribute).
 
 
 RSS1
@@ -506,13 +504,6 @@
 All RSS1 feeds should be identified with the *application/rss+xml* media type
 (although it is not a standard yet). Use the getContentType() method of
 ezcFeed to get this string.
-
-
-Self link
-`````````
-
-All RSS1 feeds are required to have the *about* attribute which points back to
-the feed itself.
 
 
 RSS2

Modified: trunk/Feed/src/feed.php
==============================================================================
--- trunk/Feed/src/feed.php [iso-8859-1] (original)
+++ trunk/Feed/src/feed.php [iso-8859-1] Mon Mar  3 15:53:46 2008
@@ -91,7 +91,9 @@
  *      echo $module->getNamespace();
  *  }
  *  </code>
- *  - generate an XML document from the [EMAIL PROTECTED] ezcFeed} object. 
Example:
+ *  - generate an XML document from the [EMAIL PROTECTED] ezcFeed} object. The 
result
+ * string should be saved to a file, and a link to a file made accessible to
+ * users of the application. Example:
  *  <code>
  *  $xml = $feed->generate();
  *  </code>


-- 
svn-components mailing list
svn-components@lists.ez.no
http://lists.ez.no/mailman/listinfo/svn-components

Reply via email to