doc: revisions to base.py (2)