We were discussing changing the docstring on the pull request and I had additional questions, so I am moving them here for discussion:

I've been looking at pydoc math and pydoc time (and the the module.c source).

Before I go down the wrong path, I'm not sure I fully understand your comment - "(Also, markup can be improved in the time module docstring. Compare pydoc time and pydoc math.)" The time one is more vebose in the description and it lists the Variables and Functions in the text and then defines them with markup further down. Are you saying the variables and functions should be removed from being written in text within the description?

Thanks.