-
-
Notifications
You must be signed in to change notification settings - Fork 33.9k
bpo-33649: Edit asyncio eventloop doc - second pass #9233
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
1st1
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good! I've left a few nit comments.
Doc/library/asyncio-eventloop.rst
Outdated
| loops and should use the :func:`asyncio.run` function to initialize | ||
| and run asynchronous code. | ||
| Application developers will typically use high-level asyncio functions | ||
| to interact with the event loop. In general,high-level asyncio applications |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Missing a space in general,high-level -> general, high-level
Doc/library/asyncio-eventloop.rst
Outdated
| Consider also using the :func:`asyncio.run` function instead of | ||
| manually creating and closing an event loop. | ||
| Consider also using the :func:`asyncio.run` function instead of using | ||
| lower level commands to manually create and close an event loop. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Would it make sense to change "commands" to "functions" or "APIs"?
Doc/library/asyncio-eventloop.rst
Outdated
| * *family* can be set to either :data:`socket.AF_INET` or | ||
| :data:`~socket.AF_INET6` to force the socket to use IPv4 or IPv6. | ||
| If not set it will be determined from host name | ||
| If not set, it will be determined from host name |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe "If not set, it will be determined" -> "If not set, the family will be determined"?
asvetlov
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nice work!
https://bugs.python.org/issue33649