homepage

All the module name in the first line of email subpackages' documentation files(Doc/library/email.xxx.rst) are incorrect: all of them are "email" but not "email.xxx"
Besides, the Doc/library/email-examples.rst is not a module and it uses ":mod:`email`: xxx"

And this causes the toctree in email doc(http://docs.python.org/dev/library/email.html) in correct. All of the tree elements' names are displayed as "email".

See also http://sphinx.pocoo.org/domains.html#directive-py:currentmodule 

> Besides, the Doc/library/email-examples.rst is not a module and it
> uses ":mod:`email`: xxx"
Not a problem. ":mod:" is not ".. module::". See above link.

Oh, sorry, I didn't differ :mod:, :module:, :currentmodule: clearly.
But shouldn't the modules link titles in http://docs.python.org/dev/library/email.html display correct module names instead just the "email" package name?
"""email: Representing character sets""" seems a little wearied.

Sure, +1 on using the submodule name in the module or currentmodule directive.

New changeset 64e82c4f4e10 by R David Murray in branch 'default':
#11785: fix the :mod: references in email package submodule titles.
http://hg.python.org/cpython/rev/64e82c4f4e10 

New changeset df59aefdb1c8 by R David Murray in branch '2.7':
#11785: fix the :mod: references in email package submodule titles.
http://hg.python.org/cpython/rev/df59aefdb1c8
New changeset 6737c2ca98ee by R David Murray in branch '3.2':
#11785: fix the :mod: references in email package submodule titles.
http://hg.python.org/cpython/rev/6737c2ca98ee 

Fixed.