summaryrefslogtreecommitdiff
path: root/Misc/NEWS.d/next/Documentation
Commit message (Collapse)AuthorAgeFilesLines
* bpo-34552: Clarify built-in types comparisons (GH-9035)Windson yang2018-09-131-0/+2
| | | Some updates to ancient text about comparisons; fixes bp-34552.
* closes bpo-25041: Document AF_PACKET socket address format. (GH-4092)Cheryl Sabella2018-09-111-0/+1
|
* bpo-28617 Fixed docs inaccuracies about the types that support membership ↵wim glenn2018-09-111-0/+2
| | | | | | | | tests (GH-9086) <!-- issue-number: [bpo-28617](https://www.bugs.python.org/issue28617) --> https://bugs.python.org/issue28617 <!-- /issue-number -->
* bpo-33487: improve BZ2File Deprecation and documentation. (GH-6785)Matthias Bussonnier2018-09-101-0/+3
| | | | Emit warning when None passed explicitly, list Python version since deprecation in warning message and docs.
* bpo-33460: remove ellipsis that look like continuation prompts (GH-7851)Lew Kurtz2018-09-101-0/+1
| | | | | Remove ellipsis that look like continuation prompts, has a side benefit of putting rest of error message in proper text color.
* bpo-34065: Improve the markup of logging.basicConfig() arguments (GH-8153)Dong-hee Na2018-07-071-0/+1
|
* bpo-33847: Add '@' operator entry to index (GH-7669)Andrés Delfino2018-06-151-0/+1
|
* bpo-17045: Improve C-API doc for PyTypeObject. (gh-7413)Eric Snow2018-06-141-0/+3
| | | The existing doc had a number of info gaps and was a little hard to use. This patch provides several quick-reference tables as well as examples.
* bpo-31432: Clarify ssl CERT_NONE/OPTIONAL/REQUIRED docs. (GH-3530)Christian Heimes2018-06-111-0/+2
| | | | | | | | | The documentation for CERT_NONE, CERT_OPTIONAL, and CERT_REQUIRED were misleading and partly wrong. It fails to explain that OpenSSL behaves differently in client and server mode. Also OpenSSL does validate the cert chain everytime. With SSL_VERIFY_NONE a validation error is not fatal in client mode and does not request a client cert in server mode. Also discourage people from using CERT_OPTIONAL in client mode.
* bpo-33409: Clarify PEP 538/540 relationship (GH-7534)Nick Coghlan2018-06-091-0/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | While locale coercion and UTF-8 mode turned out to be complementary ideas rather than competing ones, it isn't immediately obvious why it's useful to have both, or how they interact at runtime. This updates both the Python 3.7 What's New doc and the PYTHONCOERCECLOCALE and PYTHONUTF8 documentation in an attempt to clarify that relationship: - in the respective What's New sections, add a closing paragraph explaining which problem each one solves, and pointing to the other PEP's section for the specific aspects it relies on the other PEP to solve - use "locale-aware mode" as a more descriptive term for the default non-UTF-8 mode - improve wording conistenccy between the PYTHONCOERCECLOCALE and PYTHONUTF8 docs when they cover the same thing (mostly related to legacy locale detection and setting the standard stream error handler) - improve the description of the locale coercion trigger conditions (including pointing out that setting LC_ALL turns off locale coercion) - port the full description of the UTF-8 mode behaviour changes from PEP 540 into the PYTHONUTF8 documentation - be explicit that PYTHONIOENCODING still overrides the settings for the standard streams - mention concrete examples of things that do and don't get their text encoding assumptions adjusted by the two text encoding assumption override techniques
* bpo-33197: Add versionadded tag to the documentation of ParameterKind (GH-7536)Dong-hee Na2018-06-081-0/+1
|
* bpo-33736: Improve the documentation of asyncio stream APIs (GH-7326)Elvis Pranskevichus2018-06-081-0/+2
|
* bpo-23859: Document that asyncio.wait() does not cancel its futures (#7217)Elvis Pranskevichus2018-05-291-0/+1
| | | | Unlike `asyncio.wait_for()`, `asyncio.wait()` does not cancel the passed futures when a timeout accurs.
* bpo-32436: Document PEP 567 changes to asyncio. (GH-7073)Yury Selivanov2018-05-231-0/+1
|
* bpo-33604: Remove Pending from hmac Deprecation warning. (GH-7062)Matthias Bussonnier2018-05-221-0/+1
| | | bpo-33604: Bump removal notice from 3.6 to 3.8 and change PendingDeprecationWarning to DeprecationWarning as we had intended to do earlier...
* bpo-33503: Fix the broken pypi link in the source and the documentation ↵Stéphane Wirtel2018-05-151-0/+1
| | | | (GH-6814)
* Add AsyncContextManager to typing module documentation. (GH-6822)Travis DePrato2018-05-141-0/+1
|
* bpo-20709: os.utime(path_to_directory): wrong documentation for Windows. ↵Stéphane Wirtel2018-05-011-0/+2
| | | | | | | | (GH-5469) Remove the paragraph where we explain that os.utime() does not support a directory as path under Windows. Patch by Jan-Philip Gehrcke Co-authored-by: Jan-Philip Gehrcke <jgehrcke@gmail.com>
* bpo-33378: Add Korean to the language switcher. (GH-6627)Dong-hee Na2018-04-281-0/+1
|
* Clarify that __path__ can't be just any value (GH-6554)Brett Cannon2018-04-201-0/+1
|
* bpo-33201: Modernize "Extension types" doc (GH-6337)Antoine Pitrou2018-04-071-0/+1
| | | | | | | | | * bpo-33201: Modernize "Extension types" doc * Split tutorial and other topics * Some small fixes * Address some review comments * Rename noddy* to custom* and shoddy to sublist * Fix markup
* bpo-8243: Doc patch for curses.window.addstr and curses.window.addch (GH-5179)Jay Crotts2018-04-061-0/+2
|
* bpo-33195: Doc: Deprecate Py_UNICODE in c-api/arg (GH-6329)INADA Naoki2018-04-041-0/+3
| | | | Py_UNICODE is deprecated since Python 3.3. But the deprecation is missed in the c-api/arg document.
* bpo-32337: Update documentats about dict order (GH-4973)hui shang2018-04-041-0/+1
|
* bpo-33126: Document PyBuffer_ToContiguous() (#6292)Antoine Pitrou2018-03-281-0/+1
|
* bpo-27212: Modify islice recipe to consume initial values preceding start ↵Cheryl Sabella2018-03-261-0/+2
| | | | (GH-6195)
* bpo-27428: Fix WindowsRegistryFinder documentation to list appropriate ABC ↵Himanshu Lakhara2018-03-231-0/+2
| | | | | | (GH-6061)
* bpo-18802: Add more details to ipaddress documentation (GH-6083)Cheryl Sabella2018-03-211-0/+1
| | | | Original patch by Jon Foster and Berker Peksag.
* bpo-28247: Document Windows executable creation in zipapp (GH-6158)Cheryl Sabella2018-03-201-0/+2
|
* bpo-30607: Use external python-doc-theme (GH-2017)Jon Wayne Parrott2018-03-011-0/+2
|
* bpo-28124: deprecate ssl.wrap_socket() (#5888)Christian Heimes2018-02-271-0/+3
| | | | | | | The ssl module function ssl.wrap_socket() has been de-emphasized and deprecated in favor of the more secure and efficient SSLContext.wrap_socket() method. Signed-off-by: Christian Heimes <christian@python.org>
* bpo-17232: Clarify docs for -O and -OO command line options (#5839)Cheryl Sabella2018-02-241-0/+1
| | | The 'optimization' is for space in the executable file, not for run time.
* bpo-31972: Improve docstrings for pathlib classes (#5310)chason2018-02-181-0/+1
|
* bpo-32436: Add docs for contextvars (#5685)Yury Selivanov2018-02-161-0/+1
|
* bpo-11015: Update test.support documentation (GH-5610)Cheryl Sabella2018-02-111-0/+1
|
* bpo-32800: Update link to w3c doc for xml default namespaces (GH-5609)sblondon2018-02-101-0/+1
| | | The new link is given in a red box on the old page.
* bpo-8722: Document __getattr__ behavior with AttributeError in property ↵Cheryl Sabella2018-02-051-0/+2
| | | | | | | (GH-4754) When `__getattr__` is implemented, attribute lookup will always fall back to that, even if the initial failure comes from `__getattribute__` or a descriptor's `__get__` method (including property methods).
* bpo-32614: Modify re examples to use a raw string to prevent warning (GH-5265)Cheryl Sabella2018-02-021-0/+3
| | | | Modify RE examples in documentation to use raw strings to prevent DeprecationWarning. Add text to REGEX HOWTO to highlight the deprecation. Approved by Serhiy Storchaka.
* bpo-32722: Remove useless example in the Classes tutorial (#5446)Stéphane Wirtel2018-02-011-0/+2
| | | | | In the tutorial about the Generator expression, there is an example with a dict comprehension and not with a generator expression, just removed the code.
* Update NEWS, docs, and patchlevel for 3.7.0b1Ned Deily2018-01-313-6/+0
|
* bpo-32724: Fix references to commands in Doc/pdb.rst (GH-5444)Stéphane Wirtel2018-01-301-0/+2
| | | | | Some commands are specified in the documentation, but there is no direct references.
* bpo-32649: Add C API docs for per-opcode tracing & profiling (GH-5360)Xiang Zhang2018-01-281-0/+2
| | | | Updating the C API docs was missed when the per-opcode tracing & profiling support was initially added.
* bpo-17799: Explain real behaviour of sys.settrace and sys.setprofile (#4056)Pablo Galindo2018-01-241-0/+2
|
* Update docs for 3.7.0a4Ned Deily2018-01-081-1/+0
|
* bpo-32418: Add get_loop() method on Server, AbstractServer classes (#4997)Srinivas Reddy Thatiparthy (శ్రీనివాస్ రెడ్డి తాటిపర్తి)2017-12-301-0/+1
| | | | | | * Add abstract get_loop() method to Server, AbstractServer classes. * Add test cases for get_loop() method in Server, AbstractServer classes * Add documentation for get_loop() method
* Update NEWS and pydoc topics.Ned Deily2017-12-051-1/+0
|
* bpo-32105: add asyncio.BaseEventLoop.connect_accepted_socket versionadded to ↵AraHaan2017-11-211-0/+1
| | | | documentation. (#4491)
* Update NEWS and topics for 3.7.0a2Ned Deily2017-10-162-4/+0
|
* bpo-31537: Update readline documentation example. (GH-3925)Brad Smith2017-10-101-0/+2
| | | Change the code example from using `get_history_length` to `get_current_history_length`.
* bpo-30085: Improve documentation for operator (#1171)Sanket Dasgupta2017-09-241-0/+2
| | | | | The dunderless functions are preferred; dunder are retained for back compatilibity. Patch by Sanket Dasgupta.