Fix “allows to <verb>” in documentation

[vadmium]

BPO	26304
Nosy	@ericvsmith, @bitdancer, @vadmium, @serhiy-storchaka
Files	allows-to.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 2016-02-10.06:37:30.410>
created_at = <Date 2016-02-08.07:55:32.238>
labels = ['docs']
title = 'Fix \xe2\x80\x9callows to <verb>\xe2\x80\x9d in documentation'
updated_at = <Date 2016-02-10.06:37:30.408>
user = 'https://github.com/vadmium'

bugs.python.org fields:

activity = <Date 2016-02-10.06:37:30.408>
actor = 'martin.panter'
assignee = 'docs@python'
closed = True
closed_date = <Date 2016-02-10.06:37:30.410>
closer = 'martin.panter'
components = ['Documentation']
creation = <Date 2016-02-08.07:55:32.238>
creator = 'martin.panter'
dependencies = []
files = ['41845']
hgrepos = []
issue_num = 26304
keywords = ['patch']
message_count = 6.0
messages = ['259827', '259829', '259857', '259980', '259982', '259983']
nosy_count = 6.0
nosy_names = ['eric.smith', 'r.david.murray', 'docs@python', 'python-dev', 'martin.panter', 'serhiy.storchaka']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue26304'
versions = ['Python 2.7', 'Python 3.5', 'Python 3.6']

[vadmium]

This patch changes instances of “. . . allows to <verb>” to “. . . allows <verb>ing” or similar. I understand the original form is not correct English grammar, although the equivalent is apparently valid in some other languages. As a native English speaker it feels awkward to me, although the meaning is clear. This question & answer <https://english.stackexchange.com/questions/60271/grammatical-complements-for-allow\> seem to back me up, but I thought I should get a quick review or second opinion before changing everything.

[serhiy-storchaka]

I have read the patch, and it LGTM. At least it does exactly what is declared (and fixes some other minor errors). Thank you Martin.

[ericvsmith]

I agree that the "to xxx" changes look good. And the handful of other corrections look good, too.

I left a review comment with one typo I found.

[python-dev]

New changeset 818e91105418 by Martin Panter in branch '3.5':
Issue bpo-26304: Change "allows to <verb>" to "allows <verb>ing" or similar
https://hg.python.org/cpython/rev/818e91105418

New changeset d01abc2d5197 by Martin Panter in branch 'default':
Issue bpo-26304: Merge doc wording from 3.5
https://hg.python.org/cpython/rev/d01abc2d5197

New changeset 37f6f965023d by Martin Panter in branch 'default':
Issue bpo-26304: Additional “allows to” fix specific to 3.6
https://hg.python.org/cpython/rev/37f6f965023d

[python-dev]

New changeset 4cfc19f667aa by Martin Panter in branch '2.7':
Issue bpo-26304: Change "allows to <verb>" to "allows <verb>ing" or similar
https://hg.python.org/cpython/rev/4cfc19f667aa

[vadmium]

Thanks for the reviews, and spotting my typo. I also sneaked in eight more changes (“allowing to”), to asyncio-eventloop.rst, ctypes.rst, whatsnew/3.3.rst, howto/pyporting.rst, Misc/NEWS, and Misc/HISTORY.