Commit Graph

8164 Commits

Author SHA1 Message Date
Phillip J. Eby 5cf565ddd1 Import wsgiref into the stdlib, as of the external version 0.1-r2181. 2006-06-09 16:40:18 +00:00
Andrew M. Kuchling 7dbb1ff77d Markup fix 2006-06-09 10:22:35 +00:00
Andrew M. Kuchling e878fe6a58 Update functools section 2006-06-09 01:10:17 +00:00
Nick Coghlan 676725db92 Add functools.update_wrapper() and functools.wraps() as described in PEP 356 2006-06-08 13:54:49 +00:00
Andrew M. Kuchling 06c5c8a4d3 Typo fix 2006-06-08 11:56:44 +00:00
Brett Cannon ec0d6f83cd Clarify documentation for bf_getcharbuffer. 2006-06-07 21:48:17 +00:00
Andrew M. Kuchling e275d3d4ce Mention other placeholders 2006-06-07 17:04:01 +00:00
Andrew M. Kuchling 3b336c7ced Add an item; also, escape % 2006-06-07 17:03:46 +00:00
Andrew M. Kuchling 1271f003a6 Mention other placeholders 2006-06-07 17:02:52 +00:00
Andrew M. Kuchling 12238d72a8 Add an SQLite introduction, taken from the 'What's New' text 2006-06-07 13:55:33 +00:00
Tim Peters dba6318ae6 On python-dev Thomas Heller said these were committed
by mistake in rev 46693, so reverting this part of
rev 46693.
2006-06-06 15:52:35 +00:00
Thomas Heller 56dab85022 Specify argtypes for all test functions. Maybe that helps on strange ;-) architectures 2006-06-06 15:34:18 +00:00
Andrew M. Kuchling 5332989bda [Bug #1470026] Include link to list of classifiers 2006-06-05 19:08:25 +00:00
Andrew M. Kuchling 760872d70e Remove use of Trove name, which isn't very helpful to users 2006-06-05 19:05:32 +00:00
Tim Peters bf0400abe9 Remove doctest.testmod's deprecated (in 2.4) `isprivate`
argument.  A lot of hair went into supporting that!
2006-06-05 01:43:03 +00:00
Andrew M. Kuchling 1985ff76ca Mention second encoding speedup 2006-06-05 00:08:09 +00:00
Tim Peters 28eeefe566 Revert revisions:
46640 Patch #1454481:  Make thread stack size runtime tunable.
46647 Markup fix

The first is causing many buildbots to fail test runs, and there
are multiple causes with seemingly no immediate prospects for
repairing them.  See python-dev discussion.

Note that a branch can (and should) be created for resolving these
problems, like

svn copy svn+ssh://svn.python.org/python/trunk -r46640 svn+ssh://svn.python.org/python/branches/NEW_BRANCH

followed by merging rev 46647 to the new branch.
2006-06-04 23:52:47 +00:00
George Yoshida 67966bed72 Markup fix 2006-06-04 17:17:25 +00:00
George Yoshida 660a4e9c6d Remove a redundant word 2006-06-04 17:04:12 +00:00
Ronald Oussoren fb2a169ce3 Drop Mac wrappers for the WASTE library. 2006-06-04 14:24:59 +00:00
Andrew MacIntyre 6539d2d3c7 Patch #1454481: Make thread stack size runtime tunable. 2006-06-04 12:31:09 +00:00
Andrew M. Kuchling 4094b3d08c Minor rewording 2006-06-03 18:43:24 +00:00
Andrew M. Kuchling 27ca711d20 [Bug #1441864] Clarify description of 'data' argument 2006-06-03 18:41:28 +00:00
Andrew M. Kuchling 794c89b678 [Bug #1475554] Strengthen text to say 'must' instead of 'should' 2006-06-03 18:33:35 +00:00
Andrew M. Kuchling 29d530b3ef [Bug #1472084] Fix description of do_tag 2006-06-03 18:09:41 +00:00
Tim Peters d609b1a20e pprint functions used to sort a dict (by key) if and only if
the output required more than one line.  "Small" dicts got
displayed in seemingly random order (the hash-induced order
produced by dict.__repr__).  None of this was documented.
Now pprint functions always sort dicts by key, and the docs
promise it.

This was proposed and agreed to during the PyCon 2006 core
sprint -- I just didn't have time for it before now.
2006-06-02 23:22:51 +00:00
Andrew M. Kuchling 07cf0722b3 Mention SimpleXMLRPCServer change 2006-05-31 14:12:47 +00:00
Andrew M. Kuchling 622f144175 [Bug #1473048]
SimpleXMLRPCServer and DocXMLRPCServer don't look at
the path of the HTTP request at all; you can POST or
GET from / or /RPC2 or /blahblahblah with the same results.
Security scanners that look for /cgi-bin/phf will therefore report
lots of vulnerabilities.

Fix: add a .rpc_paths attribute to the SimpleXMLRPCServer class,
and report a 404 error if the path isn't on the allowed list.

Possibly-controversial aspect of this change: the default makes only
'/' and '/RPC2' legal.  Maybe this will break people's applications
(though I doubt it).  We could just set the default to an empty tuple,
which would exactly match the current behaviour.
2006-05-31 14:08:48 +00:00
Andrew M. Kuchling 0d272bbccf 'functional' module was renamed to 'functools' 2006-05-31 13:18:56 +00:00
Brett Cannon 14a0952a1f Clarify wording on default values for strptime(); defaults are used when better
values cannot be inferred.

Closes bug #1496315.
2006-05-31 02:19:54 +00:00
Georg Brandl 261e251df8 Patches #1497027 and #972322: try HTTP digest auth first,
and watch out for handler name collisions.
2006-05-29 20:52:54 +00:00
Nick Coghlan c649ec5b69 Apply modified version of Collin Winter's patch #1478788
Renames functional extension module to _functools and adds a Python
functools module so that utility functions like update_wrapper can be
added easily.
2006-05-29 12:43:05 +00:00
George Yoshida f3c65de460 Patch #1080727: add "encoding" parameter to doctest.DocFileSuite
Contributed by Bjorn Tillenius.
2006-05-28 16:39:09 +00:00
George Yoshida a2d6c8a9d3 fix typo 2006-05-27 17:09:17 +00:00
George Yoshida 3689571425 End of Ch.3 is now about "with statement".
Avoid obsolescence by directly referring to the section.
2006-05-27 16:51:43 +00:00
George Yoshida 5e0b88200e minor markup nits 2006-05-27 16:32:44 +00:00
Richard Jones 87f5471230 credit where credit is due 2006-05-27 13:50:42 +00:00
Andrew M. Kuchling dae266ec61 Mention new-style exceptions 2006-05-27 13:44:37 +00:00
Richard Jones 7b9558d37d Conversion of exceptions over from faked-up classes to new-style C types. 2006-05-27 12:29:24 +00:00
Andrew M. Kuchling b98d65c0b7 Add Py_LOCAL macros 2006-05-27 11:26:33 +00:00
Martin v. Löwis d004fc810a Patch 1494554: Update numeric properties to Unicode 4.1. 2006-05-27 08:36:52 +00:00
Georg Brandl a89dbec257 Patch #1492218: document None being a constant. 2006-05-26 20:14:47 +00:00
Thomas Heller cc7570fd90 Write more docs. 2006-05-26 19:43:45 +00:00
Georg Brandl e001816dff Exception isn't the root of all exception classes anymore. 2006-05-26 19:04:47 +00:00
Andrew M. Kuchling afe6598732 Add rpartition() and path caching 2006-05-26 18:41:18 +00:00
Fredrik Lundh 9c0e9c089c needspeed: rpartition documentation, tests, and a bug fixes.
feel free to add more tests and improve the documentation.
2006-05-26 18:24:15 +00:00
Thomas Heller 2d6c5a868a Reordered, and wrote more docs. 2006-05-26 17:47:40 +00:00
Thomas Heller 69bfaab304 Write some docs. 2006-05-26 17:18:33 +00:00
Thomas Heller ada638bf91 For now, I gave up with automatic conversion of reST to Python-latex,
so I'm writing this in latex now.

Skeleton for the ctypes reference.
2006-05-26 16:42:44 +00:00
Andrew M. Kuchling c6f5c871b9 Typo fix 2006-05-26 14:04:19 +00:00
Andrew M. Kuchling 230c3e1bc0 Add buffer support for struct, socket 2006-05-26 14:03:41 +00:00
Andrew M. Kuchling ad0cb65fca Add str.partition() 2006-05-26 12:39:48 +00:00
Andrew M. Kuchling a0fcf502df Typo fixes 2006-05-26 12:01:44 +00:00
Georg Brandl 0c93ff6709 Clarify docs for str.partition(). 2006-05-26 09:05:54 +00:00
Fredrik Lundh 06a69dd8ff needforspeed: partition implementation, part two.
feel free to improve the documentation and the docstrings.
2006-05-26 08:54:28 +00:00
Georg Brandl 485dbd105f Add a x-ref to newer calling APIs. 2006-05-25 21:11:56 +00:00
Georg Brandl 9d67d5e9f7 Someone seems to just have copy-pasted the docs of
tp_compare to tp_richcompare ;)
2006-05-25 20:28:10 +00:00
Fred Drake 61bbe6c37c fix broken links in PDF
(SF patch #1281291, contributed by Rory Yorke)
2006-05-25 02:42:25 +00:00
Andrew M. Kuchling 3cdf24bc99 Minor edits; add an item 2006-05-25 00:23:03 +00:00
Andrew M. Kuchling 70bd199fa4 Add item 2006-05-23 19:32:35 +00:00
Andrew M. Kuchling 150faff195 Add two items 2006-05-23 19:29:38 +00:00
Andrew M. Kuchling 3e134a5960 Use 'speed' instead of 'performance', because I agree with the argument
at http://zestyping.livejournal.com/193260.html that 'erformance' really means
something more general.
2006-05-23 12:49:35 +00:00
Andrew M. Kuchling 1cdace4294 Mention string improvements 2006-05-23 12:47:01 +00:00
Andrew M. Kuchling c602723e45 Add some items; mention the sprint 2006-05-23 12:44:36 +00:00
Georg Brandl 658d513328 PyErr_NewException now accepts a tuple of base classes as its
"base" parameter.
2006-05-23 11:17:21 +00:00
George Yoshida 00f6e1905a Apply patch #1492255 from Mike Foord. 2006-05-21 04:40:32 +00:00
George Yoshida c120a6d897 Fix the TeX compile error. 2006-05-21 04:22:59 +00:00
Andrew M. Kuchling 1e9f574a18 Minor edits 2006-05-20 19:25:16 +00:00
George Yoshida b688b6c30a Apply patch #1492147 from Mike Foord. 2006-05-20 18:07:26 +00:00
George Yoshida 5c6a5ecddf - Add 'as' and 'with' as new keywords in 2.5.
- Regenerate keyword lists with reswords.py.
2006-05-20 16:29:14 +00:00
George Yoshida 6fffa5e865 - markup fix
- add clarifying words
2006-05-20 15:36:19 +00:00
Andrew M. Kuchling e04fe8c62e Typo fix; add clarifying word 2006-05-19 00:03:55 +00:00
Georg Brandl 007a382a4d Bug #1490688: properly document %e, %f, %g format subtleties. 2006-05-18 07:20:05 +00:00
Georg Brandl 7b90e168f3 Bug #1462152: file() now checks more thoroughly for invalid mode
strings and removes a possible "U" before passing the mode to the
C library function.
2006-05-18 07:01:27 +00:00
Georg Brandl b89316fdbf Patch #1180296: improve locale string formatting functions 2006-05-17 15:51:16 +00:00
Georg Brandl d419a93fbc Apply patch #1489784 from Michael Foord. 2006-05-17 14:11:36 +00:00
Georg Brandl c01b6aeede Remove misleading comment about type-class unification. 2006-05-17 14:06:07 +00:00
Tim Peters 1b38357094 Text files missing the SVN eol-style property. 2006-05-16 23:24:08 +00:00
George Yoshida 0c8d7b0f3f Document ImportWarning 2006-05-16 18:26:10 +00:00
George Yoshida 2f6ce536ab Mention that Exception is now a subclass of BaseException.
Remove a sentence that says that BaseException inherits from BaseException.
(I guess this is just a copy & paste mistake.)
2006-05-16 18:07:00 +00:00
Andrew M. Kuchling c0a0decd54 PEP 243 has been withdrawn, so don't refer to it any more.
The PyPI upload material has been moved into the section on PEP314.
2006-05-16 16:27:31 +00:00
Andrew M. Kuchling d779b353fa Add item 2006-05-16 16:11:54 +00:00
Georg Brandl 8d3342b489 Patch #1435422: zlib's compress and decompress objects now have a
copy() method.
2006-05-16 07:38:27 +00:00
Tim Peters e6d9506611 Typo repair. 2006-05-13 23:31:05 +00:00
Tim Peters 8931ff1f67 Teach PyString_FromFormat, PyErr_Format, and PyString_FromFormatV
about "%u", "%lu" and "%zu" formats.

Since PyString_FromFormat and PyErr_Format have exactly the same rules
(both inherited from PyString_FromFormatV), it would be good if someone
with more LaTeX Fu changed one of them to just point to the other.
Their docs were way out of synch before this patch, and I just did a
mass copy+paste to repair that.

Not a backport candidate (this is a new feature).
2006-05-13 23:28:20 +00:00
George Yoshida 90df06e5e2 Add \exception markup 2006-05-13 06:53:31 +00:00
Gerhard Häring 2b161d9038 Integrated the rest of the pysqlite reference manual into the Python
documentation. Ready to be reviewed and improved upon.
2006-05-12 23:49:49 +00:00
George Yoshida 8f505aed46 Duplicated description about the illegal continue usage can be found in nearly the same place.
They are same, so keep the original one and remove the later-added one.
2006-05-12 17:25:26 +00:00
George Yoshida 159a1160c1 At first there were 6 steps, but one was removed after that. 2006-05-12 16:40:11 +00:00
Tim Peters b06d28c160 SF patch #1473132: Improve docs for tp_clear and tp_traverse,
by Collin Winter.

Bugfix candidate (but I'm not going to bother).
2006-05-12 01:57:59 +00:00
Andrew M. Kuchling 7cadf59e14 typo fix 2006-05-11 16:32:24 +00:00
George Yoshida 4917c34b26 Grammar fix 2006-05-11 15:53:27 +00:00
Martin v. Löwis 879768dd97 Change WindowsError to carry the Win32 error code in winerror,
and the DOS error code in errno. Revert changes where
WindowsError catch blocks unnecessarily special-case OSError.
2006-05-11 13:28:43 +00:00
Georg Brandl dd0c312703 Fix two small errors in argument lists. 2006-05-10 20:09:23 +00:00
Andrew M. Kuchling 356af466c8 Clarify description of exception handling 2006-05-10 17:19:04 +00:00
Georg Brandl 38c6a22f38 Patch #1484695: Update the tarfile module to version 0.8. This fixes
a couple of issues, notably handling of long file names using the
GNU LONGNAME extension.
2006-05-10 16:26:03 +00:00
Georg Brandl f8d9a97ba2 Bug #1484978: curses.panel: clarify that Panel objects are destroyed on garbage collection. 2006-05-10 16:11:44 +00:00
Georg Brandl b1582557aa Bug #1485447: subprocess: document that the "cwd" parameter isn't used to find the executable. Misc. other markup fixes. 2006-05-10 16:09:03 +00:00
Georg Brandl e7d9539eba Bug #1482988: indicate more prominently that the Stats class is in the pstats module. 2006-05-10 15:59:06 +00:00
Andrew M. Kuchling 0901965134 Minor language edit 2006-05-07 17:14:53 +00:00
Andrew M. Kuchling fb10858fe7 [Patch #1479977] Revised version of urllib2 HOWTO, edited by John J. Lee 2006-05-07 17:12:12 +00:00
George Yoshida ce5933f582 Use \versionchanged for the feature change 2006-05-06 14:16:51 +00:00
George Yoshida d3d8ecda15 describe optional arguments for DocFileSuite 2006-05-06 13:09:45 +00:00
Nick Coghlan d8accb32a5 Get rid of a couple more context object references, fix some markup and clarify what happens when a generator context function swallows an exception. 2006-05-03 13:17:49 +00:00
Nick Coghlan afd5e63e24 Finish bringing SVN into line with latest version of PEP 343 by getting rid of all remaining references to context objects that I could find. Without a __context__() method context objects no longer exist. Also get test_with working again, and adopt a suggestion from Neal for decimal.Context.get_manager() 2006-05-03 13:02:47 +00:00
Martin v. Löwis a3a13298b2 Correct some formulations, fix XXX comments. 2006-05-03 04:52:04 +00:00
Tim Peters 4511a713d5 Whitespace normalization. 2006-05-03 04:46:14 +00:00
Fred Drake 3053667d09 fix up whitespace in prompt strings 2006-05-03 02:29:39 +00:00
Fred Drake 5f1cca0a1d one more place to avoid extra markup (how many will there be?) 2006-05-03 02:29:09 +00:00
Fred Drake 2de7a35e9a one more place to avoid extra markup 2006-05-03 02:27:40 +00:00
Fred Drake 6b07be9d29 at least comment on why curly-quotes are not enabled 2006-05-03 02:12:47 +00:00
Fred Drake f25fa6ddb9 avoid ugly markup based on the unfortunate conversions of ">>" and "<<" to
guillemets; no need for magic here
2006-05-03 02:04:40 +00:00
Fred Drake f863609cd6 tell LaTeX2HTML to:
- use UTF-8 output
- not mess with the >>> prompt!
2006-05-03 01:48:24 +00:00
Fred Drake e10b21bd6f remove unnecessary assignment 2006-05-03 01:46:52 +00:00
Andrew M. Kuchling f322d68327 Update context manager section for removal of __context__ 2006-05-02 22:47:49 +00:00
Armin Rigo a71fd71c3e Documentation bug: PySet_Pop() returns a new reference (because the
caller becomes the owner of that reference).
2006-05-02 19:52:32 +00:00
Guido van Rossum da5b701aee Get rid of __context__, per the latest changes to PEP 343 and python-dev
discussion.
There are two places of documentation that still mention __context__:
Doc/lib/libstdtypes.tex -- I wasn't quite sure how to rewrite that without
spending a whole lot of time thinking about it; and whatsnew, which Andrew
usually likes to change himself.
2006-05-02 19:47:52 +00:00
Andrew M. Kuchling a883701dff Provide encoding as keyword argument; soften warning paragraph about encodings 2006-05-02 11:30:03 +00:00
Fred Drake 017e68c413 SF #1479988: add methods to allow access to weakrefs for the
weakref.WeakKeyDictionary and weakref.WeakValueDictionary
2006-05-02 06:53:59 +00:00
Neal Norwitz c4edb0ec81 SF #1479181: split open() and file() from being aliases for each other. 2006-05-02 04:43:14 +00:00
Andrew M. Kuchling 4bbf66e852 Markup fixes 2006-05-01 17:06:54 +00:00
Andrew M. Kuchling 6849488914 Add item 2006-05-01 16:32:49 +00:00
Andrew M. Kuchling edbe657174 Markup fixes; add some XXX comments noting problems 2006-05-01 16:30:25 +00:00
Fred Drake d22c6dbdfa add dependency 2006-05-01 16:28:54 +00:00
Martin v. Löwis 5f4307491e Add msilib documentation. 2006-05-01 16:12:44 +00:00
Gerhard Häring 82560ebb8d Further integration of the documentation for the sqlite3 module. There's still
quite some content to move over from the pysqlite manual, but it's a start now.
2006-05-01 15:14:48 +00:00
Andrew M. Kuchling e3c958c33b Some ElementTree fixes: import from xml, not xmlcore; fix case of module name; mention list() instead of getchildren() 2006-05-01 12:45:02 +00:00
Fred Drake 6550f03216 - minor clarification in section title
- markup adjustments
(there is clearly much to be done in this section)
2006-05-01 06:25:58 +00:00
Andrew M. Kuchling 09612281ef Add item 2006-04-30 21:19:49 +00:00
Andrew M. Kuchling 4b5caae8b9 Add urllib2 HOWTO from Michael Foord 2006-04-30 21:19:31 +00:00
Georg Brandl 3c1983face Patch #1479438: add \keyword markup for "with". 2006-04-30 19:34:19 +00:00
Georg Brandl 3583cff5a9 Patch #1472854: make the rlcompleter.Completer class usable on non-
UNIX platforms.
2006-04-30 18:14:54 +00:00
Georg Brandl fa42bd7af4 Patch #1470846: fix urllib2 ProxyBasicAuthHandler. 2006-04-30 07:06:11 +00:00
George Yoshida 5085fe2bcc Use \versionchanged instead of \versionadded for new parameter support. 2006-04-30 03:49:56 +00:00
Andrew M. Kuchling c9236111ed Add two items 2006-04-30 01:07:09 +00:00
Gerhard Häring eb2e1926ac This is the start of documentation for the sqlite3 module. Please feel free to
find a better place for the link to it than alongside bsddb & friends.
2006-04-29 23:12:41 +00:00
Andrew M. Kuchling aa013da0b3 Add item 2006-04-29 12:10:43 +00:00
Andrew M. Kuchling 18db487692 Make case of 'ZIP' consistent 2006-04-29 12:10:28 +00:00
Andrew M. Kuchling b37bcb59bc Add item 2006-04-29 11:53:15 +00:00
George Yoshida f674939a2b grammar fix 2006-04-29 02:43:30 +00:00
George Yoshida d77167286f correct a dead link 2006-04-28 16:40:14 +00:00
Georg Brandl 677800723a Bug #1475009: clarify ntpath.join behavior with absolute components 2006-04-28 16:36:55 +00:00
George Yoshida 9dea97a224 fix markup glitch 2006-04-28 16:09:45 +00:00
George Yoshida 8bf939864b markup fix 2006-04-27 13:41:07 +00:00
Andrew M. Kuchling efd3a09fad Mention the xmlrpclib.Error base class, which is used in one of the examples 2006-04-27 12:42:54 +00:00
Andrew M. Kuchling 356f938f94 [Bug #1477140] Import Error base class 2006-04-27 12:38:35 +00:00
Andrew M. Kuchling 7acb7b40ba [Bug #1477102] Add necessary import to example
This may be a useful style question for the docs -- should examples show
the necessary imports, or should it be assumed that the reader will
figure it out?  In the What's New, I'm not consistent but usually opt
for omitting the imports.
2006-04-27 12:34:39 +00:00
Andrew M. Kuchling 99714cf9d0 Bump document version 2006-04-27 12:23:07 +00:00
Andrew M. Kuchling 1e649be16e Now that 2.5a2 is out, revert to the current date 2006-04-27 12:22:37 +00:00
Anthony Baxter c7d00327ab 2.5a2 2006-04-27 02:11:24 +00:00
Fred Drake 4b8ec63114 add missing word 2006-04-27 00:20:14 +00:00
Fred Drake dbb8c4123f - update version numbers in file names again, until we have a better way
- elaborate instructions for Cygwin support (closes SF #839709)
2006-04-27 00:02:24 +00:00
Fred Drake 0999433f40 one more place to use the current Python version 2006-04-26 23:40:32 +00:00
Andrew M. Kuchling 98189244a2 Add labels to all sections 2006-04-26 12:23:39 +00:00
Andrew M. Kuchling 7e5abb9d1f [Bug #1475080] Fix example 2006-04-26 12:21:06 +00:00
Nick Coghlan 790c3c1377 Fix an error in the last contextlib.closing example 2006-04-26 11:50:04 +00:00
Fred Drake a5f1fd09eb minor adjustment suggested by Peter Gephardt 2006-04-26 05:19:39 +00:00
Fred Drake 2afbf96f53 markup fixes, cleanup 2006-04-26 05:15:41 +00:00
George Yoshida 3bbbc49060 minor tweak 2006-04-25 14:09:58 +00:00
Andrew M. Kuchling d798a181ab Rework context terminology 2006-04-25 12:47:25 +00:00
Andrew M. Kuchling b33842ac51 Add two items; easy_install is now off the table, though pkgutil still is 2006-04-25 12:31:38 +00:00
Thomas Wouters 34a70c6011 Fix markup glitch in unittest docs. Will backport. 2006-04-25 12:28:56 +00:00
Nick Coghlan e708cf5d0f Fix latex typo 2006-04-25 11:05:56 +00:00
Nick Coghlan a7e820a408 Move the PEP 343 documentation and implementation closer to the
terminology in the alpha 1 documentation.

 - "context manager" reverts to its alpha 1 definition
 - the term "context specifier" goes away entirely
 - contextlib.GeneratorContextManager is renamed GeneratorContext

There are still a number of changes relative to alpha 1:

  - the expression in the with statement is explicitly called the
    "context expression" in the language reference
  - the terms 'with statement context', 'context object' or 'with
    statement context' are used in several places instead of a bare
    'context'. The aim of this is to avoid ambiguity in relation to the
    runtime context set up when the block is executed, and the context
    objects that already exist in various application domains (such as
    decimal.Context)
  - contextlib.contextmanager is renamed to contextfactory
    This best reflects the nature of the function resulting from the
    use of that decorator
  - decimal.ContextManager is renamed to WithStatementContext
    Simple dropping the 'Manager' part wasn't possible due to the
    fact that decimal.Context already exists and means something
    different. WithStatementContext is ugly but workable.

A technically unrelated change snuck into this commit:
contextlib.closing now avoids the overhead of creating a
generator, since it's trivial to implement that particular
context manager directly.
2006-04-25 10:56:51 +00:00
Neal Norwitz 327ea38cc4 Revert previous change, SKIP had a versionadded elsewhere 2006-04-25 05:49:42 +00:00
Neal Norwitz 85c767ac87 versionadded for SKIP 2006-04-25 05:04:35 +00:00
Tim Peters 711bf30b89 Patch #1475231: add a new SKIP doctest option, thanks to
Edward Loper.
2006-04-25 03:31:36 +00:00
Andrew M. Kuchling 0a7ed8c2d3 Edits, using the new term
'context specifier' in a few places
2006-04-24 14:30:47 +00:00
Nick Coghlan 877cf234c9 Change PEP 343 related documentation to use the term context specifier instead of context object 2006-04-24 04:17:02 +00:00
Tim Peters 8dc73d2dc6 Bug #1337990: clarified that `doctest` does not support examples
requiring both expected output and an exception.

I'll backport to 2.4 next.
2006-04-24 02:03:16 +00:00
Andrew M. Kuchling d4c2177b78 Add two items 2006-04-23 21:51:10 +00:00
Andrew M. Kuchling edb575e758 Edits to the PEP 343 section 2006-04-23 21:01:04 +00:00
Skip Montanaro 9ab2f453ac it's always helpful if the example works... 2006-04-23 19:30:50 +00:00
Skip Montanaro 56a3706fcd minor tweak 2006-04-23 19:26:33 +00:00
Skip Montanaro 47767c3b17 first cut at trace module doc 2006-04-23 19:14:27 +00:00
Nick Coghlan 09b1bc39e7 Take 2 on mentioning the with statement, this time without inadvertently killing the Unicode examples 2006-04-23 16:35:19 +00:00
Nick Coghlan e0ea50bc3b Add a (very) brief mention of the with statement to the end of chapter 8 2006-04-23 16:05:04 +00:00
Nick Coghlan fee3dfc061 Update with statement documentation to use same terminology as 2.5a1 implementation 2006-04-23 15:39:16 +00:00
Nick Coghlan 5ef9d9fdb9 Update contextlib documentation to use the same terminology as the module implementation 2006-04-23 15:14:37 +00:00
Nick Coghlan 84faa85775 Add a Context Types section to parallel the Iterator Types section (uses the same terminology as the 2.5a1 implementation) 2006-04-23 15:13:32 +00:00
George Yoshida a1d3b1011e wrap SyntaxError with \exception{} 2006-04-23 09:27:10 +00:00
Greg Ward ab05edc0d1 Update optparse to Optik 1.5.1. 2006-04-23 03:47:58 +00:00
George Yoshida 51a23fe266 - add versionadded tag
- make arbitrary arguments come last
2006-04-22 15:27:14 +00:00
George Yoshida 3c134a2046 Typo fixes 2006-04-22 15:10:49 +00:00
Neal Norwitz 8694a6db0e Add libctypes as a dep 2006-04-22 06:07:46 +00:00
Andrew M. Kuchling 1da4a94719 Add Gregory K. Johnson's revised version of mailbox.py (funded by
the 2005 Summer of Code).

The revision adds a number of new mailbox classes that support adding
and removing messages; these classes also support mailbox locking and
default to using email.Message instead of rfc822.Message.

The old mailbox classes are largely left alone for backward compatibility.
The exception is the Maildir class, which was present in the old module
and now inherits from the new classes.  The Maildir class's interface
is pretty simple, though, so I think it'll be compatible with existing
code.

(The change to the NEWS file also adds a missing word to a different
news item, which unfortunately required rewrapping the line.)
2006-04-22 02:32:43 +00:00
Andrew M. Kuchling 3ccdb6ab36 Typo fixes 2006-04-22 01:51:41 +00:00
Phillip J. Eby a93ee47422 Guido wrote contextlib, not me, but thanks anyway. ;) 2006-04-21 21:53:37 +00:00
Thomas Heller 9f7e58afa7 Documentation for ctypes.
I think that 'generic operating system services' is the best category.
Note that the Doc/lib/libctypes.latex file is generated from reST sources.
You are welcome to make typo fixes, and I'll try to keep the reST sources
in sync, but markup changes would be lost - they should be fixed in the tool
that creates the latex file.
The conversion script is external/ctypes/docs/manual/mkpydoc.py.
2006-04-21 18:29:17 +00:00
George Yoshida cd84b92f08 Correct the grammar 2006-04-21 16:34:17 +00:00
George Yoshida 0d840285c7 Fix a markup.
This generated a ugly code, "P&gt;".
2006-04-21 16:21:12 +00:00
Andrew M. Kuchling e78eeb1544 Add item 2006-04-21 13:26:42 +00:00
Andrew M. Kuchling fb08e73714 Add \label to make better HTML filenames 2006-04-21 13:08:02 +00:00
Andrew M. Kuchling 42c6e2f6b2 Add two items; typographical improvement for the 'with' statement; minor edits 2006-04-21 13:01:45 +00:00
Andrew M. Kuchling ba67a8a202 Typo, grammar fixes. This file could use another proofreading pass. 2006-04-21 12:58:30 +00:00
Andrew M. Kuchling 3a7b58e9ad Add TODO item 2006-04-21 12:57:58 +00:00
Andrew M. Kuchling 84a7ee7e91 Typo fixes 2006-04-21 12:38:41 +00:00
Skip Montanaro 262fb9256b Allow pstats.Stats creator to specify an alternate to stdout. 2006-04-21 02:31:07 +00:00
Andrew M. Kuchling 3b675d299c Change a footnote to a parenthetical (in two senses) paragraph 2006-04-20 13:43:21 +00:00
Andrew M. Kuchling af015cfcbf Argh, make another markup fix 2006-04-20 13:39:40 +00:00
Andrew M. Kuchling 33432183d8 Markup fix 2006-04-20 13:38:36 +00:00
Andrew M. Kuchling 63fe9b5ae2 Add some items; add "New module" consistently; make contextlib.closing example more interesting and more correct (thanks Gustavo!); add a name 2006-04-20 13:36:06 +00:00
Skip Montanaro 94785ef142 Correct implementation and documentation of os.confstr. Add a simple test
case.  I've yet to figure out how to provoke a None return I can test.
2006-04-20 01:29:48 +00:00
Andrew M. Kuchling 6719131129 Write datetime.strptime() item; show use of @contextmanager in defining __context__ methods; minor edits; add two names 2006-04-19 12:55:39 +00:00
George Yoshida e7670a329e fix typo 2006-04-18 16:18:15 +00:00
Andrew M. Kuchling 952f196ae7 Add item 2006-04-18 12:38:19 +00:00
Martin v. Löwis bd30f52881 Patch #790710: Add breakpoint command lists in pdb. 2006-04-17 17:08:37 +00:00
George Yoshida 297bf82920 fix long option markup 2006-04-17 15:44:59 +00:00
Andrew M. Kuchling 0d660c0236 Update status of document 2006-04-17 14:01:36 +00:00
Andrew M. Kuchling f7823a341c Remove translated code hidden inside a comment environment; latex2html gets confused and includes half of it anyway 2006-04-17 14:00:31 +00:00
Andrew M. Kuchling 45bb98e8b9 Add item 2006-04-16 19:53:27 +00:00
Andrew M. Kuchling de0a23f74c Describe contextlib module. (Done for today...) 2006-04-16 18:45:11 +00:00
Andrew M. Kuchling d058d0036a Write most of the 'writing context managers' section. I'd like comments on it,
but wait for a few hours before you read it; I'm still revising it
    and will be tackling contextlib next.
Untabify
2006-04-16 18:20:05 +00:00
Andrew M. Kuchling 29b3d08604 Add an item; better crediting; fix error in SQL example; minor edits 2006-04-14 20:35:17 +00:00
Andrew M. Kuchling 8ed29143fc Typo fix 2006-04-14 20:32:36 +00:00
Martin v. Löwis 82972e7f01 Patch #702933: Undocument PyObject_NEW, PyObject_NEW_VAR,
and PyObject_DEL.
2006-04-14 15:58:03 +00:00
Andrew M. Kuchling 121c98cce1 Typo fixes 2006-04-14 12:42:09 +00:00
Andrew M. Kuchling c7095843ae Add more items 2006-04-14 12:41:19 +00:00
Andrew M. Kuchling 984bdd759e Typo fix 2006-04-14 12:07:41 +00:00
Andrew M. Kuchling 75ba244c7b Add an item and a reminder 2006-04-14 10:29:55 +00:00
Gregory P. Smith 3adc4aa2fb raise the minimum supported BerkeleyDB version to 3.3 and add notes to
news about this and a couple other recent fixes.
2006-04-13 19:19:01 +00:00
Andrew M. Kuchling 5d4cf5ecc1 Typo fix 2006-04-13 13:02:42 +00:00
Andrew M. Kuchling 3b4fb041df [Bug #1464571] Mention that generator's .gi_frame can now be None 2006-04-13 12:49:39 +00:00
Andrew M. Kuchling 6fc6976507 Add some items 2006-04-13 12:37:21 +00:00
Andrew M. Kuchling 0f1955daee Include more detail on Coverity results and add a link; minor edits 2006-04-13 12:09:08 +00:00
Andrew M. Kuchling 61434b6d51 Describe sys.subversion, Py_GetBuildInfo()
Add metadata example
2006-04-13 11:51:07 +00:00
Andrew M. Kuchling aa571c9a0a Add missing word 2006-04-13 11:40:29 +00:00
Georg Brandl 9d548374e4 Add two entries about how to actually clear a list. 2006-04-13 08:04:56 +00:00
Martin v. Löwis bb30011880 Stop claiming that Py_Finalize releases all memory.
Fixes part of #1445210.
2006-04-13 07:28:29 +00:00
Neal Norwitz 5f5a69ba9d Fix {} mismatch spotted by George Yoshida. 2006-04-13 03:41:04 +00:00
Andrew M. Kuchling b66871f1c0 Fix typography of Martin's name 2006-04-13 02:10:16 +00:00
Andrew M. Kuchling 28c5f1fa16 Write some ctypes examples 2006-04-13 02:04:42 +00:00
Andrew M. Kuchling 5f445bf3df Mention ASCII as default encoding; update TODO list; use PyCF_ONLY_AST by MvL's suggestion; typographical tidying of MvL's name 2006-04-12 18:54:00 +00:00
Andrew M. Kuchling 8872dbff99 Bump version number; rearrange introduction a bit 2006-04-12 18:52:09 +00:00
Andrew M. Kuchling 6a67e4ead4 Add PEP 243 section 2006-04-12 13:03:35 +00:00
Andrew M. Kuchling f7c6290ca4 Note C API incompatibilities 2006-04-12 12:27:50 +00:00
Andrew M. Kuchling 4e86195a99 Mention access to ASTs 2006-04-12 12:16:31 +00:00
Andrew M. Kuchling 075e0231f1 Complete the ElementTree section 2006-04-11 13:14:56 +00:00
Georg Brandl ce27a06d37 Typo fix. 2006-04-11 06:27:12 +00:00
Phillip J. Eby 678b8ecd08 Forgot to mark up a PEP reference 2006-04-11 01:15:28 +00:00
Phillip J. Eby 4703211080 Updated the warnings, linecache, inspect, traceback, site, and doctest modules
to work correctly with modules imported from zipfiles or via other PEP 302
__loader__ objects.  Tests and doc updates are included.
2006-04-11 01:07:43 +00:00
Andrew M. Kuchling 16ed521dd7 Write part of ElementTree section 2006-04-10 22:28:11 +00:00
Andrew M. Kuchling d58baf8592 Give SQLite examples 2006-04-10 21:40:16 +00:00
Martin v. Löwis 0bc2ab9a20 Patch #837242: id() for large ptr should return a long. 2006-04-10 20:28:17 +00:00
Andrew M. Kuchling 6e3a66de91 Fix a few XXX markers 2006-04-07 12:46:06 +00:00
Andrew M. Kuchling a4d651fbc8 Fix unfinished paragraph; markup fix 2006-04-06 13:24:58 +00:00
Andrew M. Kuchling 4d8cd8957a Expand the PEP 353 section; various smaller changes 2006-04-06 13:03:04 +00:00
Georg Brandl 4dce8e4e69 Bug #1464658: make clear that PyList_GetItem doesn't take negative indices. 2006-04-06 12:45:51 +00:00
Georg Brandl 729156e7de Bug #1465619: rot13 codec decodes to a Unicode string. 2006-04-06 11:25:33 +00:00
Georg Brandl caf9539b2b Bug #1465600: note encoding issue in ZipFile.write(). 2006-04-06 10:03:32 +00:00
Fred Drake 8038163ee6 revert incomplete changes committed by accident 2006-04-06 00:18:28 +00:00
Fred Drake ca30e1d5ec update URL to reflect new website 2006-04-06 00:17:08 +00:00
Andrew M. Kuchling 2cdb23ee5a Bump version number after alpha1 release 2006-04-05 13:59:01 +00:00
Andrew M. Kuchling d96a6ac544 Reference PEP 356 2006-04-04 19:17:34 +00:00
Andrew M. Kuchling c3749a9791 Add a paragraph about PEP 353; add a few more fixes 2006-04-04 19:14:41 +00:00
Andrew M. Kuchling 9c67ee08d8 Tidy up the document in preparation for 2.5alpha1. Hope I didn't break the markup... 2006-04-04 19:07:27 +00:00
Walter Dörwald f7bc5f9455 Change the example classes UnicodeReader and UnicodeWriter so
that they work with all encodings. For UnicodeReader the real
input stream is wrapped in a line iterator that reencodes the
input to UTF-8. For UnicodeWriter the UTF-8 encoded output is
written to a queue for where it is reencoded to the target
encoding and written to the real output stream.
2006-04-04 17:32:49 +00:00
David Goodger cb30f97bd3 added another example of Unicode CSV parsing; reworked the example text a bit; corrected notice in the intro and added a link to the examples 2006-04-04 03:05:44 +00:00
Matthias Klose 8e39ec78bc - Patch #360466: Replace the MD5 implementation from RSA Data Security Inc
with the implementation from http://sourceforge.net/projects/libmd5-rfc/.
2006-04-03 16:27:50 +00:00
Anthony Baxter ebed3f629b preparation for 2.5a1 2006-04-03 15:03:44 +00:00
Andrew M. Kuchling af7ee99a49 Add sections for new modules; will write tutorial later 2006-04-03 12:41:37 +00:00
Neal Norwitz 92e212f7d9 Accept keyword arguments for __import__ and doc the addition of the level param from PEP 328. 2006-04-03 04:48:37 +00:00
Georg Brandl 5f284da2d4 Document recent fdopen() change. 2006-04-02 21:18:27 +00:00
Fredrik Lundh 31fe35bdee end the sentence... 2006-04-02 07:59:55 +00:00
Fred Drake 1c0e3284f9 fix markup error 2006-04-02 03:30:06 +00:00
Andrew M. Kuchling e8058299a5 Grammar fix 2006-04-02 01:47:38 +00:00
Andrew M. Kuchling 38f85078da Write various sections; I haven't been able to check whether the TeX markup is correct 2006-04-02 01:46:32 +00:00
Fred Drake ad5177cf8d Patch #624325: urlparse.urlparse() and urlparse.urlsplit() results
now sport attributes that provide access to the parts of the result.
2006-04-01 22:14:43 +00:00
Walter Dörwald f878b8120c Make firstweekday a simple attribute instead
of hiding it behind a setter and a getter.
2006-04-01 20:40:23 +00:00
Georg Brandl cd10347b65 Fix LaTeX oversight. 2006-04-01 20:40:16 +00:00
Andrew M. Kuchling f2d712b265 Update status of this PEP 2006-04-01 10:32:13 +00:00
Georg Brandl 9cdf56318d clarify new docs on attr value entity expansion 2006-04-01 08:39:50 +00:00
Georg Brandl 7f6b67c235 patch #1462498: handle entityrefs in attribute values. 2006-04-01 08:35:18 +00:00
Walter Dörwald 48d5e508eb Bug #947906: Add classes LocaleTextCalendar and LocaleHTMLCalendar,
that output localized month and weekday names and can cope
with encodings.
2006-04-01 07:57:00 +00:00
Georg Brandl 014d29f331 Patch #1462496: typo in libsignal.tex 2006-04-01 07:42:41 +00:00
Georg Brandl 22a9dc889d Patch #1459631: documnent zlib.Decompress.flush() length parameter. 2006-04-01 07:39:41 +00:00
Georg Brandl dcfdae7d72 Bug #1460564: document that socket.fromfd() duplicates the given
file descriptor.
2006-04-01 07:33:08 +00:00
Georg Brandl e071b001ca bug #1462278: small fix in documentation of __op__ vs __rop__ methods 2006-04-01 07:23:08 +00:00
Fred Drake 23fd3d49e9 add support for the sips: scheme (identical to sip: except for scheme name) 2006-04-01 06:11:07 +00:00
Georg Brandl b88e19c1fc bug #1444104: add note about fdopen() to os.open(). 2006-03-31 19:20:13 +00:00
Georg Brandl 338ef7d2bd Bug #1445068: getpass.getpass() can now be given an explicit stream
argument to specify where to write the prompt.
2006-03-31 18:42:16 +00:00
Martin v. Löwis 22f3a6ae1c Add 2.5 libraries. 2006-03-31 16:19:18 +00:00
Georg Brandl 76a2caebed typos 2006-03-31 16:12:34 +00:00
Georg Brandl 3bf538f13d Complete markup. 2006-03-31 15:38:44 +00:00
Walter Dörwald 58917a6083 Bug #947906: An object oriented interface has been added to the calendar
module. It's possible to generate HTML calendar now and the module can be
called as a script (e.g. via ``python -mcalendar``).
2006-03-31 15:26:22 +00:00
Georg Brandl 4c974989d7 Add index entries for new-style/old-style class. 2006-03-31 15:12:16 +00:00
Georg Brandl b227bea292 object() is a function, not a base class. 2006-03-31 15:07:25 +00:00
Georg Brandl 1320cf8e61 Bug #1461610: xmlrpclib has no function "binary". 2006-03-31 14:35:10 +00:00
Walter Dörwald c44e14eba0 Fix typos. 2006-03-31 11:03:57 +00:00
Walter Dörwald a35b05ebd0 Clarify what the final argument does in
IncrementalDecoder.decode().
2006-03-31 09:15:29 +00:00
Fred Drake 7b8cf38927 improve reporting of illegal section nesting (provide location which
caused detection of the error)
2006-03-31 05:30:19 +00:00
Fred Drake 842ab70ecf fix sectioning: cannot skip section levels 2006-03-31 05:28:38 +00:00
Barry Warsaw 176014ffad SF patch #1458476 with modifications based on discussions in python-dev. This
adds the following API calls: PySet_Clear(), _PySet_Next(), and
_PySet_Update().  The latter two are considered non-public.  Tests and
documentation (for the public API) are included.
2006-03-30 22:45:35 +00:00
Phillip J. Eby 80a5d01790 Mark the upload command as new in 2.5, per Neal Norwitz's request. 2006-03-30 07:09:06 +00:00
Fred Drake 66bc4efef3 fill in refcount information for APIs first documented in Python 2.5 2006-03-30 03:04:41 +00:00
Fred Drake 3e482d9a95 merge revision 43437 from the release24-maint branch:
- update the refcount information (late, but not a bad thing to do...)
- clarify that PyGen_New() steals a reference
2006-03-30 02:58:38 +00:00
Phillip J. Eby 2e550b3dd2 Implementation for patch request #1457316: support --identity option
for setup.py "upload" command.
2006-03-30 02:12:14 +00:00
Georg Brandl 275935db8d document sys.maxint in std objects 2006-03-28 18:02:44 +00:00
Georg Brandl 7fd548f9c1 Bug #1459103: add inter-section links for strftime section. 2006-03-28 12:48:43 +00:00
Neal Norwitz d03b073e9b Add version added info for with statement and context managers 2006-03-28 05:51:02 +00:00