Commit Graph

115 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 e56101136c #5751: fix escaping of \\n. 2009-04-21 18:24:34 +00:00
Raymond Hettinger 76162e305c Clarify the behavior of any() and all() with an empty iterable. 2009-04-16 18:16:10 +00:00
Antoine Pitrou 789be0c0a0 Issue #2396: backport the memoryview object. 2009-04-02 21:18:34 +00:00
Georg Brandl d59efbccf1 #5199: make warning about vars() assignment more visible. 2009-03-30 22:09:34 +00:00
Benjamin Peterson 06919a177d a much better example 2009-03-18 20:58:09 +00:00
Benjamin Peterson ed3558b334 I thought this was begging for an example 2009-03-17 20:29:51 +00:00
Raymond Hettinger ed955f108f Fix typo. 2009-02-26 00:05:24 +00:00
Raymond Hettinger afe496dc46 Remove reference to zero argument form of super() in 2.x docs. 2009-02-25 01:06:52 +00:00
Raymond Hettinger b762d58544 More markup and spelling fixes. 2009-02-25 00:52:37 +00:00
Raymond Hettinger eb7cbb94c5 Restore Py2.x version of sample call to super(). 2009-02-25 00:39:47 +00:00
Raymond Hettinger 9766033b7c Sync-up py3.1 doc updates for super(). 2009-02-25 00:37:57 +00:00
Georg Brandl 528f8810aa #5348: format() converts all kinds of values. 2009-02-23 10:24:23 +00:00
Raymond Hettinger 749e6d0a01 Add links to helpful external resources. 2009-02-19 06:55:03 +00:00
Raymond Hettinger f9bce83e71 Add some cross-references to the docs. Simplify the python code equivalent for izip(). Supply an optional argument for the nth() recipe. 2009-02-19 05:34:35 +00:00
Raymond Hettinger 7c98a6d4dc Add explanation for super(type1, type2). 2009-02-16 23:00:25 +00:00
Raymond Hettinger fd04870a3d Issue 5229: Documentation for super() neglects to say what super() actually does 2009-02-16 22:42:54 +00:00
Georg Brandl 95f8ef2825 make "super only for new-style classes" a note. 2009-02-07 18:49:54 +00:00
Georg Brandl c62ef8b4d9 Remove trailing whitespace. 2009-01-03 20:55:06 +00:00
Georg Brandl f8668ce473 #4457: rewrite __import__() documentation. 2008-12-07 22:42:09 +00:00
Georg Brandl 248e172ff8 Move __import__ to the bottom of the functions list.
It doesn't make sense for such a fundamental document to have
the most obscure function listed at the top.
2008-12-05 15:52:20 +00:00
Benjamin Peterson 942e4779b0 clarify what was added 2008-11-08 17:07:06 +00:00
Benjamin Peterson 728c6f6d34 move context clue to versionchanged tag 2008-11-08 17:04:18 +00:00
Benjamin Peterson d923f987d1 a few compile() and ast doc improvements 2008-11-08 16:55:33 +00:00
Benjamin Peterson b5f8208b49 backport bin() documentation 2008-10-30 22:39:25 +00:00
Benjamin Peterson 1fb84519b1 add a much requested newline 2008-10-15 21:58:46 +00:00
Benjamin Peterson 83ca0a6511 talk about how you can unzip with zip 2008-10-10 20:51:37 +00:00
Georg Brandl 34211e91ef #4041: don't refer to removed and outdated modules. 2008-10-04 18:26:01 +00:00
Raymond Hettinger 3134f14b1a Improve docs for super(). 2008-09-19 08:07:48 +00:00
Benjamin Peterson 881c4878cb clarify that radix for int is not 'guessed' 2008-09-14 16:02:22 +00:00
Georg Brandl f5a3fb730f super() actually returns a super object. 2008-08-30 13:17:39 +00:00
Georg Brandl 6140651d93 #3569: eval() also accepts "exec"able code objects. 2008-08-30 10:03:09 +00:00
Benjamin Peterson 90f36730e2 fix various doc typos #3320 2008-07-12 20:16:19 +00:00
Georg Brandl 913835763a #2831: add start argument to enumerate(). Patch by Scott Dial and me. 2008-05-13 19:04:54 +00:00
Georg Brandl 21f990cf0e Fix parameter name for enumerate(). 2008-05-12 16:53:42 +00:00
Georg Brandl 2ac747c05a #2812: document property.getter/setter/deleter. 2008-05-11 08:47:53 +00:00
Georg Brandl 28e0873f1f #2719: backport next() from 3k. 2008-04-30 19:47:09 +00:00
Georg Brandl a3bb57caee #2668: nit in apply() docs. 2008-04-26 18:25:43 +00:00
Georg Brandl fc8eef3c78 Patch #1810 by Thomas Lee, reviewed by myself:
allow compiling Python AST objects into code objects
in compile().
2008-03-28 12:11:56 +00:00
Georg Brandl 18f1914a02 #868845: document <...> reprs. 2008-03-25 07:20:15 +00:00
Georg Brandl 7a45ab826e Enable doctests in functions.rst. Already found two errors :) 2008-03-22 21:38:33 +00:00
Georg Brandl d346475a0c Add docs for print_function and future_builtins. Fixes #2442. 2008-03-21 19:37:57 +00:00
Jeffrey Yasskin ca2b69f765 Move __builtins__.trunc() to math.trunc() per
http://mail.python.org/pipermail/python-dev/2008-January/076626.html and issue
1965.
2008-02-01 06:22:46 +00:00
Raymond Hettinger 9ed5b57fe2 Give zip() the same guarantee as izip() for left-to-right evaluation. 2008-01-22 20:18:53 +00:00
Georg Brandl 92058d2933 #652749: document the constants added to the builtins by site.py. 2008-01-20 13:08:37 +00:00
Georg Brandl 9f1e2ecb48 Clarify the effect of text mode. 2008-01-13 09:36:18 +00:00
Georg Brandl 4273222a68 Remove latex trace. 2008-01-06 23:22:27 +00:00
Georg Brandl 516787dd98 #1499: Document compile() exceptions. 2008-01-06 16:22:56 +00:00
Georg Brandl 81de0d24d5 #1582: document __reversed__, patch by Mark Russell. 2008-01-06 16:17:56 +00:00
Georg Brandl 91a4808aa8 #759525: document that dir() doesn't return metaclass attrs when given a class as arg. 2008-01-06 15:48:20 +00:00
Georg Brandl a8cbad3b83 #1755097: document default values for [].sort() and sorted(). 2008-01-06 15:34:57 +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
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 0a8143f646 Applied patch #1635: Float patch for inf and nan on Windows (and other platforms).
The patch unifies float("inf") and repr(float("inf")) on all platforms.
2007-12-18 23:22:54 +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
Mark Summerfield ac3d429edc Added more file-handling related cross-references. 2007-11-02 08:24:59 +00:00
Georg Brandl a739503881 Add :term:s for "new-style class". 2007-10-21 12:15:05 +00:00
Georg Brandl e7a0990113 Add :term:s for iterator. 2007-10-21 12:10:28 +00:00
Georg Brandl 63fa168326 Unify "byte code" to "bytecode". Also sprinkle :term: markup for it. 2007-10-21 10:24:20 +00:00
Georg Brandl c4ed9713a7 Clarify wording for apply(). 2007-10-19 12:32:39 +00:00
Georg Brandl e4186252b1 #1196: document default radix for int(). 2007-09-24 17:59:28 +00:00
Mark Summerfield ddca9f0823 Replaced variable o with obj in operator.rst because o is easy to
confuse.

Added a note about Python 3's collections.Mapping etc., above section
that describes isMappingType() etc.

Added xrefs between os, os.path, fileinput, and open().
2007-09-13 14:54:30 +00:00
Georg Brandl 8ec7f65613 Move the 2.6 reST doc tree in place. 2007-08-15 14:28:01 +00:00