summaryrefslogtreecommitdiffstats
path: root/Doc
Commit message (Collapse)AuthorAgeFilesLines
* [doc] Refresh the venv introduction documentation, and correct the statement ↵Phil Elson2022-10-192-95/+84
| | | | | about VIRTUAL_ENV (GH-98350) Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
* Docs: Bump sphinx-lint and fix unbalanced inline literal markup (#98441)Hugo van Kemenade2022-10-191-4/+1
| | | Bump sphinx-lint and fix unbalanced inline literal markup
* gh-95913: Edit zipfile Whatsnew section & add new APIs (#98314)C.A.M. Gerlach2022-10-191-2/+14
| | | | | | | | | * Link ZipFile in What's New entry discussing it * Add entry for new ZipFile.mkdir method * Add entry for new zipfile.Path.stem/suffix/suffixes methods * Add missing line breaks between zipfile bullet list items
* gh-95913: Add WhatsNew section for new logging APIs (#98320)C.A.M. Gerlach2022-10-191-0/+20
| | | | | | | * Add entry for new logging.getLevelNamesMapping function * Add entry for SysLogHandler.createSocket to whatsnew * Add missing line break between logging bullet list items
* Fix markup indentation (GH-98424)Raymond Hettinger2022-10-191-1/+1
| | | Fix markup
* gh-95914: Add links to 3.11 WhatsNew Summary items (#98416)C.A.M. Gerlach2022-10-181-26/+38
| | | Add links to Summary items to where readers can learn more
* General improvements to the itertools docs (GH-98408)Raymond Hettinger2022-10-181-51/+92
|
* gh-98393: os module reject bytes-like, only accept bytes (#98394)Victor Stinner2022-10-181-0/+10
| | | | | The os module and the PyUnicode_FSDecoder() function no longer accept bytes-like paths, like bytearray and memoryview types: only the exact bytes type is accepted for bytes strings.
* Doc: Found some remaining default roles. (GH-98392)Julien Palard2022-10-184-4/+4
|
* Doc: missing underscore in hyperlink. (GH-98391)Julien Palard2022-10-181-1/+1
|
* gh-95913: Copyedit, xref and organize enum section (#98295)C.A.M. Gerlach2022-10-181-38/+64
| | | | | | | | | | | * Whatsnew: Convert literals in enum section to actual x-references * Whatsnew: Rewrite enum section for clear and consistant phrasing * Whatsnew: Combine directly related enum items instead of seperating them * gh-98250: Describe __str__/__format__ changes more clearly/accurately * Tweak enum section language per feedback from Ethan
* gh-95913: Prepare remaining Whatsnew sections for editing (#98342)C.A.M. Gerlach2022-10-181-28/+105
| | | | | | | | | * Add line breaks & ref targets to Whatsnew to prepare for future changes * Use standard heading underbar symbols for H4 sections * Flatten Porting subsection; clarify scope of/link Python->CAPI sections * Move C API pending deprecations to C API section, to match the others
* GH-98363: Add itertools.batched() (GH-98364)Raymond Hettinger2022-10-171-37/+39
|
* Move random selection recipes from itertools.rst to random.rst (GH-98369)Raymond Hettinger2022-10-172-25/+31
|
* gh-95913: Move subinterpreter exper removal to 3.11 WhatsNew (GH-98345)C.A.M. Gerlach2022-10-172-4/+4
| | | | | | | | | | | | Part of #95913 Forward port of #93306, which was a backport of #93185, to address #84694 This adds the What's New entry for the removal of the subinterpreter-related env variable, build-time flag, etc. As @ericsnowcurrently was author of the original changes, I added him as a co-author to the commit. This addition to the Python 3.11 What's New document were only made to the Python 3.11 branch during the backport process, and not added to the version in `main`. Forward-porting it ensures the docs retain these additions for the future, rather than being lost in a legacy Python versions, allows it to be be edited as part of #95913 , and avoids merge conflicts with routine back-ports of PRs touching it. I've pulled in the addition exactly as-is with no modifications; any editing will be done in future PRs (and therefore can be reviewed and backported accordingly). The one other such addition is forward-ported in #98344
* gh-95914: Add What's New item describing PEP 670 changes (#98315)C.A.M. Gerlach2022-10-171-0/+11
|
* gh-97669: Create Tools/build/ directory (#97963)Victor Stinner2022-10-171-1/+1
| | | | | | | | | | | | | | | | | | | | | | | Create Tools/build/ directory. Move the following scripts from Tools/scripts/ to Tools/build/: * check_extension_modules.py * deepfreeze.py * freeze_modules.py * generate_global_objects.py * generate_levenshtein_examples.py * generate_opcode_h.py * generate_re_casefix.py * generate_sre_constants.py * generate_stdlib_module_names.py * generate_token.py * parse_html5_entities.py * smelly.py * stable_abi.py * umarshal.py * update_file.py * verify_ensurepip_wheels.py Update references to these scripts.
* gh-95913: Forward-port int/str security change to 3.11 What's New in main ↵C.A.M. Gerlach2022-10-171-0/+11
| | | | | | | (#98344) Add int/str security change from issue gh-95778 PRs gh-96499 / gh-95800 Co-authored-by: Gregory P. Smith <greg@krypto.org> [Google]
* GH-91415: Mention alphabetical sort ordering in the Sorting HOWTO (GH-98336)Raymond Hettinger2022-10-161-76/+22
|
* gh-85525: Remove extra row in doc (#98337)Joannah Nanjekye2022-10-161-1/+0
| | | | | | | * remove extra row * 📜🤖 Added by blurb_it. Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
* gh-85299: Add note warning about entry point guard for asyncio example (#93457)Stanley2022-10-162-1/+9
|
* gh-98307: Add docstring and documentation for SysLogHandler.createSocket ↵Vinay Sajip2022-10-161-0/+11
| | | | | (GH-98319) Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
* GH-94597: Deprecate child watcher getters and setters (#98215)Kumar Aditya2022-10-152-0/+20
| | | | | | | This is the next step for deprecating child watchers. Until we've removed the API completely we have to use it, so this PR is mostly suppressing a lot of warnings when using the API internally. Once the child watcher API is totally removed, the two child watcher implementations we actually use and need (Pidfd and Thread) will be turned into internal helpers.
* Improve speed. Reduce auxiliary memory to 16.6% of the main array. (GH-98294)Raymond Hettinger2022-10-151-4/+5
|
* [doc] Update logging cookbook with an example of custom handling of levels. ↵Vinay Sajip2022-10-151-4/+206
| | | | | (GH-98290) Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* docs(typing): harmonize "See PEP x for more details" (#97927)Simon Legner2022-10-151-10/+8
|
* Faster sieve() recipe (#98287)Raymond Hettinger2022-10-151-8/+27
|
* gh-98227: executionmodel.rst: except* can also bind names (#98256)BiscuitCandy2022-10-151-1/+1
| | | Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* gh-96258: move Py_REFCNT and Py_SET_REFCNT to reference counting page (#96259)QuakeIV2022-10-152-21/+22
|
* gh-85455: Add missing doc strings and improve docs (#21573)Joannah Nanjekye2022-10-151-2/+2
| | | | | | | * Add missing doc strings and improve docs * Use imperative form * Modify docstring wording
* gh-85525: Indicate supported sound header formats (#21575)Joannah Nanjekye2022-10-151-0/+49
| | | | | | | * Indicate supported sound header formats * modify file names Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* gh-91485: Doc: Using Python syntax to document builtin Python functions. ↵Julien Palard2022-10-151-65/+84
| | | | (GH-96579)
* Mark all targets in `Doc/Makefile` as `PHONY` (GH-98189)Nikita Sobolev2022-10-121-3/+3
|
* gh-96265: Formatting changes for faq/general (#98129)Stanley2022-10-121-12/+18
| | | | | | | | | | | | | | | | | | | | * Some formatting changes for general faq * Use list for Python versioning Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com> * New line for list, list for a/b/rc * Line wrap for 80 chars * More line wrap * Remove PythonWin mention. Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM> Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com> Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
* tutorial: remove "with single quotes" (#98204)Jelle Zijlstra2022-10-121-1/+1
| | | | | | Closes #91856. On Windows double quotes are sometimes better, on Unix usually single quotes. It's not our place to explain that, so just don't.
* gh-65046: Link to logging cookbook from asyncio docs (#98207)Shantanu2022-10-122-1/+4
|
* Formatting fixes in contextlib docs (#98111)Stanley2022-10-121-11/+17
|
* gh-95276: Add callable entry to the glossary (#95738)MonadChains2022-10-121-0/+10
|
* gh-96130: Rephrase use of "typecheck" verb for clarity (#98144)Shantanu2022-10-121-10/+10
| | | | I'm sympathetic to the issue report, especially in case this helps clarify to new users that Python itself does not do type checking at runtime
* gh-98172: Fix formatting in `except*` docs (#98173)Jelle Zijlstra2022-10-111-12/+11
|
* gh-86404: Doc: Drop now unused make suspicious and rstlint. (GH-98179)Julien Palard2022-10-118-1082/+7
| | | | They have been replaced by [sphinx-lint](https://github.com/sphinx-contrib/sphinx-lint).
* gh-71616: Add note to warn against general translation of saxutils.escape() ↵Stanley2022-10-111-0/+5
| | | | | | | (#93450) * Add note to warn against general translation of saxutils.escape() * Use more direct wording
* gh-88452: Add a warning about non-portability of environments. (GH-98155)Vinay Sajip2022-10-101-0/+13
|
* gh-83940: os docs: Improve wording for getenv/getenvb (#98113)Stanley2022-10-101-4/+4
|
* doc: remove a misleading statement. (GH-98093)Julien Palard2022-10-101-2/+2
|
* Fix types in buffer/memoryview docs (#98118)da-woods2022-10-102-2/+2
| | | | | | | | The definition of obj in the `Py_buffer` struct is as a PyObject* https://github.com/python/cpython/blob/ec091bd47e2f968b0d1631b9a8104283a7beeb1b/Include/pybuffer.h#L22 PyMemoryView_GET_BASE returns `.obj` - thus its return type should be a PyObject* (or at least a void*). It definitely doesn't return `Py_buffer`
* gh-56133: copyreg docs: Clarify function/constructor parameter (#95497)Stanley2022-10-101-9/+6
|
* Update whatsnew instructions for GitHub (#98124)Carl Meyer2022-10-091-2/+2
|
* Minor edits to the Descriptor HowTo Guide (GH-24901)Géry Ogam2022-10-091-6/+8
| | | Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
* GH-94597: deprecate `SafeChildWatcher`, `FastChildWatcher` and ↵Kumar Aditya2022-10-081-0/+18
| | | | `MultiLoopChildWatcher` child watchers (#98089)