51d06abc99
importlib.import_module is better these days
2009-05-14 00:33:10 +00:00
2ca9be4a0c
#5925 : fix highlighting of keyword table.
2009-05-04 20:42:08 +00:00
16a57f6a34
Demote warnings to notices where appropriate, following the goal that as few "red box" warnings
...
should clutter the docs as possible. Part 1: stuff that gets merged to Py3k.
2009-04-27 15:29:09 +00:00
508c423fe1
Add link to PEP 236.
2009-04-23 08:52:03 +00:00
456cb1e694
Simplify markup.
2009-04-13 12:36:18 +00:00
5623e50d1a
Let "lambda" point to the correct heading.
2009-04-10 08:16:47 +00:00
2ce1c61ca6
Fix-up unwanted change.
2009-03-31 19:14:42 +00:00
268d85d1e8
#992207 : document that the parser only accepts \\n newlines.
2009-03-31 16:54:38 +00:00
624f3372e2
#5529 : backport new docs of import semantics written by Brett to 2.x.
2009-03-31 16:11:45 +00:00
dc340eedaa
#5039 : make it clear that the impl. note refers to CPython.
2009-03-30 22:43:00 +00:00
a0eea590c7
Add section numbering to some of the larger subdocuments.
2009-03-28 19:57:36 +00:00
173c1f1a01
#5469 : add with statement to list of name-binding constructs.
2009-03-15 21:53:56 +00:00
3259ef3dff
#5493 : clarify __nonzero__ docs.
2009-03-15 21:37:16 +00:00
351de8017c
Add reference to solution for a commonly asked question.
2009-03-12 00:25:03 +00:00
a630735b31
#5317 : update IronPython URL.
2009-02-19 16:34:51 +00:00
e7cb1ce895
#5310 , #3558 : fix operator precedence table.
2009-02-19 08:30:06 +00:00
0ac63f1c50
#5296 : sequence -> iterable.
2009-02-18 00:25:13 +00:00
9834dd72bc
#3734 : document complex coercing behavior better.
2009-02-13 10:44:17 +00:00
5b0d5531f2
Clarify some __del__ stuff.
2009-01-29 00:54:11 +00:00
fe11f4d524
#4986 : augassigns are not expressions.
2009-01-18 18:25:30 +00:00
4a565cc41d
#4857 : fix augmented assignment target spec.
2009-01-18 13:47:26 +00:00
b746448f46
fix grammar
2009-01-18 01:28:46 +00:00
f1a4069481
bytearrays are mutable sequences
2009-01-18 01:28:09 +00:00
c62ef8b4d9
Remove trailing whitespace.
2009-01-03 20:55:06 +00:00
9a05373145
#4517 : add "special method" glossary entry and clarify when __getattribute__ is bypassed.
2008-12-05 15:29:39 +00:00
3fc4226057
Add an index entry for "subclassing immutable types".
2008-12-05 08:06:57 +00:00
233bb00c1c
improve __hash__ docs
2008-11-17 22:05:19 +00:00
d79af0fc52
finish backporting binary literals and new octal literals docs
2008-10-30 22:44:18 +00:00
b5f8208b49
backport bin() documentation
2008-10-30 22:39:25 +00:00
c756dcdd60
only nonempty __slots__ don't work
2008-10-23 21:43:48 +00:00
865cd640bb
#4083 : add "as" to except handler grammar as per PEP 3110.
2008-10-16 21:38:48 +00:00
f660a53c9f
update paragraph about __future__ for 2.6
2008-10-09 20:54:43 +00:00
fe7c26d942
mention how to override boolean evaluation
2008-09-23 13:32:46 +00:00
83463ce8d4
#3914 : add //= to the augmented assign operators.
2008-09-21 07:18:28 +00:00
9af9498c6e
Remove things specific to the old Macintosh, and spell "Mac OS X" consistently.
2008-09-13 17:41:16 +00:00
64fc6aee99
Use title case
2008-09-13 02:08:30 +00:00
82358691f7
Issue 2235: document the ability to block inheritance of __hash__ in the language reference
2008-08-31 13:10:50 +00:00
c176814d82
#3716 : fix typo.
2008-08-30 09:52:44 +00:00
80f0ed5bb1
allow keyword args to be passed in after *args #3473
2008-08-19 19:52:46 +00:00
a174a37321
#3558 : Attribute reference binds more tightly than subscription and call.
2008-08-15 18:35:09 +00:00
9329846f00
Fix markup for various binary operation examples where the operands were bolded
...
and the operator was made literal, leading to non-valid reST. Changed to have
the entire expression just be a literal bit of text.
2008-08-14 05:55:18 +00:00
463f39d9ac
#3519 : callee is an expression too.
2008-08-08 06:42:20 +00:00
03894c5070
Fix longstringitem definition. #3505 .
2008-08-06 17:20:41 +00:00
a510748085
Issue 643841: better documentation of the special method lookup process, especially for new-style classes. Also removes the warnings about not being authoritative for new-style classes - the language reference actually covers those fairly well now (albeit in a fashion that isn't always particularly easy to follow).
2008-08-04 12:40:59 +00:00
290d3d994a
This should really be a comment.
2008-08-01 20:13:29 +00:00
632f631c48
Add the grammar to the reference manual, since the new docs don't
...
have the feature of putting all the small EBNF snippets together
into one big file.
2008-08-01 20:04:43 +00:00
e64f738507
#926501 : add info where to put the docstring.
2008-07-20 11:50:29 +00:00
3de1e69dc7
#3323 : mention that if inheriting from a class without __slots__,
...
the subclass will have a __dict__ available too.
2008-07-19 13:09:42 +00:00
3214a01d27
#1410739 : add a footnote about "is" and "unusual" behavior.
2008-07-01 20:50:02 +00:00
b7b8bff532
reinstate the ending backtick. thanks Nick :)
2008-06-29 13:43:07 +00:00
6e4856a146
rewrap
2008-06-28 23:06:49 +00:00
d82a9c1618
Fix brackets.
2008-06-06 10:43:43 +00:00
a6168f9e0a
Queue renaming reversal part 3: move module into place and
...
change imports and other references. Closes #2925 .
2008-05-25 07:20:14 +00:00
0b66731ddd
Mention that the leaking of variables from list comprehensions
...
is fixed in 3.0.
2008-05-23 19:33:13 +00:00
feb0921f9f
#1760 : try-except-finally is one statement since PEP 341.
2008-05-12 17:14:51 +00:00
7a148c2357
Fix-up docs for socketserver and queue renaming.
2008-05-12 10:03:16 +00:00
e9135ba79d
#2147 : PEP 237 changes to overflow behavior.
2008-05-11 10:55:59 +00:00
f8770fb5e2
#2677 : add note that not all functions may accept keyword args.
2008-04-27 09:39:59 +00:00
3822af6d3a
Add *,**,@ to index, as suggested by
...
http://farmdev.com/thoughts/24/what-does-the-def-star-variable-or-def-asterisk-parameter-syntax-do-in-python-/
The right entry type to use isn't clear; operator seems wrong, because *,**,@
aren't being used in expressions here. I put them as 'statement'; 'syntax'
might be better.
2008-04-15 13:10:07 +00:00
19baaadf51
Add punctuation
2008-04-10 21:28:51 +00:00
3351e4142c
Remove forward-looking statement
2008-04-10 21:27:10 +00:00
489343e948
Don't use the confusing term "set membership".
2008-03-28 12:24:51 +00:00
3fbe20c01e
Add docs for __func__ and __self__ on methods.
2008-03-21 19:20:21 +00:00
0267781742
Fix lots of broken links in the docs, found by Sphinx' external link checker.
2008-03-15 00:20:19 +00:00
d51e842a3f
Add class decorators
2008-03-13 11:07:35 +00:00
47a5aec836
#2253 : fix continue vs. finally docs.
2008-03-08 09:54:06 +00:00
8e67ef52db
Expand a bit on genexp scopes.
2008-03-03 21:31:50 +00:00
907a720f89
A lot more typo fixes by Ori Avtalion.
2008-02-22 12:31:45 +00:00
63cdb867f0
#2003 : fix sentence.
2008-02-03 12:29:00 +00:00
953e1ee8f4
Fix \xhh specs, #1889 .
2008-01-22 07:53:31 +00:00
a9e073d100
Note that genexps are function scopes too and therefore won't see class attributes.
2008-01-18 16:42:57 +00:00
3ccb49afed
Clarify metaclass docs and add example.
2008-01-07 19:17:10 +00:00
81de0d24d5
#1582 : document __reversed__, patch by Mark Russell.
2008-01-06 16:17:56 +00:00
f725b9587c
Doc patch #1730 from Robin Stocker; minor corrections mostly to os.rst.
2008-01-05 19:44:22 +00:00
6265833d91
Simplify index entries; fix #1712 .
2008-01-05 19:29:45 +00:00
9871d8fe22
Continue rolling back pep-3141 changes that changed behavior from 2.5. This
...
round included:
* Revert round to its 2.6 behavior (half away from 0).
* Because round, floor, and ceil always return float again, it's no
longer necessary to have them delegate to __xxx___, so I've ripped
that out of their implementations and the Real ABC. This also helps
in implementing types that work in both 2.6 and 3.0: you return int
from the __xxx__ methods, and let it get enabled by the version
upgrade.
* Make pow(-1, .5) raise a ValueError again.
2008-01-05 08:47:13 +00:00
2f3c16be73
Backport PEP 3141 from the py3k branch to the trunk. This includes r50877 (just
...
the complex_pow part), r56649, r56652, r56715, r57296, r57302, r57359, r57361,
r57372, r57738, r57739, r58017, r58039, r58040, and r59390, and new
documentation. The only significant difference is that round(x) returns a float
to preserve backward-compatibility. See http://bugs.python.org/issue1689 .
2008-01-03 02:21:52 +00:00
b19be571e0
Some cleanup in the docs.
2007-12-29 10:57:00 +00:00
44eeaec173
Patch #1537 from Chad Austin
...
Change GeneratorExit's base class from Exception to BaseException
(This time I'm applying the patch to the correct sandbox.)
2007-12-03 20:01:02 +00:00
584265b001
Add more entries to the glossary.
...
Written by Jeff Wheeler for GHOP.
2007-12-02 14:58:50 +00:00
03c1d1e9c4
Remove duplication of "this".
2007-11-11 15:16:16 +00:00
7c3e79f67f
Make "hashable" a glossary entry and clarify docs on __cmp__, __eq__ and __hash__.
...
I hope the concept of hashability is better understandable now.
Thanks to Tim Hatch for pointing out the flaws here.
2007-11-02 20:06:17 +00:00
a739503881
Add :term:s for "new-style class".
2007-10-21 12:15:05 +00:00
63fa168326
Unify "byte code" to "bytecode". Also sprinkle :term: markup for it.
2007-10-21 10:24:20 +00:00
d92e871ad8
Added note in footnote about string comparisons about
...
unicodedata.normalize().
2007-10-03 08:53:21 +00:00
745e48dffa
A bit of reordering, also show more subheadings in the lang ref index.
2007-09-18 07:24:40 +00:00
8360d5de7e
Fix a wrong indentation for sublists.
2007-09-07 14:14:40 +00:00
5768d577d3
Backport from Py3k: Bug #1684991 : explain lookup semantics for __special__ methods (new-style classes only).
2007-09-05 13:36:44 +00:00
3761422749
Bug #1758696 : more info about descriptors.
2007-08-23 21:42:54 +00:00
8d9e84554e
Bug #1697820 : document that the old slice protocol is still used by builtin types.
2007-08-23 20:35:00 +00:00
32008321f5
Bug #1777168 : replace operator names "opa"... with "op1"... and mark everything up as literal,
...
to enhance readability.
2007-08-21 06:12:19 +00:00
ff457b1d05
Bug #1777160 : mention explicitly that e.g. -1**2 is -1.
2007-08-21 06:07:08 +00:00
216ad337bd
Added a note in each regarding the fact that unicode strings that look the same
...
may not compare equal (due to the possibility of multiple representations).
2007-08-16 10:09:22 +00:00
8ec7f65613
Move the 2.6 reST doc tree in place.
2007-08-15 14:28:01 +00:00
Benjamin Peterson
Georg Brandl
Raymond Hettinger
Brett Cannon
Andrew M. Kuchling
Nick Coghlan
Martin v. Löwis
Jeffrey Yasskin
Christian Heimes
Mark Summerfield