dcc997cd28
[doc] Fix erroneous backslashes in signatures and names (GH-23658)
...
The issue being resolved is shown in the 3.10 docs (if you select docs for older versions you won't see a visual glitch).
The newer sphinx version that produces the 3.10 docs doesn't treat the backslash to escape things in some situations it previously did.
2020-12-16 17:37:28 -08:00
fc3dca3e16
Clarify eval() doc from library/functions. (GH-22700)
2020-12-16 16:45:19 +01:00
b76a840021
bpo-42180: fix plural in arguments and control (GH-23015)
...
https://bugs.python.org/issue42180
2020-10-29 20:48:21 +00:00
0f25c231b3
Add a link to buffer protocol in bytearray() doc (GH-22675)
2020-10-26 14:26:34 +09:00
3f7e990fd4
bpo-41192: Add documentation of undocumented audit events (GH-21308)
2020-10-20 15:23:15 -04:00
155938907c
bpo-40484: Document compiler flags under AST module (GH-19885)
...
Co-authored-by: Pablo Galindo <Pablogsal@gmail.com>
Co-authored-by: Shantanu <hauntsaninja@users.noreply.github.com>
2020-10-19 02:14:11 +01:00
e799aa8b92
bpo-41887: omit leading spaces/tabs on ast.literal_eval ( #22469 )
...
Also document that eval() does this (the same way).
2020-10-03 17:46:44 -07:00
c8bb24166e
[doc] Update references to NumPy (GH-22458)
...
Numeric(al) Python to NumPy. It seems the old name hasn't been used for some time.
2020-10-01 16:22:14 -07:00
8af239eacf
bpo-41762: Fix usage of productionlist markup in the doc (GH-22281)
...
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".
2020-09-18 09:10:15 +02:00
802726acf6
Document vars behavior when __dict__ is missing ( #21466 )
2020-08-21 19:29:34 -03:00
705f145565
Doc: Add a link to tutorial page from `open()` doc (GH-21737)
...
Adds a link to the "Reading and Writing Files" page so users can
more easily discover how file handles are handled with the `with`
context manager vs without it.
2020-08-08 11:57:03 +09:00
a908bc4dd8
Doc: Builtins functions: faster jump table (GH-21376)
2020-07-09 11:38:41 +02:00
77ed29b2c2
Fix typo in functions.rst (GH-21131)
2020-06-25 14:50:37 -07:00
59cf853332
bpo-40636: Documentation for zip-strict ( #20961 )
2020-06-19 13:39:22 -07:00
2831642212
Indicate that abs() method accept argument that implement __abs__(), just like call() method in the docs (GH-20509)
2020-05-29 07:35:34 -04:00
c691f20952
Fix "versionchanged" for pow named arguments (GH-19042)
...
The ability to use named arguments in "pow" was introduced in Python 3.8, not Python 3.9. See https://bugs.python.org/issue38237
2020-03-19 18:12:59 +00:00
fc72ab6913
bpo-38691: importlib ignores PYTHONCASEOK if -E is used (GH-18627)
...
The importlib module now ignores the PYTHONCASEOK
environment variable when the -E or -I command line
options are being used.
2020-03-09 12:57:53 +01:00
942f7a2dea
bpo-39674: Revert "bpo-37330: open() no longer accept 'U' in file mode (GH-16959)" (GH-18767)
...
This reverts commit e471e72977
2020-03-04 18:50:22 +01:00
4dee92b0ad
Revert "bpo-38691 Added a switch to ignore PYTHONCASEOK when -E or -I flags passed ( #18314 )" (GH-18553)
...
This reverts commit d83b6600b2
2020-02-19 14:23:47 +01:00
d83b6600b2
bpo-38691 Added a switch to ignore PYTHONCASEOK when -E or -I flags passed ( #18314 )
...
* Hard reset + cherry piciking the changes.
* 📜 🤖 Added by blurb_it.
* Added @vstinner News
* Update Misc/NEWS.d/next/Library/2020-02-11-13-01-38.bpo-38691.oND8Sk.rst
Co-Authored-By: Victor Stinner <vstinner@python.org>
* Hard reset to master
* Hard reset to master + latest changes
Co-authored-by: blurb-it[bot] <43283697+blurb-it[bot]@users.noreply.github.com>
Co-authored-by: Victor Stinner <vstinner@python.org>
2020-02-17 10:05:11 +01:00
d7c7adde00
bpo-12159: Document sys.maxsize limit in len() function reference (GH-17934)
2020-01-12 10:04:14 +01:00
ee9ff05ec2
bpo-34118: memoryview, range, and tuple are classes (GH-17761)
...
Tag memoryview, range, and tuple as classes, the same as list, etcetera, in
the library manual built-in functions list.
2019-12-30 17:16:43 -05:00
d67279147a
Update functions.rst (GH-16468)
...
This PR will make the following changes to the [_Built-in Functions_](https://docs.python.org/3/library/functions.html ) chapter of the library documentation:
- improve hyperlinks in Sphinx roles (trailing 's' belong to hyperlinks).
Automerge-Triggered-By: @csabella
2019-11-20 18:10:19 -08:00
138ccbb022
bpo-38738: Fix formatting of True and False. (GH-17083)
...
* "Return true/false" is replaced with "Return ``True``/``False``"
if the function actually returns a bool.
* Fixed formatting of some True and False literals (now in monospace).
* Replaced "True/False" with "true/false" if it can be not only bool.
* Replaced some 1/0 with True/False if it corresponds the code.
* "Returns <bool>" is replaced with "Return <bool>".
2019-11-12 16:57:03 +02:00
e471e72977
bpo-37330: open() no longer accept 'U' in file mode (GH-16959)
...
open(), io.open(), codecs.open() and fileinput.FileInput no longer
accept "U" ("universal newline") in the file mode. This flag was
deprecated since Python 3.3.
2019-10-28 15:40:08 +01:00
15ccc4fac0
bpo-38255: super() can search attributes as well as methods (GH-16368)
...
Improvement suggested by Géry Ogam.
2019-09-25 08:13:19 -07:00
87d6cd3604
bpo-38237: Make pow's arguments have more descriptive names and be keyword passable (GH-16302)
...
Edit: `math.pow` changes removed on Mark's request.
https://bugs.python.org/issue38237
Automerge-Triggered-By: @rhettinger
2019-09-20 21:28:49 -07:00
7a0023e8d1
bpo-25810: Clarify eval() docs, it does not keywords (GH-15173)
2019-09-11 05:30:04 -05:00
05184515f9
Correct minor grammatical mistake in open docs (GH-15865)
2019-09-10 15:48:05 +01:00
c1d8c1cb8e
Note regarding + mode truncation applies to both text and binary mode ( #11314 )
...
* Improve doc on open's mode +
* Improve wording
* Address comment from Rémi
2019-09-10 14:04:22 +01:00
cd81f0500f
bpo-23674: Clarify ambiguities in super() docs ( #15564 )
2019-08-29 00:44:02 -07:00
805f8f9afe
bpo-19072: Make @classmethod support chained decorators (GH-8405)
2019-08-24 15:37:25 -07:00
610a4823cc
bpo-37646: Document that eval() cannot access nested scopes (GH-15117)
2019-08-06 17:56:22 -07:00
44f91c388a
bpo-37390: Add audit event table to documentations (GH-14406)
...
Also updates some (unreleased) event names to be consistent with the others.
2019-06-27 10:47:59 -07:00
60419a7e96
bpo-37363: Add audit events for a range of modules (GH-14301)
2019-06-24 08:42:54 -07:00
c4c421d619
bpo-37134: Use PEP570 syntax for sum() (GH-13851)
2019-06-06 00:11:46 +01:00
c52996785a
bpo-36027: Extend three-argument pow to negative second argument (GH-13266)
2019-06-02 10:24:06 +01:00
bdbad71b9d
bpo-20092. Use __index__ in constructors of int, float and complex. (GH-13108)
2019-06-02 00:05:48 +03:00
059b9ea5ac
bpo-31968: Documentation -- add clarification on the globals dict for exec() (GH-13140)
2019-06-01 08:51:58 -07:00
b82e17e626
bpo-36842: Implement PEP 578 (GH-12613)
...
Adds sys.audit, sys.addaudithook, io.open_code, and associated C APIs.
2019-05-23 08:45:22 -07:00
565b4f1ac7
bpo-34616: Add PyCF_ALLOW_TOP_LEVEL_AWAIT to allow top-level await (GH-13148)
...
Co-Authored-By: Yury Selivanov <yury@magic.io>
2019-05-21 16:12:02 -04:00
1c5fa5af8a
bpo-32413: Add documentation that at the module level, locals(), globals() are the same dictionary (GH-5004)
...
https://bugs.python.org/issue32413
2019-04-02 10:58:50 -07:00
548cb6060a
bpo-34085: Improve wording on classmethod/staticmethod ( #8228 )
...
* bpo-34085: Improve wording on classmethod/staticmethod
* Address comments from Éric
* Address comments from Éric
2019-03-25 18:53:43 -04:00
1aeeaeb79e
bpo-21314: Add a FAQ entry about positional only parameters (GH-10641)
2019-03-10 21:30:11 +10:00
11fa0e48a9
Doc: fix example for iter() function. (GH-11959)
...
read() returns bytes for a file opened in binary mode,
so b'' should be used as a sentinel instead of ''.
Otherwise the loop will be infinite.
2019-02-21 09:53:06 +02:00
3171df3414
Clarify U-mode deprecation in open() (GH-11646)
...
The previous wording could be read as saying that universal
newlines mode itself was deprecated, when it's only the 'U'
character in the mode field that should be avoided.
The update also moves the description of the 'U' mode character
out of the mode table, as the longer explanation was overly
intrusive as a table entry and overshadowed the actually useful
mode characters.
2019-01-28 02:21:11 +10:00
d378b1f8ed
bpo-34764: improve docs example of iter() with sentinel value (GH-11222)
2018-12-23 21:07:17 -08:00
2b57c43f21
bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174)
2018-12-19 08:09:46 +02:00
6bdb6f7675
fix dangling keyfunc examples in documentation of heapq and sorted ( #1432 )
...
* fix dangling mention of key=str.lower in heapq doc
* Fix dangling mention of keyfunc example for sorted()
2018-10-15 13:06:53 -06:00
9dfa0fe587
bpo-34637: Make the *start* argument for *sum()* visible as a keyword argument. (GH-9208)
2018-09-12 10:54:06 -07:00
Andre Delfino
Antoine
Rafael Fontenelle
Saiyang Gou
Batuhan Taskaya
Victor Stinner
Benjamin Kane
Julien Palard
Ram Rachum
Windson yang
Mark Dickinson
idomic
Zac Hatfield-Dodds
Terry Jan Reedy
Géry Ogam
Serhiy Storchaka
Raymond Hettinger
Ammar Askar
smokephil
Berker Peksag
Steve Dower
Pablo Galindo
Anthony Shaw
Steve Dower
Matthias Bussonnier
Srinivas Reddy Thatiparthy (శ్రీనివాస్ రెడ్డి తాటిపర్తి)
Lysandros Nikolaou
Cristian Ciupitu
Nick Coghlan
Chris Rands
Wolfgang Maier