Update mimetypes documentation

[sandrotosi]

BPO	12798
Nosy	@orsenthil, @ezio-melotti, @merwok, @sandrotosi
Files	mimetypes_doc_update.patch mimetypes_doc_update-v2.patch

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2011-12-23.03:21:53.673>
created_at = <Date 2011-08-20.21:49:06.219>
labels = ['docs']
title = 'Update mimetypes documentation'
updated_at = <Date 2011-12-23.03:21:53.651>
user = 'https://github.com/sandrotosi'

bugs.python.org fields:

activity = <Date 2011-12-23.03:21:53.651>
actor = 'orsenthil'
assignee = 'docs@python'
closed = True
closed_date = <Date 2011-12-23.03:21:53.673>
closer = 'orsenthil'
components = ['Documentation']
creation = <Date 2011-08-20.21:49:06.219>
creator = 'sandro.tosi'
dependencies = []
files = ['22968', '23021']
hgrepos = []
issue_num = 12798
keywords = ['patch']
message_count = 7.0
messages = ['142572', '142617', '142866', '150129', '150130', '150131', '150133']
nosy_count = 6.0
nosy_names = ['orsenthil', 'ezio.melotti', 'eric.araujo', 'sandro.tosi', 'docs@python', 'python-dev']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = 'patch review'
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue12798'
versions = ['Python 2.7', 'Python 3.2', 'Python 3.3']

[sandrotosi]

Following http://mail.python.org/pipermail/docs/2011-June/004727.html I've updated the mimetypes module doc.

Some changes I would like to do (but I didn't, since I'd like to hear comments):

• move the example of the module before the definition of MimeTypes class (so right below mimetypes.common_types)
• move all the text about MimeTypes class in the subsection that talks about it.

Comments, as always, are welcome.

[merwok]

Some changes I would like to do
+1 on those.

[sandrotosi]

Here attached a new patch incorporating Ezio & Eric suggestions.

[python-dev]

New changeset aef79ff1bc9b by Senthil Kumaran in branch '3.2':
bpo-12798 - Update mimetypes documentation. Correct the doc section where
http://hg.python.org/cpython/rev/aef79ff1bc9b

New changeset 4b306aee21a4 by Senthil Kumaran in branch 'default':
Merge changes from 3.2
http://hg.python.org/cpython/rev/4b306aee21a4

[python-dev]

New changeset cfa3fe9d7b1f by Senthil Kumaran in branch '2.7':
porting mimetype doc changes from 3.2.
http://hg.python.org/cpython/rev/cfa3fe9d7b1f

[python-dev]

New changeset 9c19df6c8ea0 by Senthil Kumaran in branch '3.2':
News entry for bpo-12798
http://hg.python.org/cpython/rev/9c19df6c8ea0

[orsenthil]

Updated the doc with Sandro Tosi's suggested changes in all the codelines.