doc/comment changes to base.py
(#467)