Georg Brandl
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
Georg Brandl
508c423fe1
Add link to PEP 236.
2009-04-23 08:52:03 +00:00
Georg Brandl
456cb1e694
Simplify markup.
2009-04-13 12:36:18 +00:00
Georg Brandl
5623e50d1a
Let "lambda" point to the correct heading.
2009-04-10 08:16:47 +00:00
Georg Brandl
2ce1c61ca6
Fix-up unwanted change.
2009-03-31 19:14:42 +00:00
Georg Brandl
268d85d1e8
#992207 : document that the parser only accepts \\n newlines.
2009-03-31 16:54:38 +00:00
Georg Brandl
624f3372e2
#5529 : backport new docs of import semantics written by Brett to 2.x.
2009-03-31 16:11:45 +00:00
Georg Brandl
dc340eedaa
#5039 : make it clear that the impl. note refers to CPython.
2009-03-30 22:43:00 +00:00
Georg Brandl
a0eea590c7
Add section numbering to some of the larger subdocuments.
2009-03-28 19:57:36 +00:00
Georg Brandl
173c1f1a01
#5469 : add with statement to list of name-binding constructs.
2009-03-15 21:53:56 +00:00
Georg Brandl
3259ef3dff
#5493 : clarify __nonzero__ docs.
2009-03-15 21:37:16 +00:00
Raymond Hettinger
351de8017c
Add reference to solution for a commonly asked question.
2009-03-12 00:25:03 +00:00
Georg Brandl
a630735b31
#5317 : update IronPython URL.
2009-02-19 16:34:51 +00:00
Georg Brandl
e7cb1ce895
#5310 , #3558 : fix operator precedence table.
2009-02-19 08:30:06 +00:00
Georg Brandl
0ac63f1c50
#5296 : sequence -> iterable.
2009-02-18 00:25:13 +00:00
Georg Brandl
9834dd72bc
#3734 : document complex coercing behavior better.
2009-02-13 10:44:17 +00:00
Brett Cannon
5b0d5531f2
Clarify some __del__ stuff.
2009-01-29 00:54:11 +00:00
Georg Brandl
fe11f4d524
#4986 : augassigns are not expressions.
2009-01-18 18:25:30 +00:00
Georg Brandl
4a565cc41d
#4857 : fix augmented assignment target spec.
2009-01-18 13:47:26 +00:00
Benjamin Peterson
b746448f46
fix grammar
2009-01-18 01:28:46 +00:00
Benjamin Peterson
f1a4069481
bytearrays are mutable sequences
2009-01-18 01:28:09 +00:00
Georg Brandl
c62ef8b4d9
Remove trailing whitespace.
2009-01-03 20:55:06 +00:00
Georg Brandl
9a05373145
#4517 : add "special method" glossary entry and clarify when __getattribute__ is bypassed.
2008-12-05 15:29:39 +00:00
Georg Brandl
3fc4226057
Add an index entry for "subclassing immutable types".
2008-12-05 08:06:57 +00:00
Benjamin Peterson
233bb00c1c
improve __hash__ docs
2008-11-17 22:05:19 +00:00
Benjamin Peterson
d79af0fc52
finish backporting binary literals and new octal literals docs
2008-10-30 22:44:18 +00:00
Benjamin Peterson
b5f8208b49
backport bin() documentation
2008-10-30 22:39:25 +00:00
Benjamin Peterson
c756dcdd60
only nonempty __slots__ don't work
2008-10-23 21:43:48 +00:00
Georg Brandl
865cd640bb
#4083 : add "as" to except handler grammar as per PEP 3110.
2008-10-16 21:38:48 +00:00
Benjamin Peterson
f660a53c9f
update paragraph about __future__ for 2.6
2008-10-09 20:54:43 +00:00
Benjamin Peterson
fe7c26d942
mention how to override boolean evaluation
2008-09-23 13:32:46 +00:00
Georg Brandl
83463ce8d4
#3914 : add //= to the augmented assign operators.
2008-09-21 07:18:28 +00:00
Georg Brandl
9af9498c6e
Remove things specific to the old Macintosh, and spell "Mac OS X" consistently.
2008-09-13 17:41:16 +00:00
Andrew M. Kuchling
64fc6aee99
Use title case
2008-09-13 02:08:30 +00:00
Nick Coghlan
82358691f7
Issue 2235: document the ability to block inheritance of __hash__ in the language reference
2008-08-31 13:10:50 +00:00
Georg Brandl
c176814d82
#3716 : fix typo.
2008-08-30 09:52:44 +00:00
Benjamin Peterson
80f0ed5bb1
allow keyword args to be passed in after *args #3473
2008-08-19 19:52:46 +00:00
Georg Brandl
a174a37321
#3558 : Attribute reference binds more tightly than subscription and call.
2008-08-15 18:35:09 +00:00
Brett Cannon
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
Georg Brandl
463f39d9ac
#3519 : callee is an expression too.
2008-08-08 06:42:20 +00:00
Georg Brandl
03894c5070
Fix longstringitem definition. #3505 .
2008-08-06 17:20:41 +00:00
Nick Coghlan
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
Georg Brandl
290d3d994a
This should really be a comment.
2008-08-01 20:13:29 +00:00
Georg Brandl
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
Georg Brandl
e64f738507
#926501 : add info where to put the docstring.
2008-07-20 11:50:29 +00:00
Georg Brandl
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
Georg Brandl
3214a01d27
#1410739 : add a footnote about "is" and "unusual" behavior.
2008-07-01 20:50:02 +00:00
Benjamin Peterson
b7b8bff532
reinstate the ending backtick. thanks Nick :)
2008-06-29 13:43:07 +00:00
Benjamin Peterson
6e4856a146
rewrap
2008-06-28 23:06:49 +00:00
Georg Brandl
d82a9c1618
Fix brackets.
2008-06-06 10:43:43 +00:00
Georg Brandl
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
Martin v. Löwis
0b66731ddd
Mention that the leaking of variables from list comprehensions
...
is fixed in 3.0.
2008-05-23 19:33:13 +00:00
Georg Brandl
feb0921f9f
#1760 : try-except-finally is one statement since PEP 341.
2008-05-12 17:14:51 +00:00
Georg Brandl
7a148c2357
Fix-up docs for socketserver and queue renaming.
2008-05-12 10:03:16 +00:00
Georg Brandl
e9135ba79d
#2147 : PEP 237 changes to overflow behavior.
2008-05-11 10:55:59 +00:00
Georg Brandl
f8770fb5e2
#2677 : add note that not all functions may accept keyword args.
2008-04-27 09:39:59 +00:00
Andrew M. Kuchling
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
Andrew M. Kuchling
19baaadf51
Add punctuation
2008-04-10 21:28:51 +00:00
Andrew M. Kuchling
3351e4142c
Remove forward-looking statement
2008-04-10 21:27:10 +00:00
Georg Brandl
489343e948
Don't use the confusing term "set membership".
2008-03-28 12:24:51 +00:00
Georg Brandl
3fbe20c01e
Add docs for __func__ and __self__ on methods.
2008-03-21 19:20:21 +00:00
Georg Brandl
0267781742
Fix lots of broken links in the docs, found by Sphinx' external link checker.
2008-03-15 00:20:19 +00:00
Andrew M. Kuchling
d51e842a3f
Add class decorators
2008-03-13 11:07:35 +00:00
Georg Brandl
47a5aec836
#2253 : fix continue vs. finally docs.
2008-03-08 09:54:06 +00:00
Georg Brandl
8e67ef52db
Expand a bit on genexp scopes.
2008-03-03 21:31:50 +00:00
Georg Brandl
907a720f89
A lot more typo fixes by Ori Avtalion.
2008-02-22 12:31:45 +00:00
Georg Brandl
63cdb867f0
#2003 : fix sentence.
2008-02-03 12:29:00 +00:00
Georg Brandl
953e1ee8f4
Fix \xhh specs, #1889 .
2008-01-22 07:53:31 +00:00
Georg Brandl
a9e073d100
Note that genexps are function scopes too and therefore won't see class attributes.
2008-01-18 16:42:57 +00:00
Georg Brandl
3ccb49afed
Clarify metaclass docs and add example.
2008-01-07 19:17:10 +00:00
Georg Brandl
81de0d24d5
#1582 : document __reversed__, patch by Mark Russell.
2008-01-06 16:17:56 +00:00
Georg Brandl
f725b9587c
Doc patch #1730 from Robin Stocker; minor corrections mostly to os.rst.
2008-01-05 19:44:22 +00:00
Georg Brandl
6265833d91
Simplify index entries; fix #1712 .
2008-01-05 19:29:45 +00:00
Jeffrey Yasskin
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
Jeffrey Yasskin
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
Georg Brandl
b19be571e0
Some cleanup in the docs.
2007-12-29 10:57:00 +00:00
Christian Heimes
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
Georg Brandl
584265b001
Add more entries to the glossary.
...
Written by Jeff Wheeler for GHOP.
2007-12-02 14:58:50 +00:00
Georg Brandl
03c1d1e9c4
Remove duplication of "this".
2007-11-11 15:16:16 +00:00
Georg Brandl
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
Georg Brandl
a739503881
Add :term:s for "new-style class".
2007-10-21 12:15:05 +00:00
Georg Brandl
63fa168326
Unify "byte code" to "bytecode". Also sprinkle :term: markup for it.
2007-10-21 10:24:20 +00:00
Mark Summerfield
d92e871ad8
Added note in footnote about string comparisons about
...
unicodedata.normalize().
2007-10-03 08:53:21 +00:00
Georg Brandl
745e48dffa
A bit of reordering, also show more subheadings in the lang ref index.
2007-09-18 07:24:40 +00:00
Georg Brandl
8360d5de7e
Fix a wrong indentation for sublists.
2007-09-07 14:14:40 +00:00
Georg Brandl
5768d577d3
Backport from Py3k: Bug #1684991 : explain lookup semantics for __special__ methods (new-style classes only).
2007-09-05 13:36:44 +00:00
Georg Brandl
3761422749
Bug #1758696 : more info about descriptors.
2007-08-23 21:42:54 +00:00
Georg Brandl
8d9e84554e
Bug #1697820 : document that the old slice protocol is still used by builtin types.
2007-08-23 20:35:00 +00:00
Georg Brandl
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
Georg Brandl
ff457b1d05
Bug #1777160 : mention explicitly that e.g. -1**2 is -1.
2007-08-21 06:07:08 +00:00
Mark Summerfield
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
Georg Brandl
8ec7f65613
Move the 2.6 reST doc tree in place.
2007-08-15 14:28:01 +00:00