Commit Graph

99 Commits

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