Y.Lang.sub documentation update, resolves #1217

This resolves issue #1217.

The new description of `sub` was taken directly from its predecessor: http://yuilibrary.com/yui/docs/api/classes/YUI~substitute.html#method_substitute