Various documentation changes

Please test that the HTML is actually valid and renders correctly.

I removed the little paragraph about multiple returns from 1080-1082 since it's useless and misleading. We aren't "returning multiple values using an array-like notation", we are *actually returning an array*.