3378b2062c
Fix typos in multiple `.rst` files ( #1668 )
2017-05-19 23:37:57 +03:00
af34e0a07b
Fix ModuleNotFoundError typo in import reference ( #1606 )
2017-05-16 19:40:17 +03:00
12b1c18098
bpo-30354: Update data model documentation for super() (GH-1561)
...
The data model section of the language reference was written well
before the zero-argument form of super() was added.
To avoid giving the impression that they're doing something
unusual, this updates the description of `__new__` and `__init__`
to use the zero-argument form.
Patch by Cheryl Sabella.
2017-05-15 13:42:00 +10:00
7e19dbc92e
bpo-28974: `object.__format__(x, '')` is now equivalent to `str(x)` ( #506 )
...
rather than `format(str(self), '')`.
2017-05-13 12:40:52 +03:00
f34c685020
Fix a trivial typo in global section ( #1497 )
2017-05-08 04:36:29 -07:00
8856940cf2
bpo-28315: Improve code examples in docs (GH-1372)
...
Replace
File "<stdin>", line 1, in ?
with
File "<stdin>", line 1, in <module>
2017-05-03 09:46:45 -07:00
2e624690bd
bpo-29679: Implement @contextlib.asynccontextmanager ( #360 )
2017-04-30 18:25:58 -07:00
c6db4811f9
bpo-30052: Link `bytes` & `bytearray` to stdtypes not functions (GH-1271)
...
Builtin container types have two potential link targets in the docs:
- their entry in the list of builtin callables
- their type documentation
This change brings `bytes` and `bytearray` into line with other
container types by having cross-references default to linking to
their type documentation, rather than their builtin callable entry.
2017-04-26 15:47:01 +10:00
2e576f5aec
bpo-30144: Import collections ABC from collections.abc rather than collections. ( #1263 )
2017-04-24 09:05:00 +03:00
85157cd89a
bpo-15718: Document the upper bound constrain on the __len__ return value. ( #1256 )
2017-04-23 08:37:58 +03:00
997a4adea6
Remove outdated note about constraining of the bit shift right operand. ( #1258 )
...
The constrain was removed in bpo-29816.
2017-04-22 21:50:09 +03:00
cdcac039fb
bpo-29952: Use usual terminology of dict (GH-917)
...
s/keys and elements/keys and values/
2017-03-31 14:48:49 +09:00
0ae7c8bd61
bpo-16011 clarify that 'in' always returns a boolean value
2017-03-28 10:13:01 -04:00
fad7f15606
Remove an outdated statement in execution model docs (GH-754)
2017-03-22 17:54:53 -07:00
d4e89287b3
bpo-28739: Document that f-strings cannot be used as docstring (GH-592)
2017-03-10 08:58:40 -08:00
1f5639c77f
bpo-26184: import.rst: Improve versionchanged note (GH-325)
2017-02-26 13:23:38 -08:00
6b4a5f45e2
bpo-26184: import.rst: Improve versionchanged note (GH-277)
...
Mention that an ImportError is raised when exec_module() is defined, but
create_module() is not.
2017-02-26 07:36:57 -08:00
46ce7599af
bpo-29648: import.rst: Add reference to create_module() (GH-290)
...
Add a reference to create_module(), in the first versionadded of section Loaders.
2017-02-26 07:14:45 -08:00
132ac381fe
Fix small typos in expressions.rst (GH-276)
2017-02-24 12:32:54 -08:00
2be9889405
Issues #12067 : Merge hash recommendation from 3.5
2017-01-29 10:07:26 +00:00
8dbb0ca573
Issue #12067 : Recommend that hash and equality be consistent
2017-01-29 10:00:23 +00:00
406c252970
Issue #29012 : Merge from 3.5
2017-01-03 03:35:49 +03:00
7b4e551091
Issue #29012 : Remove another outdated information
...
Patch by Jim Fasarakis-Hilliard.
2017-01-03 03:34:15 +03:00
a22457ecaf
Issue #29012 : Merge from 3.5
2017-01-02 06:01:07 +03:00
14adafd6ee
Issue #29012 : Remove outdated information about __bases__
...
Patch by Jim Fasarakis-Hilliard.
2017-01-02 06:00:35 +03:00
7e930d7677
Issue #28954 : Merge keyword argument syntax from 3.5
2016-12-24 10:21:30 +00:00
7106a51c71
Issue #28954 : Add missing comma to keyword argument syntax
2016-12-24 10:20:38 +00:00
01e4c1175f
Merge 3.5
2016-12-19 13:09:55 +01:00
509476b370
doc: Suggest to hash(tuple of attr) rather than XOR
...
Issue #28383 : __hash__ documentation recommends naive XOR to combine but this
is suboptimal. Update the doc to suggest to reuse the hash() method using a
tuple, with an example.
2016-12-19 13:09:28 +01:00
03660041d2
Issue #28091 : Document PEP 525 & PEP 530.
...
Patch by Eric Appelt.
2016-12-15 17:36:05 -05:00
19d246745d
Issue #23722 : improve __classcell__ compatibility
...
Handling zero-argument super() in __init_subclass__ and
__set_name__ involved moving __class__ initialisation to
type.__new__. This requires cooperation from custom
metaclasses to ensure that the new __classcell__ entry
is passed along appropriately.
The initial implementation of that change resulted in abruptly
broken zero-argument super() support in metaclasses that didn't
adhere to the new requirements (such as Django's metaclass for
Model definitions).
The updated approach adopted here instead emits a deprecation
warning for those cases, and makes them work the same way they
did in Python 3.5.
This patch also improves the related class machinery documentation
to cover these details and to include more reader-friendly
cross-references and index entries.
2016-12-05 16:47:55 +10:00
28540183c9
Another en → em dash fix for 3.6
2016-11-21 04:10:45 +00:00
f66f03bd35
Update docs to reflect new behavior around backslashes in expressions (not allowed), matching recent changes to PEP 498.
2016-11-06 11:27:17 -05:00
989db5c880
Issue #19795 : Mark up None as literal text.
2016-10-19 16:37:13 +03:00
ecf41da83e
Issue #19795 : Mark up None as literal text.
2016-10-19 16:29:26 +03:00
0b51fd4341
merge
2016-09-11 17:24:05 -07:00
06e18a7c24
Issue #26511 : Reference the id() function in the 'is' and 'is not' docs
2016-09-11 17:23:49 -07:00
015d874626
Issue #28076 : Variable annotations should be mangled for private names.
...
By Ivan Levkivskyi.
2016-09-11 09:45:24 -07:00
a721abac29
Issue #26331 : Implement the parsing part of PEP 515.
...
Thanks to Georg Brandl for the patch.
2016-09-09 14:57:09 -07:00
68f4dd8b01
Doc updates for PEPs 520 and 468.
2016-09-09 11:22:14 -07:00
6cff8744a0
Issue #27999 : Make "global after use" a SyntaxError, and ditto for nonlocal.
...
Patch by Ivan Levkivskyi.
2016-09-09 09:36:26 -07:00
f8cb8a16a3
Issue #27985 : Implement PEP 526 -- Syntax for Variable Annotations.
...
Patch by Ivan Levkivskyi.
2016-09-08 20:50:03 -07:00
4f29e75289
Issue #24254 : Drop cls.__definition_order__.
2016-09-08 15:11:11 -07:00
b957b0c2bc
Issue #28030 : Update the language reference for PEP 468.
2016-09-08 13:59:58 -07:00
110b6fecbb
#27364 : Deprecate invalid escape strings in str/byutes.
...
Patch by Emanuel Barry, reviewed by Serhiy Storchaka and Martin Panter.
2016-09-08 15:34:08 -04:00
46f97b85a8
Issue #15767 : Use ModuleNotFoundError.
2016-09-07 16:56:15 -07:00
92a6c170e6
Issue #24254 : Preserve class attribute definition order.
2016-09-05 14:50:11 -07:00
f74c33ad5c
Merge
2016-08-25 21:12:16 -07:00
7ea386e56e
Issue 19504: Change "customise" to "customize" American spelling.
2016-08-25 21:11:50 -07:00
97c1adf393
Anti-registration of various ABC methods.
...
- Issue #25958 : Support "anti-registration" of special methods from
various ABCs, like __hash__, __iter__ or __len__. All these (and
several more) can be set to None in an implementation class and the
behavior will be as if the method is not defined at all.
(Previously, this mechanism existed only for __hash__, to make
mutable classes unhashable.) Code contributed by Andrew Barnert and
Ivan Levkivskyi.
2016-08-18 09:22:23 -07:00
3f63483a30
Merge for issue #27712
2016-08-12 10:57:17 -07:00
6336fb2734
Issue #27712 : Fix some typos in the import docs.
...
Thanks to Xiang Zhang for the patch.
2016-08-12 10:56:48 -07:00
91494d3b73
Issue #26576 : Merge from 3.5
2016-08-03 10:17:51 +03:00
6cafececbf
Issue #26576 : Clarify that the @deco syntax is not always an equivalent of f = deco(f)
...
Patch by Chris Angelico.
2016-08-03 10:17:21 +03:00
607e1c4c44
Issue 27366: PEP 487 docs updates
...
- Porting note for type keyword arg handling
- __init_subclass__ note regarding metaclass hint
2016-07-31 12:42:49 +10:00
01d1719062
Issue #27366 : Tweak PEP 487 documentation
...
* Added versionadded directives
* Deleted duplicate sentence from __init_subclass__ docstring
* Modernized tests
2016-07-30 14:06:15 +03:00
d78448e912
Issue #27366 : Implement PEP 487
...
- __init_subclass__ called when new subclasses defined
- __set_name__ called when descriptors are part of a
class definition
2016-07-30 16:26:03 +10:00
6a09315ff0
Issue #26462 : Merge code block fixes from 3.5
2016-07-29 01:49:37 +00:00
1050d2d0c7
Issue #26462 : Doc: reduce literal_block warnings, fix syntax highlighting.
...
Patch by Julien Palard.
2016-07-26 11:18:21 +02:00
2fec611a70
Issue #24314 : Merge doc links from 3.5
2016-06-18 08:20:22 +00:00
bae5d81f5d
Issue #24314 : Fix doc links for general attributes like __name__, __dict__
2016-06-18 03:57:31 +00:00
ed74e243c6
Issue #24136 : Adjust f-strings doc for interable unpacking
2016-06-12 01:56:24 +00:00
99cb0cda15
Issue #24136 : Merge unpacking doc from 3.5
2016-06-12 01:55:03 +00:00
0c0da48aed
Issue #24136 : Document generalized unpacking, PEP 448
...
Based on patches by Konstantin Molchanov and Neil Girdhar.
2016-06-12 01:46:50 +00:00
5848ac2df0
Issue #15476 : Merge index entries from 3.5
2016-06-09 23:36:40 +00:00
711d25db48
Merge 3.5 (issue #27243 )
2016-06-09 15:13:16 -04:00
a6f6edbda8
Issue #27243 : Fix __aiter__ protocol
2016-06-09 15:08:31 -04:00
7d7a11b5d7
Issue #23275 : Backport target list assignment documentation fixes
2016-06-08 12:44:30 +00:00
3bad04ca62
Merge: #26829 : Clarify that namespace is copied to a new __dict__ in instance creation.
2016-06-02 20:06:13 -04:00
dd4fcf52f4
#26829 : Clarify that namespace is copied to a new __dict__ in instance creation.
...
Patch by Emily Morehouse.
2016-06-02 20:05:43 -04:00
e9b8403a1f
[Issue 15476] Make "code object" its own entry in the index
2016-06-02 19:26:51 -04:00
094c9c921c
Issue #23275 : Allow () = iterable assignment syntax
...
Documentation updates by Martin Panter.
2016-05-18 08:44:29 +03:00
36c18956b0
Issue #27049 : fix doc typo
2016-05-17 21:45:13 -04:00
cec95813b2
Issue #27049 : fix doc typo
2016-05-17 21:44:46 -04:00
815b61d4ce
merge 3.5 ( #27042 )
2016-05-16 23:20:32 -07:00
54044d605f
class definitions only get argument lists ( closes #27042 )
2016-05-16 23:20:22 -07:00
bc7ee43a6d
Backed out changeset 71ff2235bb4c ( closes #27042 )
2016-05-16 23:18:33 -07:00
c499f30286
Issue #23921 : Standardized documentation whitespace formatting.
...
Original patch by James Edwards.
2016-05-10 12:01:56 +03:00
dba903993a
Issue #23921 : Standardized documentation whitespace formatting.
...
Original patch by James Edwards.
2016-05-10 12:01:23 +03:00
a26e4b97d8
Issue #26156 : Make expressions grammar description more semantically correct.
2016-05-08 22:00:09 +03:00
c7cc9850d4
Issue #26156 : Make expressions grammar description more semantically correct.
2016-05-08 21:59:46 +03:00
1ce738e08f
Merge typo fixes from 3.5
2016-05-08 14:02:35 +00:00
f0564164ba
Fix typos in comments, documentation and test method names
2016-05-08 13:48:10 +00:00
1acbf853c8
Issue #26736 : Used HTTPS for external links in the documentation if possible.
2016-05-07 10:49:58 +03:00
6dff0205b7
Issue #26736 : Used HTTPS for external links in the documentation if possible.
2016-05-07 10:49:07 +03:00
c61d80cc83
Issue #18572 : Remove redundant note about surrogates in string escape doc
2016-04-24 03:14:01 +03:00
4f35d79d65
Issue #18572 : Remove redundant note about surrogates in string escape doc
2016-04-24 03:13:40 +03:00
7b1e5a7722
Remove redundant leading zeroes in PEP references.
2016-03-31 15:31:20 +03:00
e4ba872543
Remove redundant leading zeroes in PEP references.
2016-03-31 15:30:54 +03:00
3e48b38dff
Merge 3.5 (issue #25887 )
2016-02-13 18:00:31 -05:00
77c96813ab
Issue #25887 : Raise a RuntimeError when a coroutine is awaited more than once.
2016-02-13 17:59:05 -05:00
bc1ee460dc
Issue #25179 : Documentation for formatted string literals aka f-strings
...
Some of the inspiration and wording is taken from the text of PEP 498 by Eric
V. Smith, and the existing str.format() documentation.
2016-02-13 00:41:37 +00:00
e922289620
Merge with 3.5
2016-02-03 22:07:08 -06:00
2b818142d1
Python for .NET has moved to Github.
...
Reported by Denis Akhiyarov on docs@
2016-02-03 22:05:46 -06:00
849113af6b
Issue #25791 : Warn when __package__ != __spec__.parent.
...
In a previous change, __spec__.parent was prioritized over
__package__. That is a backwards-compatibility break, but we do
eventually want __spec__ to be the ground truth for module details. So
this change reverts the change in semantics and instead raises an
ImportWarning when __package__ != __spec__.parent to give people time
to adjust to using spec objects.
2016-01-22 15:25:50 -08:00
63b8505281
Issue #25791 : Raise an ImportWarning when __spec__ or __package__ are
...
not defined for a relative import.
This is the start of work to try and clean up import semantics to rely
more on a module's spec than on the myriad attributes that get set on
a module. Thanks to Rose Ames for the patch.
2016-01-15 13:33:03 -08:00
3ad18dc7a7
Merge for issue #25500
2015-12-04 14:52:07 -08:00
f4f25fe576
Issue #25500 : Fix the language reference to not claim that import
...
statements search for __import__ in the global scope.
Thanks to Sergei Lebedev for finding the documentation bug.
2015-12-04 14:51:26 -08:00
3129571fb1
Merge: #25679 : spelling fix
2015-11-20 09:59:19 -05:00
0aaeacb3f1
Merge: #25679 : spelling fix
2015-11-20 09:58:51 -05:00
delirious-lettuce
Dominik Miedziński
csabella
Serhiy Storchaka
Jim Fasarakis-Hilliard
UltimateCoder
Jelle Zijlstra
cocoatomo
Amit Kumar
Ivan Levkivskyi
Mariatta
Marco Buttu
Martin Panter
Berker Peksag
Victor Stinner
Yury Selivanov
Nick Coghlan
Jason R. Coombs
Raymond Hettinger
Guido van Rossum
Brett Cannon
Eric Snow
R David Murray
Tommy Beadle
Ned Deily
Benjamin Peterson
Yury Selivanov
Zachary Ware