drbrain	2011-05-13 05:17:29 +0900 (Fri, 13 May 2011)

  New Revision: 31535

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

  Log:
    * lib/rss/atom.rb (module RSS):  Document URIs.  Patch by Mark Turner.
      [Ruby 1.9 - #4671]
    * lib/rss/rss.rb (module RSS):  Document exception classes.  Patch by
      Mark Turner.  [Ruby 1.9 - #4671]

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

Index: ChangeLog
===================================================================
--- ChangeLog	(revision 31534)
+++ ChangeLog	(revision 31535)
@@ -1,3 +1,10 @@
+Fri May 13 05:16:38 2011  Eric Hodel  <drbrain@s...>
+
+	* lib/rss/atom.rb (module RSS):  Document URIs.  Patch by Mark Turner.
+	  [Ruby 1.9 - #4671]
+	* lib/rss/rss.rb (module RSS):  Document exception classes.  Patch by
+	  Mark Turner.  [Ruby 1.9 - #4671]
+
 Fri May 13 02:15:18 2011  KOSAKI Motohiro  <kosaki.motohiro@g...>
 
 	* io.c (select_internal): remove unused variable (interrupt_flag).
Index: lib/rss/atom.rb
===================================================================
--- lib/rss/atom.rb	(revision 31534)
+++ lib/rss/atom.rb	(revision 31535)
@@ -2,7 +2,15 @@
 
 module RSS
   module Atom
+
+    ##
+    # The Atom URI W3C Namespace
+
     URI = "http://www.w3.org/2005/Atom"
+
+    ##
+    # The XHTML URI W3C Namespace
+
     XHTML_URI = "http://www.w3.org/1999/xhtml"
 
     module CommonModel
Index: lib/rss/rss.rb
===================================================================
--- lib/rss/rss.rb	(revision 31534)
+++ lib/rss/rss.rb	(revision 31535)
@@ -70,6 +70,9 @@
 
   class InvalidRSSError < Error; end
 
+  ##
+  # Raised if no matching tag is found.
+
   class MissingTagError < InvalidRSSError
     attr_reader :tag, :parent
     def initialize(tag, parent)
@@ -78,6 +81,9 @@
     end
   end
 
+  ##
+  # Raised if there are more occurrences of the tag than expected.
+
   class TooMuchTagError < InvalidRSSError
     attr_reader :tag, :parent
     def initialize(tag, parent)
@@ -86,6 +92,9 @@
     end
   end
 
+  ##
+  # Raised if a required attribute is missing.
+
   class MissingAttributeError < InvalidRSSError
     attr_reader :tag, :attribute
     def initialize(tag, attribute)
@@ -94,6 +103,9 @@
     end
   end
 
+  ##
+  # Raised when an unknown tag is found.
+
   class UnknownTagError < InvalidRSSError
     attr_reader :tag, :uri
     def initialize(tag, uri)
@@ -102,6 +114,9 @@
     end
   end
 
+  ##
+  # Raised when an unexpected tag is encountered.
+
   class NotExpectedTagError < InvalidRSSError
     attr_reader :tag, :uri, :parent
     def initialize(tag, uri, parent)
@@ -112,6 +127,9 @@
   # For backward compatibility :X
   NotExceptedTagError = NotExpectedTagError
 
+  ##
+  # Raised when an incorrect value is used.
+
   class NotAvailableValueError < InvalidRSSError
     attr_reader :tag, :value, :attribute
     def initialize(tag, value, attribute=nil)
@@ -123,6 +141,9 @@
     end
   end
 
+  ##
+  # Raised when an unknown conversion error occurs.
+
   class UnknownConversionMethodError < Error
     attr_reader :to, :from
     def initialize(to, from)
@@ -134,6 +155,9 @@
   # for backward compatibility
   UnknownConvertMethod = UnknownConversionMethodError
 
+  ##
+  # Raised when a conversion failure occurs.
+
   class ConversionError < Error
     attr_reader :string, :to, :from
     def initialize(string, to, from)
@@ -144,6 +168,9 @@
     end
   end
 
+  ##
+  # Raised when a required variable is not set.
+
   class NotSetError < Error
     attr_reader :name, :variables
     def initialize(name, variables)
@@ -153,6 +180,9 @@
     end
   end
 
+  ##
+  # Raised when a RSS::Maker attempts to use an unknown maker.
+
   class UnsupportedMakerVersionError < Error
     attr_reader :version
     def initialize(version)

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