Document usage of Lang.sub()

Unless I'm mistaken `Y.Lang.sub()` wasn't documented at all.

This PR documents its basic usage and the support for nested placeholders that I introduced in #1814