Commit Graph

142 Commits

Author SHA1 Message Date
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