Replace existing doc with new version from Vinay.
Fixed markup and wrapped long lines from patch.
Needs review.