From f8488a270f5ae97191a160be295d604c8e64919d Mon Sep 17 00:00:00 2001
From: drbrain <drbrain@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>
Date: Fri, 20 May 2011 17:37:02 +0000
Subject: [PATCH] 	* ext/date/lib/date/format.rb:  Document date formats.
  Patch by 	  Clinton Nixon.  [Ruby 1.9 - Bug #4743]

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@31650 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
---
 ChangeLog                   |  5 +++++
 ext/date/lib/date/format.rb | 24 ++++++++++++++++++++++++
 2 files changed, 29 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index 667b9bcc0f..ee95925379 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+Sat May 21 02:22:34 2011  Eric Hodel  <drbrain@segment7.net>
+
+	* ext/date/lib/date/format.rb:  Document date formats.  Patch by
+	  Clinton Nixon.  [Ruby 1.9 - Bug #4743]
+
 Fri May 20 05:15:19 2011  Nobuhiro Iwamatsu  <iwamatsu@nigauri.org>
 
 	* gc.c: Fix build on m68k by 'error: too few arguments to
diff --git a/ext/date/lib/date/format.rb b/ext/date/lib/date/format.rb
index 84bc7df9c2..3da4c40f51 100644
--- a/ext/date/lib/date/format.rb
+++ b/ext/date/lib/date/format.rb
@@ -1,4 +1,6 @@
+#--
 # format.rb: Written by Tadayoshi Funaba 1999-2011
+#++
 
 class Date
 
@@ -110,22 +112,44 @@ class Date
 
   end
 
+  # Returns a String representing this Date in the form:
+  # Sun Sep 30 00:00:00 1977.
   def asctime() strftime('%c') end
 
   alias_method :ctime, :asctime
 
+  # Returns a String representing this Date in the form:
+  # 1977-09-30.
+  #
+  # This form is in accordance with
+  # ISO8601[http://www.iso.org/iso/support/faqs/faqs_widely_used_standards/widely_used_standards_other/date_and_time_format.htm].
   def iso8601() strftime('%F') end
 
+  # Returns a String representing this Date in the form:
+  # 1977-09-30T00:00:00+00:00
+  #
+  # This form is in accordance with the format for a timestamp in
+  # RFC3339[http://www.ietf.org/rfc/rfc3339.txt].
   def rfc3339() strftime('%FT%T%:z') end
 
+  # Synonym for Date.iso8601.
   def xmlschema() iso8601 end # :nodoc:
 
+  # Returns a String representing this Date in the form:
+  # Fri, 30 Sep 1977 00:00:00 +0000
+  #
+  # This form is in accordance with the format for a full
+  # date and time specification in
+  # RFC2822[http://www.ietf.org/rfc/rfc2822.txt].
   def rfc2822() strftime('%a, %-d %b %Y %T %z') end
 
   alias_method :rfc822, :rfc2822
 
   def httpdate() new_offset(0).strftime('%a, %d %b %Y %T GMT') end # :nodoc:
 
+  # Returns a String representing this Date in a form
+  # that is in accordance with the Japanese specification
+  # JIS X 0301.
   def jisx0301
     if jd < 2405160
       strftime('%F')