DOC: make api docs reflect api usage (#4539)
Merge pull request #5208 from jorisvandenbossche/doc-currentmodule

DOC: make api docs reflect api usage (#4539)