diff --git a/ChangeLog b/ChangeLog index 068827f86f..17a3d83e87 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +Tue Aug 6 22:35:32 2013 Zachary Scott + + * lib/rss/1.0.rb: [DOC] Document RSS110 by Steve Klabnik [Bug #8740] + Tue Aug 6 22:14:11 2013 Kouji Takao * ext/readline/readline.c (readline_s_delete_text): remove diff --git a/lib/rss/1.0.rb b/lib/rss/1.0.rb index 2ff53b4723..a2d88d459e 100644 --- a/lib/rss/1.0.rb +++ b/lib/rss/1.0.rb @@ -2,6 +2,38 @@ require "rss/parser" module RSS + ## + # = RSS 1.0 support + # + # RSS has three different versions. This module contains support for version + # 1.0[http://web.resource.org/rss/1.0/] + # + # == Producing RSS 1.0 + # + # Producing our own RSS feeds is easy as well. Let's make a very basic feed: + # + # require "rss" + # + # rss = RSS::Maker.make("1.0") do |maker| + # maker.channel.language = "en" + # maker.channel.author = "matz" + # maker.channel.about = "About my feed." + # 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.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 1.0 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 RSS10 NSPOOL = {} ELEMENTS = []