I don't think that's enough documentation for the feature. There's a whole PEP 338 just for the -m option due to the subtle issue associated with the "run a module" logic, so I'd expect somewhat more detail or an update of the PEP with the needed details.

This page would be the appropriate place for a section on the topic, I guess:

http://docs.python.org/3/library/runpy.html

A mention on this page would also be good:

http://docs.python.org/3/tutorial/interpreter.html

Since the feature was added in Python 2.6, the documentation patch should also be backported to the Python 2.6 and 2.7.

PS: I wonder why the documentation search doesn't even return the page you mentioned.