Y.Selector documentation, resolves #630

This fixes #630.

I either added, or improved all of the documentation for `Y.Selector`'s public methods.