real.py docstring cleanup
(#526)