[New-bugs-announce] [issue5357] Last paragraph of urllib.request.urlopen documentation is garbled

[Mitchell Model]

New submission from Mitchell Model <mlm at acm.org>:

The last two sentences of the last paragraph of the documentation of 
urllib.request.urlopen are shown below. I have broken up the text to 
comment on places where it appears to be garbled. It might be easier to 
just rewrite the two sentences rather than trying to make the 
corrections I'm suggesting.

The urlopen function from the previous version,

        "the previous version" --> "previous versions"

Python 2.6 and earlier, of the module urllib has been discontinued as 
urlopen can return the file-object as the previous.

         either one or more words are missing from the end of the 
sentence or the last part of the sentence starting with "as" needs 
repair

The proxy handling, 

        "handling" --> "handler"?

which in earlier 

        "earlier" --> "earlier versions"?

was passed as a dict parameter to urlopen can be availed 

        need comma after "urlopen"

        "availed" --> "obtained"
        or better, perhaps: "can be obtained by using ProxyHandler 
objects" instead of "by the use of...."

by the use of ProxyHandler objects.

----------
assignee: georg.brandl
components: Documentation
messages: 82652
nosy: MLModel, georg.brandl
severity: normal
status: open
title: Last paragraph of urllib.request.urlopen documentation is garbled
versions: Python 3.0, Python 3.1

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue5357>
_______________________________________