From: Dave Thomas <dave@...>
Date: 2008-03-17T01:53:21+09:00
Subject: Re: argh! more undocumented mysteries: to_yaml


On Mar 16, 2008, at 11:37 AM, Tom Cloyd wrote:

> Agreed - with all. And I own a copy of Pickaxe 2nd ed., in marvelous  
> searchable PDF format (highly recommended). However, the to_yaml  
> method is not documented in the discussion of the Object class -  
> it's not reasonable to expect EVERYTHING to be covered, I'm sure.

Tom:

(page numbers below are for the printed copy)

Page 758 is the description of the YAML standard library.

Because it's a standard library, you know you need to use require  
(page 653). And the examples on the YAML page all show the use of  
require.

I hadn't realized you owned a copy of the book--if I had, I could have  
saved you time by pointing you at these pages.

Just to reiterate: to_yaml is not a method of the built-in Object  
class. That's why it doesn't appear in the documentation of object.  
When you do <rewquire 'yaml'>, that library _adds_ the method to object.


Dave Thomas