usa	2013-05-29 21:00:57 +0900 (Wed, 29 May 2013)

  New Revision: 40982

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

  Log:
    * lib/yaml.rb: documentation updates, patched by zzak.
      [ruby-core:54735] [Backport #8356]

  Modified files:
    branches/ruby_1_9_3/ChangeLog
    branches/ruby_1_9_3/lib/yaml.rb
    branches/ruby_1_9_3/version.h

Index: ruby_1_9_3/ChangeLog
===================================================================
--- ruby_1_9_3/ChangeLog	(revision 40981)
+++ ruby_1_9_3/ChangeLog	(revision 40982)
@@ -1,3 +1,8 @@ https://github.com/ruby/ruby/blob/trunk/ruby_1_9_3/ChangeLog#L1
+Wed May 29 20:59:38 2013  NAKAMURA Usaku  <usa@r...>
+
+	* lib/yaml.rb: documentation updates, patched by zzak.
+	  [ruby-core:54735] [Backport #8356]
+
 Wed May 15 14:04:39 2013  NAKAMURA Usaku  <usa@r...>
 
 	* Makefile.in (miniruby): 1.9.3 doesn't have POSTLINK macro.
Index: ruby_1_9_3/lib/yaml.rb
===================================================================
--- ruby_1_9_3/lib/yaml.rb	(revision 40981)
+++ ruby_1_9_3/lib/yaml.rb	(revision 40982)
@@ -1,18 +1,46 @@ https://github.com/ruby/ruby/blob/trunk/ruby_1_9_3/lib/yaml.rb#L1
-##
-# The YAML module allows you to use one of the two YAML engines that ship with
-# ruby.  By default Psych is used but the old and unmaintained Syck may be
-# chosen.
+# YAML Ain't Markup Language
 #
-# See Psych or Syck for usage and documentation.
+# This module provides a Ruby interface for data serialization in YAML format.
 #
-# To set the YAML engine to syck:
+# You can choose from one of two YAML engines that ship with Ruby 1.9. By
+# default Psych is used but the old unmaintained Syck may chosen.
 #
-#   YAML::ENGINE.yamler = 'syck'
+# == Usage
+#
+# Working with YAML can be very simple, for example:
+#
+#     require 'yaml' # STEP ONE, REQUIRE YAML!
+#     # Parse a YAML string
+#     YAML.load("--- foo") #=> "foo"
+#
+#     # Emit some YAML
+#     YAML.dump("foo")     # => "--- foo\n...\n"
+#     { :a => 'b'}.to_yaml  # => "---\n:a: b\n"
+#
+# == Security
+#
+# Do not use YAML to load untrusted data. Doing so is unsafe and could allow
+# malicious input to execute arbitrary code inside your application. Please see
+# doc/security.rdoc for more information.
+#
+# == Syck
 #
-# To set the YAML engine back to psych:
+# Syck was the original for YAML implementation in Ruby's standard library
+# developed by why the lucky stiff.
 #
+# If you prefer, you can still use Syck by changing the YAML::ENGINE like so:
+#
+#   YAML::ENGINE.yamler = 'syck'
+#   # switch back to the default Psych
 #   YAML::ENGINE.yamler = 'psych'
-
+#
+# In older Ruby versions, ie. <= 1.9, Syck is still provided, however it was
+# completely removed with the release of Ruby 2.0.0.
+#
+# == More info
+#
+# For more advanced details on the implementation see Psych, and also check out
+# http://yaml.org for spec details and other helpful information.
 module YAML
   class EngineManager # :nodoc:
     attr_reader :yamler
@@ -45,7 +73,7 @@ module YAML https://github.com/ruby/ruby/blob/trunk/ruby_1_9_3/lib/yaml.rb#L73
   ##
   # Allows changing the current YAML engine.  See YAML for details.
 
-  ENGINE = YAML::EngineManager.new
+  ENGINE = YAML::EngineManager.new # :nodoc:
 end
 
 if defined?(Psych)
@@ -65,11 +93,11 @@ else https://github.com/ruby/ruby/blob/trunk/ruby_1_9_3/lib/yaml.rb#L93
   end
 end
 
-module Syck
+module Syck # :nodoc:
   ENGINE = YAML::ENGINE
 end
 
-module Psych
+module Psych # :nodoc:
   ENGINE = YAML::ENGINE
 end
 
Index: ruby_1_9_3/version.h
===================================================================
--- ruby_1_9_3/version.h	(revision 40981)
+++ ruby_1_9_3/version.h	(revision 40982)
@@ -1,10 +1,10 @@ https://github.com/ruby/ruby/blob/trunk/ruby_1_9_3/version.h#L1
 #define RUBY_VERSION "1.9.3"
-#define RUBY_PATCHLEVEL 430
+#define RUBY_PATCHLEVEL 431
 
-#define RUBY_RELEASE_DATE "2013-05-15"
+#define RUBY_RELEASE_DATE "2013-05-29"
 #define RUBY_RELEASE_YEAR 2013
 #define RUBY_RELEASE_MONTH 5
-#define RUBY_RELEASE_DAY 15
+#define RUBY_RELEASE_DAY 29
 
 #include "ruby/version.h"
 

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