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


git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/branches/ruby_1_9_3@40982 b2dd03c8-39d4-4d8f-98ff-823fe69b080e