summaryrefslogtreecommitdiffstats
path: root/Doc/reference
Commit message (Collapse)AuthorAgeFilesLines
* bpo-41762: Fix usage of productionlist markup in the doc (GH-22281) (GH-22300)Miss Islington (bot)2020-09-186-66/+67
| | | | | | | | | | Use an unique identifier for the different grammars documented using the Sphinx productionlist markup. productionlist markups of the same grammar, like "expressions" or "compound statements", use the same identifier "python-grammar". (cherry picked from commit 8af239eacfcf52e4e0e2b0223e7cea4672309483) Co-authored-by: Victor Stinner <vstinner@python.org>
* [doc] Remove superfluous comment about equal in f-strings (GH-22006)Miss Islington (bot)2020-09-101-1/+1
| | | | | | Automerge-Triggered-By: @kushaldas (cherry picked from commit 788b79fa7b6184221e68d4f1a3fbe0b3270693f6) Co-authored-by: Andre Delfino <adelfino@gmail.com>
* [3.8] [3.9] bpo-41688: Document bug in **= dispatching in the language ↵Miss Islington (bot)2020-09-091-0/+7
| | | | | | | | | | data… (GH-22172) (GH-22175) (cherry picked from commit 46bc21e1780016aaacd34e472f838dc792fb674c) Co-authored-by: Ammar Askar <ammar@ammaraskar.com> Automerge-Triggered-By: @brettcannon
* bpo-40204: Allow pre-Sphinx 3 syntax in the doc (GH-21844) (GH-21901) (GH-21928)Victor Stinner2020-08-202-3/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * bpo-40204: Allow pre-Sphinx 3 syntax in the doc (GH-21844) Enable Sphinx 3.2 "c_allow_pre_v3" option and disable the c_warn_on_allowed_pre_v3 option to make the documentation compatible with Sphinx 2 and Sphinx 3. (cherry picked from commit 423e77d6de497931585d1883805a9e3fa4096b0b) * bpo-40204: Fix Sphinx sytanx in howto/instrumentation.rst (GH-21858) Use generic '.. object::' to declare markers, rather than abusing '.. c:function::' which fails on Sphinx 3. (cherry picked from commit 43577c01a2ab49122db696e9eaec6cb31d11cc81) * bpo-40204: Fix duplicates in the documentation (GH-21857) Fix two Sphinx 3 issues: Doc/c-api/buffer.rst:304: WARNING: Duplicate C declaration, also defined in 'c-api/buffer'. Declaration is 'PyBUF_ND'. Doc/c-api/unicode.rst:1603: WARNING: Duplicate C declaration, also defined in 'c-api/unicode'. Declaration is 'PyObject* PyUnicode_Translate(PyObject *str, PyObject *table, const char *errors)'. (cherry picked from commit 46d10b1237c67ff8347f533eda6a5468d098f7eb) * bpo-40204: Add :noindex: in the documentation (GH-21859) Add :noindex: to duplicated documentation to fix "duplicate object description" errors. For example, fix this Sphinx 3 issue: Doc/library/configparser.rst:1146: WARNING: duplicate object description of configparser.ConfigParser.optionxform, other instance in library/configparser, use :noindex: for one of them (cherry picked from commit d3ded080482beae578faa704b13534a62d066f9f) * bpo-40204, doc: Fix syntax of C variables (GH-21846) For example, fix the following Sphinx 3 errors: Doc/c-api/buffer.rst:102: WARNING: Error in declarator or parameters Invalid C declaration: Expected identifier in nested name. [error at 5] void \*obj -----^ Doc/c-api/arg.rst:130: WARNING: Unparseable C cross-reference: 'PyObject*' Invalid C declaration: Expected end of definition. [error at 8] PyObject* --------^ The modified documentation is compatible with Sphinx 2 and Sphinx 3. (cherry picked from commit 474652fe9346382dbf793f20b671eb74668bebde) * bpo-40204: Fix reference to terms in the doc (GH-21865) Sphinx 3 requires to refer to terms with the exact case. For example, fix the Sphinx 3 warning: Doc/library/pkgutil.rst:71: WARNING: term Loader not found in case sensitive match.made a reference to loader instead. (cherry picked from commit bb0b08540cc93e56f3f1bde1b39ce086d9e35fe1) * bpo-40204: Fix duplicated productionlist names in the doc (GH-21900) Sphinx 3 disallows having more than one productionlist markup with the same name. Simply remove names in this case, since names are not shown anyway. For example, fix the Sphinx 3 warning: Doc/reference/introduction.rst:96: duplicate token description of *:name, other instance in reference/expressions (cherry picked from commit 1abeda80f760134b4233608e2c288790f955b95a) (cherry picked from commit 8f88190af529543c84d5dc78f19abbfd73335cf4)
* [3.8] bpo-41045: Document debug feature of f-strings ('=') (GH-21509) (#21647)Guido van Rossum2020-07-271-5/+32
| | | | | | | Co-Authored-By: Rishi <rishi93dev@gmail.com> (cherry picked from commit 13efaec) Co-authored-by: amaajemyfren <32741226+amaajemyfren@users.noreply.github.com>
* bpo-39868: Add documentation for Assignment Expressions (walrus, PEP 572) ↵Miss Islington (bot)2020-07-251-2/+19
| | | | | | | (GH-18851) (cherry picked from commit f117cef25b5ffc4db9fbe373ddb65e14f59f0397) Co-authored-by: Shankar Jha <shankarj67@gmail.com>
* bpo-40439: Update broken link in lexical analysis docs (GH-20184)Miss Islington (bot)2020-05-231-1/+1
| | | | | | Automerge-Triggered-By: @csabella (cherry picked from commit af23f0d3cf19343512e6ca1fe1d46a5dbe425719) Co-authored-by: Matteo Bertucci <matteobertucci2004@gmail.com>
* Fix misinformation about NaN != NaN comparison (GH-19357) (GH-19383)Miss Islington (bot)2020-04-051-2/+3
| | | | | | (cherry picked from commit 810f68f1282c917fc1ad6af540a9f08524dfe310) Co-authored-by: Mark Dickinson <mdickinson@enthought.com>
* fix comma location in various places (GH-19233)Miss Islington (bot)2020-03-302-2/+2
| | | | | (cherry picked from commit c49016e67c3255b37599b354a8d7995d40663991) Co-authored-by: Mathieu Dupuy <deronnax@users.noreply.github.com>
* bpo-40045: Make "dunder" method documentation easier to locate (GH-19153) ↵Miss Islington (bot)2020-03-271-5/+5
| | | | | | | | | | | | | | | | (GH-19198) * issue 40045 * Update lexical_analysis.rst Make "dunder" method documentation easier(GH-19153) Co-authored-by: Joannah Nanjekye <33177550+nanjekyejoannah@users.noreply.github.com> (cherry picked from commit 5f9c131c099d6675d1a9d0228497865488afd548) Co-authored-by: Javad Mokhtari <javadmokhtari@outlook.com> Co-authored-by: Javad Mokhtari <javadmokhtari@outlook.com>
* bpo-39879: Update datamodel docs to include dict ordering (GH-19006)Miss Islington (bot)2020-03-261-0/+10
| | | | | | Co-authored-by: furkanonder <furkantahaonder@gmail.com> (cherry picked from commit 59c644eaa72b0cc48302f59d66852c4ea8332eba) Co-authored-by: Lahfa Samy <lahfa121999@gmail.com>
* bpo-17422: slightly more precise language (GH-18682)Miss Islington (bot)2020-03-061-1/+1
| | | | | (cherry picked from commit e59334ebc9308b0f3ad048ef293c6b49e6456d1a) Co-authored-by: Caleb Donovick <cdonovick@users.noreply.github.com>
* bpo-39868: Update Language Reference for PEP 572. (GH-18793)Miss Islington (bot)2020-03-062-6/+18
| | | | | (cherry picked from commit 8bae21962bab2fac7630982abd73676b89930902) Co-authored-by: Brandt Bucher <brandtbucher@gmail.com>
* bpo-17422: Language reference should specify restrictions on class namespace ↵Miss Islington (bot)2020-02-221-2/+4
| | | | | | | | (GH-18559) The language reference now specifies restrictions on class namespaces. Adapted from a patch by Ethan Furman. (cherry picked from commit fbe2e0bb8a7ee75d0f9d57682436dac7d69e202e) Co-authored-by: ananthan-123 <ananthakrishnan15.2001@gmail.com>
* bpo-39545: Document changes in the support of await in f-strings. (GH-18456)Miss Islington (bot)2020-02-141-0/+5
| | | | | | https://bugs.python.org/issue39545 (cherry picked from commit f632736023502816f2e6bd714d1b48c81aa2ccc1) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* Improve grammar in the import system reference documentation (GH-18209)Miss Islington (bot)2020-02-101-1/+1
| | | | | | | | Replaced the period with a comma. Automerge-Triggered-By: @Mariatta (cherry picked from commit d47d0c8e9f2ca0f9f5d1bf0b35006a9a4d5ca684) Co-authored-by: Bonifacio de Oliveira <bonifacio.segundo@gmail.com>
* bpo-15243: Document __prepare__ as classmethod (GH-17124)Miss Islington (bot)2020-01-251-1/+2
| | | | | | (cherry picked from commit 7de617455ed788e6730c40cf854c4b72b0432194) Co-authored-by: alclarks <57201106+alclarks@users.noreply.github.com>
* Fix the parameter list of object. _rpow_ (GH-GH-16477)Miss Islington (bot)2020-01-051-1/+1
| | | | | (cherry picked from commit abc0c4fa9970931849b3da598c5980a5b170661e) Co-authored-by: HongWeipeng <961365124@qq.com>
* bpo-39037: Fix lookup order of magic methods in with statement documentation ↵Miss Islington (bot)2019-12-301-18/+49
| | | | | | | | | | | | | (GH-17608) * __enter__ is now looked up before __exit__ to give a more intuitive error message * add pseudo-code equivalent for the with statement * fix pseudo-code for the async with statement to use a finally clause * use SUITE rather than BLOCK for consistency with the language grammar Patch by Géry Ogam. (cherry picked from commit 226e6e7d4326cf91ef37e13528eb1f62de1bb832) Co-authored-by: Géry Ogam <gery.ogam@gmail.com>
* [3.8] bpo-38316: Fix co_stacksize documentation (GH-16983) (GH-17661)Batuhan Taşkaya2019-12-191-2/+2
| | | | | | | | | | | | | | | (cherry picked from commit d587272fe3b0fcad2f23a490e76f9f82ca7d64ef) Co-authored-by: Batuhan Taşkaya <47358913+isidentical@users.noreply.github.com> https://bugs.python.org/issue38316 Automerge-Triggered-By: @vstinner
* bpo-38524: clarify example a bit and improve formatting (GH-17406)Miss Islington (bot)2019-11-281-5/+8
| | | | | (cherry picked from commit 02519f75d15b063914a11351da30178ca4ceb54b) Co-authored-by: Tal Einat <taleinat+github@gmail.com>
* bpo-38524: document implicit and explicit calling of descriptors' ↵Miss Islington (bot)2019-11-271-1/+12
| | | | | | | __set_name__ (GH-17364) (cherry picked from commit 1bddf890e595a865414645c6041733043c4081f8) Co-authored-by: Florian Dahlitz <f2dahlitz@freenet.de>
* bpo-25866: Minor cleanups to "sequence" in docs (GH-17177) (GH-17208)Miss Islington (bot)2019-11-171-5/+9
| | | | | (cherry picked from commit 4544e78ec4558b75bf95e5b7dfc1b5bbb07ae5f0) Co-authored-by: alclarks <57201106+alclarks@users.noreply.github.com>
* Fix minor typos. (GH-17095)Miss Islington (bot)2019-11-131-3/+3
| | | | | (cherry picked from commit 2d56af7a94fe7ec0bdf3011652558ae1b889b4a8) Co-authored-by: Shu <23287722+susan-shu-c@users.noreply.github.com>
* bpo-38434: Fixes some audit event documentation (GH-16932)Miss Skeleton (bot)2019-10-261-0/+1
| | | | | (cherry picked from commit 894e30ce0bcc1c509eb01c8ffa9ba6d7701aeaaf) Co-authored-by: Steve Dower <steve.dower@python.org>
* bpo-35224: Additional documentation for Assignment Expressions (GH-15935) ↵Miss Islington (bot)2019-09-112-1/+3
| | | | | | | | | | | | | | | (GH-15967) Add or update assignment expression documentation for: - FAQ - Design - Reference - Expressions - Reference - Lexical Analysis https://bugs.python.org/issue35224 Automerge-Triggered-By: @matrixise (cherry picked from commit 6357c95716d89ac1f80587fbc4133df8d2e8396c) Co-authored-by: Emily Morehouse <emily@cuttlesoft.com>
* bpo-33459: Fix "tuple displays" term in Expressions.rst (GH-6760) (GH-15940)Miss Islington (bot)2019-09-111-4/+4
| | | | | | | | https://bugs.python.org/issue33459 Automerge-Triggered-By: @matrixise (cherry picked from commit dc269971091710563a0d730a0d4b084901826c15) Co-authored-by: Andre Delfino <adelfino@gmail.com>
* bpo-37913: document that __length_hint__ can return NotImplemented (GH-15383)Steve Dower2019-09-101-1/+3
|
* bpo-36743: __get__ is sometimes called without the owner argument (GH-12992) ↵Miss Islington (bot)2019-08-291-7/+18
| | | | | | | (GH-15589) (cherry picked from commit 0dac68f1e593c11612ed54af9edb865d398f3b05) Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
* bpo-15542: Documentation incorrectly suggests __init__ called after direct ↵Miss Islington (bot)2019-08-261-4/+4
| | | | | | | __new__ call (GH-15478) (GH-15506) (cherry picked from commit 6b16d938d6d1ccb443815e20e8812deed274dc09) Co-authored-by: Joannah Nanjekye <33177550+nanjekyejoannah@users.noreply.github.com>
* bpo-32118: Simplify docs for sequence comparison (GH-15450) (#15466)Miss Islington (bot)2019-08-241-19/+7
| | | | | (cherry picked from commit edd21129dd304e178ca8be82ba689488dfb58276) Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
* bpo-29535: Remove promize about hash randomization of datetime objects. ↵Miss Islington (bot)2019-08-241-2/+2
| | | | | | | (GH-15269) (cherry picked from commit e9c90aa43144b0be1e4e393e8cb549573437a5da) Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>
* [3.8] bpo-32912: Revert SyntaxWarning on invalid escape sequences (GH-15142)Serhiy Storchaka2019-08-091-5/+3
| | | | | | | * bpo-32912: Revert warnings for invalid escape sequences. DeprecationWarning will continue to be emitted for invalid escape sequences in string and bytes literals in 3.8 just as it did in 3.7. SyntaxWarning may be emitted in the future. But per mailing list discussion, we don't yet know when because we haven't settled on how to do so in a non-disruptive manner.
* bpo-35224: Reverse evaluation order of key: value in dict comprehensions ↵Miss Islington (bot)2019-06-221-0/+6
| | | | | | | | | | (GH-14139) … as proposed in PEP 572; key is now evaluated before value. https://bugs.python.org/issue35224 (cherry picked from commit c8a35417db8853a253517a3e5190e174075c6384) Co-authored-by: Jörn Heissler <joernheissler@users.noreply.github.com>
* More updates to the annotated assignments docs (GH-13794)Ivan Levkivskyi2019-06-041-4/+3
|
* Update the annotated assignment docs (GH-13757)Ivan Levkivskyi2019-06-021-1/+7
|
* bpo-20092. Use __index__ in constructors of int, float and complex. (GH-13108)Serhiy Storchaka2019-06-011-5/+3
|
* bpo-37122: Make co->co_argcount represent the total number of positonal ↵Pablo Galindo2019-06-011-17/+19
| | | | arguments in the code object (GH-13726)
* Use more PEP 570 syntax in the documentation. (GH-13720)Serhiy Storchaka2019-06-011-1/+1
|
* Update data model docs to include missing attributes for code objects (GH-13696)Pablo Galindo2019-05-311-12/+17
| | | Include and document co_posonlyargcount and co_kwonlyargcount
* bpo-30969: Fix docs about the comparison in absence of __contains__ (GH-2761)Antti Haapala2019-05-301-5/+6
|
* Regenerate topics file (GH-13642)Pablo Galindo2019-05-291-1/+1
|
* bpo-36540: Documentation for PEP570 - Python positional only arguments (#13202)Pablo Galindo2019-05-281-2/+4
| | | | | | | | | | | | | | | | | | * bpo-36540: Documentation for PEP570 - Python positional only arguments * fixup! bpo-36540: Documentation for PEP570 - Python positional only arguments * Update reference for compound statements * Apply suggestions from Carol Co-Authored-By: Carol Willing <carolcode@willingconsulting.com> * Update Doc/tutorial/controlflow.rst Co-Authored-By: Carol Willing <carolcode@willingconsulting.com> * Add extra bullet point and minor edits
* bpo-34682: Wording and grammatical changes to the ↵divyag92019-05-133-13/+13
| | | | | doc(https://docs.python.org/3) (GH-13120) https://bugs.python.org/issue34682
* Correct misspelling (GH-11470)Johnny Gérard2019-05-131-1/+1
|
* closes bpo-36861: Update Unicode database to 12.1.0. (GH-13214)Benjamin Peterson2019-05-091-1/+1
| | | Adds ㋿.
* bpo-36798: Updating f-string docs for := use case (GH-13107)Logan Jones2019-05-061-5/+6
|
* bpo-36166: Change to rst datamodel file. (GH-13089)Catherine Alvarado2019-05-041-2/+2
|
* Improve grammar on async context managers and shorten text (GH-12379)Andre Delfino2019-05-031-4/+4
|
* Don't use the LHS/RHS acronym in Simple statements (GH-12996)Andre Delfino2019-05-031-4/+4
| | | | | Prefer the full wording instead, as it is more meaningful for someone not familiar with the terms. Also, LFS/RHS is not used anywhere else in the documentation, while left/right-hand side mentions are common.
generated by cgit v0.12 at 2026-01-01 10:21:38 (GMT)