zzak	2013-11-09 14:56:09 +0900 (Sat, 09 Nov 2013)

  New Revision: 43601

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

  Log:
    * lib/rss/*: [DOC] document various constants @steveklabnik [Bug #8812]

  Modified files:
    trunk/ChangeLog
    trunk/lib/rss/content.rb
    trunk/lib/rss/dublincore.rb
    trunk/lib/rss/image.rb
    trunk/lib/rss/itunes.rb
    trunk/lib/rss/parser.rb
    trunk/lib/rss/slash.rb
    trunk/lib/rss/syndication.rb
    trunk/lib/rss/taxonomy.rb
Index: ChangeLog
===================================================================
--- ChangeLog	(revision 43600)
+++ ChangeLog	(revision 43601)
@@ -1,3 +1,7 @@ https://github.com/ruby/ruby/blob/trunk/ChangeLog#L1
+Sat Nov  9 14:54:52 2013  Zachary Scott  <e@z...>
+
+	* lib/rss/*: [DOC] document various constants @steveklabnik [Bug #8812]
+
 Sat Nov  9 14:50:09 2013  Zachary Scott  <e@z...>
 
 	* lib/rss/rss.rb: [DOC] document Time#w3cdtf by @steveklabnik
Index: lib/rss/taxonomy.rb
===================================================================
--- lib/rss/taxonomy.rb	(revision 43600)
+++ lib/rss/taxonomy.rb	(revision 43601)
@@ -2,12 +2,14 @@ require "rss/1.0" https://github.com/ruby/ruby/blob/trunk/lib/rss/taxonomy.rb#L2
 require "rss/dublincore"
 
 module RSS
-
+  # The prefix for the Taxonomy XML namespace.
   TAXO_PREFIX = "taxo"
+  # The URI for the specification of the Taxonomy XML namespace.
   TAXO_URI = "http://purl.org/rss/1.0/modules/taxonomy/"
 
   RDF.install_ns(TAXO_PREFIX, TAXO_URI)
 
+  # The listing of all the taxonomy elements, with the appropriate namespace.
   TAXO_ELEMENTS = []
 
   %w(link).each do |name|
Index: lib/rss/image.rb
===================================================================
--- lib/rss/image.rb	(revision 43600)
+++ lib/rss/image.rb	(revision 43601)
@@ -3,11 +3,15 @@ require 'rss/dublincore' https://github.com/ruby/ruby/blob/trunk/lib/rss/image.rb#L3
 
 module RSS
 
+  # The prefix for the Image XML namespace.
   IMAGE_PREFIX = 'image'
+  # The URI for the Image specification.
   IMAGE_URI = 'http://purl.org/rss/1.0/modules/image/'
 
   RDF.install_ns(IMAGE_PREFIX, IMAGE_URI)
 
+  # This constant holds strings which contain the names of
+  # image elements, with the appropriate prefix.
   IMAGE_ELEMENTS = []
 
   %w(item favicon).each do |name|
Index: lib/rss/syndication.rb
===================================================================
--- lib/rss/syndication.rb	(revision 43600)
+++ lib/rss/syndication.rb	(revision 43601)
@@ -1,8 +1,9 @@ https://github.com/ruby/ruby/blob/trunk/lib/rss/syndication.rb#L1
 require "rss/1.0"
 
 module RSS
-
+  # The prefix for the Syndication XML namespace.
   SY_PREFIX = 'sy'
+  # The URI of the Syndication specification.
   SY_URI = "http://purl.org/rss/1.0/modules/syndication/"
 
   RDF.install_ns(SY_PREFIX, SY_URI)
Index: lib/rss/dublincore.rb
===================================================================
--- lib/rss/dublincore.rb	(revision 43600)
+++ lib/rss/dublincore.rb	(revision 43601)
@@ -1,7 +1,9 @@ https://github.com/ruby/ruby/blob/trunk/lib/rss/dublincore.rb#L1
 require "rss/rss"
 
 module RSS
+  # The prefix for the Dublin Core XML namespace.
   DC_PREFIX = 'dc'
+  # The URI of the Dublin Core specification.
   DC_URI = "http://purl.org/dc/elements/1.1/"
 
   module BaseDublinCoreModel
Index: lib/rss/parser.rb
===================================================================
--- lib/rss/parser.rb	(revision 43600)
+++ lib/rss/parser.rb	(revision 43601)
@@ -545,6 +545,7 @@ module RSS https://github.com/ruby/ruby/blob/trunk/lib/rss/parser.rb#L545
   end
 
   unless const_defined? :AVAILABLE_PARSER_LIBRARIES
+    # The list of all available libraries for parsing.
     AVAILABLE_PARSER_LIBRARIES = [
       ["rss/xmlparser", :XMLParserParser],
       ["rss/xmlscanner", :XMLScanParser],
@@ -552,6 +553,7 @@ module RSS https://github.com/ruby/ruby/blob/trunk/lib/rss/parser.rb#L553
     ]
   end
 
+  # The list of all available parsers, in constant form.
   AVAILABLE_PARSERS = []
 
   AVAILABLE_PARSER_LIBRARIES.each do |lib, parser|
Index: lib/rss/itunes.rb
===================================================================
--- lib/rss/itunes.rb	(revision 43600)
+++ lib/rss/itunes.rb	(revision 43601)
@@ -1,7 +1,9 @@ https://github.com/ruby/ruby/blob/trunk/lib/rss/itunes.rb#L1
 require 'rss/2.0'
 
 module RSS
+  # The prefix for the iTunes XML namespace.
   ITUNES_PREFIX = 'itunes'
+  # The URI of the iTunes specification.
   ITUNES_URI = 'http://www.itunes.com/dtds/podcast-1.0.dtd'
 
   Rss.install_ns(ITUNES_PREFIX, ITUNES_URI)
Index: lib/rss/content.rb
===================================================================
--- lib/rss/content.rb	(revision 43600)
+++ lib/rss/content.rb	(revision 43601)
@@ -1,7 +1,9 @@ https://github.com/ruby/ruby/blob/trunk/lib/rss/content.rb#L1
 require "rss/rss"
 
 module RSS
+  # The prefix for the Content XML namespace.
   CONTENT_PREFIX = 'content'
+  # The URI of the Content specification.
   CONTENT_URI = "http://purl.org/rss/1.0/modules/content/"
 
   module ContentModel
Index: lib/rss/slash.rb
===================================================================
--- lib/rss/slash.rb	(revision 43600)
+++ lib/rss/slash.rb	(revision 43601)
@@ -1,7 +1,9 @@ https://github.com/ruby/ruby/blob/trunk/lib/rss/slash.rb#L1
 require 'rss/1.0'
 
 module RSS
+  # The prefix for the Slash XML namespace.
   SLASH_PREFIX = 'slash'
+  # The URI of the Slash specification.
   SLASH_URI = "http://purl.org/rss/1.0/modules/slash/"
 
   RDF.install_ns(SLASH_PREFIX, SLASH_URI)

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