zzak	2013-08-05 03:58:00 +0900 (Mon, 05 Aug 2013)

  New Revision: 42378

  http://svn.ruby-lang.org/cgi-bin/viewvc.cgi?view=rev&revision=42378

  Log:
    * lib/rss/0.9.rb: [DOC] Document RSS09 by Steve Klabnik [Bug #8732]

  Modified files:
    trunk/ChangeLog
    trunk/lib/rss/0.9.rb

Index: ChangeLog
===================================================================
--- ChangeLog	(revision 42377)
+++ ChangeLog	(revision 42378)
@@ -1,3 +1,7 @@ https://github.com/ruby/ruby/blob/trunk/ChangeLog#L1
+Mon Aug  5 03:57:16 2013  Zachary Scott  <e@z...>
+
+	* lib/rss/0.9.rb: [DOC] Document RSS09 by Steve Klabnik [Bug #8732]
+
 Mon Aug  5 03:35:11 2013  Zachary Scott  <e@z...>
 
 	* lib/rexml/attribute.rb: [DOC] Update example for #namespace
Index: lib/rss/0.9.rb
===================================================================
--- lib/rss/0.9.rb	(revision 42377)
+++ lib/rss/0.9.rb	(revision 42378)
@@ -2,6 +2,39 @@ require "rss/parser" https://github.com/ruby/ruby/blob/trunk/lib/rss/0.9.rb#L2
 
 module RSS
 
+  ##
+  # = RSS 0.9 support
+  #
+  # RSS has three different versions. This module contains support for version
+  # 0.9.1[http://www.rssboard.org/rss-0-9-1-netscape].
+  #
+  # == Producing RSS 0.9
+  #
+  # Producing our own RSS feeds is easy as well. Let's make a very basic feed:
+  #
+  #  require "rss"
+  #
+  #  rss = RSS::Maker.make("0.91") do |maker|
+  #    maker.channel.language = "en"
+  #    maker.channel.author = "matz"
+  #    maker.channel.updated = Time.now.to_s
+  #    maker.channel.link = "http://www.ruby-lang.org/en/feeds/news.rss"
+  #    maker.channel.title = "Example Feed"
+  #    maker.channel.description = "A longer description of my feed."
+  #    maker.image.url = "http://www.ruby-lang.org/images/logo.gif"
+  #    maker.image.title = "An image
+  #    maker.items.new_item do |item|
+  #      item.link = "http://www.ruby-lang.org/en/news/2010/12/25/ruby-1-9-2-p136-is-released/"
+  #      item.title = "Ruby 1.9.2-p136 is released"
+  #      item.updated = Time.now.to_s
+  #    end
+  #  end
+  #
+  #  puts rss
+  #
+  # As you can see, this is a very Builder-like DSL. This code will spit out an
+  # RSS 0.9 feed with one item. If we needed a second item, we'd make another
+  # block with maker.items.new_item and build a second one.
   module RSS09
     NSPOOL = {}
     ELEMENTS = []

--
ML: ruby-changes@q...
Info: http://www.atdot.net/~ko1/quickml/