fix IPython embed documentation

Also clean up old comments and bring the style of this file up to
current standards
Merge pull request #6078 from ivanov/tiny-embed-cleanup

fix IPython embed documentation