[embind docs] Reformat and cleanup whitespace.
Merge pull request #2929 from waywardmonkeys/embind-docs

[embind docs] Reformat and cleanup whitespace.