Documentation suggestions

[skip at pobox.com]

    >>> A series of examples seems more concrete than a formal description,<<

    rd> Amen. This is why people buy the books: The good ones have lots of
    rd> examples. The wizards glance at them in passing and think, "Duh."
    rd> And the rest of us (including the intermediate folks, I'll bet) are
    rd> grateful for the chance to see a real live example.

ISTR that comment was made in reference to the Language Reference, which as
written is intended for "language lawyers".  Examples there seem
counterproductive.

Skip