Document multi term vector api

Documentation for multi term vectors. Also this pull request makes parsing of rest requests consistent with single term vector api.

Closes #3998