Add README file to the mime package

Add README file to the mime package

Also update CHANGELOG after last change.

R=kustermann@google.com, wibling@google.com
BUG=http://dartbug.com/22442

Committed: https://code.google.com/p/dart/source/detail?r=43841

[kustermann, 2015-02-18 12:40:23]

lgtm

[wibling, 2015-02-18 13:44:46]

https://codereview.chromium.org/936733004/diff/1/pkg/mime/CHANGELOG.md
File pkg/mime/CHANGELOG.md (right):

https://codereview.chromium.org/936733004/diff/1/pkg/mime/CHANGELOG.md#newcode3
pkg/mime/CHANGELOG.md:3: * Fixed erroneous behavior for listening and when
pause/resume stream of parts.
NIT: I would change it to pausing/resuming.

https://codereview.chromium.org/936733004/diff/1/pkg/mime/README.md
File pkg/mime/README.md (right):

https://codereview.chromium.org/936733004/diff/1/pkg/mime/README.md#newcode8
pkg/mime/README.md:8: The instances of the `MimeTypeResolver` class is used to
determine the
NIT: I would not stress that it is the instances of, but just say something
like:

The `MimeTypeResolver` class can be used to determine the MIME type of a file.

https://codereview.chromium.org/936733004/diff/1/pkg/mime/README.md#newcode9
pkg/mime/README.md:9: MIME type for file. It supports both using the extention
of the file
TYPO: extention -> extension.

https://codereview.chromium.org/936733004/diff/1/pkg/mime/README.md#newcode10
pkg/mime/README.md:10: name and possibly looking at magic bytes from the
begining of the
NIT: I would remove possibly. It is implicit in 'It supports both ...'

https://codereview.chromium.org/936733004/diff/1/pkg/mime/README.md#newcode14
pkg/mime/README.md:14: the top level function `lookupMimeType`. This builtin
instance have
NIT: have -> has

https://codereview.chromium.org/936733004/diff/1/pkg/mime/README.md#newcode21
pkg/mime/README.md:21: You can build you own resolver by instantiating
`MimeTypeResolver`
NIT: you -> your

NIT: by instantiating ... -> by instantiating the `MimeTypeResolver` class.

https://codereview.chromium.org/936733004/diff/1/pkg/mime/README.md#newcode31
pkg/mime/README.md:31: part is provided as a strream of bytes.
NIT: strream -> stream

https://codereview.chromium.org/936733004/diff/1/pkg/mime/README.md#newcode34
pkg/mime/README.md:34: the content of each part.
I would change the above to:

Below is an example showing how to process an HTTP request and print the length
of the content of each part.

https://codereview.chromium.org/936733004/diff/1/pkg/mime/README.md#newcode42
pkg/mime/README.md:42: request.transform(new MimeMultipartTransformer(boundary))
boundary -> _?

[Søren Gjesse, 2015-02-18 14:44:18]

Thanks for the review.

https://codereview.chromium.org/936733004/diff/1/pkg/mime/CHANGELOG.md
File pkg/mime/CHANGELOG.md (right):

https://codereview.chromium.org/936733004/diff/1/pkg/mime/CHANGELOG.md#newcode3
pkg/mime/CHANGELOG.md:3: * Fixed erroneous behavior for listening and when
pause/resume stream of parts.
On 2015/02/18 13:44:45, wibling wrote:
> NIT: I would change it to pausing/resuming.

Done.

https://codereview.chromium.org/936733004/diff/1/pkg/mime/README.md
File pkg/mime/README.md (right):

https://codereview.chromium.org/936733004/diff/1/pkg/mime/README.md#newcode8
pkg/mime/README.md:8: The instances of the `MimeTypeResolver` class is used to
determine the
On 2015/02/18 13:44:45, wibling wrote:
> NIT: I would not stress that it is the instances of, but just say something
> like:
> 
> The `MimeTypeResolver` class can be used to determine the MIME type of a file.
> 

Done.

https://codereview.chromium.org/936733004/diff/1/pkg/mime/README.md#newcode9
pkg/mime/README.md:9: MIME type for file. It supports both using the extention
of the file
On 2015/02/18 13:44:46, wibling wrote:
> TYPO: extention -> extension.

Done.

https://codereview.chromium.org/936733004/diff/1/pkg/mime/README.md#newcode10
pkg/mime/README.md:10: name and possibly looking at magic bytes from the
begining of the
On 2015/02/18 13:44:46, wibling wrote:
> NIT: I would remove possibly. It is implicit in 'It supports both ...'

Done.

https://codereview.chromium.org/936733004/diff/1/pkg/mime/README.md#newcode14
pkg/mime/README.md:14: the top level function `lookupMimeType`. This builtin
instance have
On 2015/02/18 13:44:45, wibling wrote:
> NIT: have -> has

Done.

https://codereview.chromium.org/936733004/diff/1/pkg/mime/README.md#newcode21
pkg/mime/README.md:21: You can build you own resolver by instantiating
`MimeTypeResolver`
On 2015/02/18 13:44:46, wibling wrote:
> NIT: you -> your
> 
> NIT: by instantiating ... -> by instantiating the `MimeTypeResolver` class.

Changed to 'by creating an instance of'

https://codereview.chromium.org/936733004/diff/1/pkg/mime/README.md#newcode31
pkg/mime/README.md:31: part is provided as a strream of bytes.
On 2015/02/18 13:44:45, wibling wrote:
> NIT: strream -> stream

Done.

https://codereview.chromium.org/936733004/diff/1/pkg/mime/README.md#newcode34
pkg/mime/README.md:34: the content of each part.
On 2015/02/18 13:44:46, wibling wrote:
> I would change the above to:
> 
> Below is an example showing how to process an HTTP request and print the
length
> of the content of each part.

Done.

https://codereview.chromium.org/936733004/diff/1/pkg/mime/README.md#newcode42
pkg/mime/README.md:42: request.transform(new MimeMultipartTransformer(boundary))
On 2015/02/18 13:44:46, wibling wrote:
> boundary -> _?

The boundary value is from the variable above.

[Søren Gjesse, 2015-02-18 14:45:12]

New patchsets have been uploaded after l-g-t-m from kustermann@google.com

[Søren Gjesse, 2015-02-18 14:45:37]

Committed patchset #2 (id:20001) manually as 43841 (presubmit successful).