From 3e1fad843e29d8004aabf2f30a9bb031b02ca209 Mon Sep 17 00:00:00 2001 From: zzak Date: Sat, 27 Apr 2013 14:26:20 +0000 Subject: * lib/yaml.rb: Documentation for YAML module [Bug #8213] git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@40499 b2dd03c8-39d4-4d8f-98ff-823fe69b080e --- ChangeLog | 4 ++++ lib/yaml.rb | 25 ++++++++++++++++++++++++- 2 files changed, 28 insertions(+), 1 deletion(-) diff --git a/ChangeLog b/ChangeLog index 43ea74caa1..9e2fda80ed 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +Sat Apr 27 23:25:00 2013 Zachary Scott + + * lib/yaml.rb: Documentation for YAML module [Bug #8213] + Sat Apr 27 20:19:21 2013 Tanaka Akira * thread_pthread.c (ruby_init_stack): Add STACK_GROW_DIR_DETECTION. diff --git a/lib/yaml.rb b/lib/yaml.rb index 93e869cd79..76657cdd0b 100644 --- a/lib/yaml.rb +++ b/lib/yaml.rb @@ -12,7 +12,7 @@ rescue LoadError raise end -module Psych +module Psych # :nodoc: class EngineManager # Returns the YAML engine in use. # @@ -53,4 +53,27 @@ module Psych ENGINE = EngineManager.new # :nodoc: end +# YAML Ain't Markup Language +# +# This module provides a Ruby interface for data serialization in YAML format. +# +# The underlying implementation depends on an engine to handle the parsing and +# serialization for Ruby, by default this will be using the libyaml wrapper +# Psych. +# +# See Psych::EngineManager for details on switching the default YAML engine. +# +# 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" +# +# For more advanced details on the implementation see Psych, and also check out +# yaml.org for spec details and other helpful information. +module YAML; end YAML = Psych -- cgit v1.2.3