Commit Graph

7761 Commits

Author SHA1 Message Date
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
Phillip J. Eby 168e99f6db Document objects that can be used with the ``with`` statement. 2006-03-28 00:13:10 +00:00
Phillip J. Eby bdfd693804 Fix some missing imports 2006-03-28 00:08:22 +00:00
Phillip J. Eby d207b4f376 Document the contextlib module. 2006-03-27 23:58:46 +00:00
Georg Brandl b6e92c40a9 Document change made to number of preallocated integers. 2006-03-27 22:09:16 +00:00
Phillip J. Eby 16e86da730 The "with" statement needs a __future__. :) 2006-03-27 21:42:30 +00:00
Phillip J. Eby 075ef1ac1b Document the "with" statement. 2006-03-27 21:06:13 +00:00
Phillip J. Eby 5d0f4c6193 Document the PEP 343 context manager protocol methods. 2006-03-27 19:59:34 +00:00
Raymond Hettinger a531e5b84c Guarantee evaluation order for izip(). Document its creative uses and its limitations. 2006-03-26 01:41:25 +00:00
Raymond Hettinger 4d65af0807 Add section headers and examples. 2006-03-25 23:26:43 +00:00
Neal Norwitz 6a91e94e66 SF bug # 1457358 and patch # 1458419, floor division not documented. Patch by Andy.
Will backport.
2006-03-25 21:25:30 +00:00
Phillip J. Eby 1a9fac0937 Yield is now allowed in try-finally, so update docs accordingly 2006-03-25 00:46:43 +00:00
Raymond Hettinger fd3fcf0b35 SF Patch #1455676: Simplify using Queues with daemon consumer threads
Adds join() and task_done() methods to track when all enqueued tasks have
been gotten and fully processed by daemon consumer threads.
2006-03-24 20:43:29 +00:00
Nick Coghlan 98bcb70815 Add documentation for PEP 338 2006-03-24 13:36:33 +00:00
Georg Brandl bb03ac0dae Correct API design mistake from rev. 43126: make socket attributes readonly properties. 2006-03-21 18:17:25 +00:00
Georg Brandl 48b4bf7b1a Add a note about pow(x,y) equalling x**y (the "**" operator
was used unmotivated in the pow() docs)
2006-03-21 08:48:04 +00:00
Raymond Hettinger 66760f87b5 Show an example of calling a named set method. 2006-03-20 18:35:55 +00:00
Neal Norwitz 05a45599d7 Patch #1309579: wait3 and wait4 were added to the posix module by Chad J. Schroeder.
This was a fair amount of rework of the patch.  Refactored test_fork1 so it
could be reused by the new tests for wait3/4.  Also made them into new style
unittests (derive from unittest.TestCase).
2006-03-20 06:30:08 +00:00
Anthony Baxter fa86907aae SF [ 1231053 ] audioop - alaw encoding/decoding added, code updated
This patch adds a-LAW encoding to audioop and replaces the old
u-LAW encoding/decoding code with the current code from sox.

Possible issues: the code from sox uses int16_t.

Code by Lars Immisch
2006-03-20 05:21:58 +00:00
Georg Brandl 8a85ac660b Update tutorial wrt PEP 341 try-except-finally statement 2006-03-19 11:20:29 +00:00
Barry Warsaw 40ef0067ad Merge email package 4.0 from the sandbox, including documentation, test cases,
and NEWS updates.
2006-03-18 15:41:53 +00:00
Andrew M. Kuchling 237037beb5 You need at least one \item 2006-03-17 22:25:15 +00:00
Andrew M. Kuchling b182db44f2 Write section 2006-03-17 21:48:46 +00:00
Georg Brandl bc45a3f821 RFE #567972: Socket objects' family, type and proto properties are
now exposed via new get...() methods.
2006-03-17 19:17:34 +00:00
Georg Brandl a5a0704942 Remove the lib-old modules from Doc/lib/libundoc.tex.
Now only Modules/timingmodule.c is left. Should that be removed, too?
(dito for clmodule and svmodule)
2006-03-17 18:47:14 +00:00
Georg Brandl db815abc70 More \exception fixes. 2006-03-17 16:26:31 +00:00
Andrew M. Kuchling da37604ee3 Add two items 2006-03-17 15:56:41 +00:00
Andrew M. Kuchling a0622709fd Markup fix 2006-03-17 15:56:13 +00:00
Andrew M. Kuchling f4b066084a Remove mention of lib-old, and list more deleted modules 2006-03-17 15:39:52 +00:00
Andrew M. Kuchling 01e3d262ce Add some items 2006-03-17 15:38:39 +00:00
Neal Norwitz 6bed1c1fab Add some versionadded info to new incremental codec docs and fix doco nits. 2006-03-16 07:49:19 +00:00
Neal Norwitz 10be10cbe7 Remove regsub, reconvert, regex, regex_syntax and everything under lib-old. 2006-03-16 06:50:13 +00:00
Andrew M. Kuchling 21d3a7cd2e Add section 2006-03-15 11:53:09 +00:00
Walter Dörwald abb02e5994 Patch #1436130: codecs.lookup() now returns a CodecInfo object (a subclass
of tuple) that provides incremental decoders and encoders (a way to use
stateful codecs without the stream API). Functions
codecs.getincrementaldecoder() and codecs.getincrementalencoder() have
been added.
2006-03-15 11:35:15 +00:00
Andrew M. Kuchling f688cc574c Unicode database updated; use SVN instead of CVS 2006-03-10 18:50:08 +00:00
Martin v. Löwis 5bd7c02298 Avoid forward-declaring the methods array.
Rename unicodedata.db* to unicodedata.ucd*
2006-03-10 11:20:04 +00:00
Martin v. Löwis 480f1bb67b Update Unicode database to Unicode 4.1. 2006-03-09 23:38:20 +00:00
Andrew M. Kuchling aeadf95449 Write a section 2006-03-09 19:06:05 +00:00
Andrew M. Kuchling d0fcc0256b Markup fix 2006-03-09 13:57:28 +00:00
Andrew M. Kuchling e362d93367 Write a section 2006-03-09 13:56:25 +00:00
Georg Brandl 8f4b4db676 typo 2006-03-09 10:16:42 +00:00
Georg Brandl ddb73febef Bug #1445901: os.path.realpath() is available on Win/Mac too. 2006-03-08 20:59:09 +00:00
Georg Brandl 533ff6fc06 Patch #1434038: property() now uses the getter's docstring if there is
no "doc" argument given. This makes it possible to legitimately use
property() as a decorator to produce a read-only property.
2006-03-08 18:09:27 +00:00
Neal Norwitz 025f14b72d Move version added tag from PyObject_Length/Size to PyNumber_Index. 2006-03-08 05:29:18 +00:00
Andrew M. Kuchling 8f4d255b67 Add section 2006-03-08 01:50:20 +00:00
Andrew M. Kuchling 437567ca7b Some edits; add empty sections 2006-03-07 20:48:55 +00:00
Guido van Rossum 38fff8c4e4 Checking in the code for PEP 357.
This was mostly written by Travis Oliphant.
I've inspected it all; Neal Norwitz and MvL have also looked at it
(in an earlier incarnation).
2006-03-07 18:50:55 +00:00
Georg Brandl 58780d2642 Bug #1440831: fix csv UnicodeWriter example 2006-03-07 13:47:22 +00:00
Barry Warsaw d3c38ff7f8 SF patch #1443865; gc.get_count() added and optional argument 'generation'
added to gc.collect().  Updated docs, unit test, and NEWS entry.

(Also, fixed a typo in NEWS.)
2006-03-07 09:46:03 +00:00
Neal Norwitz 0917988f7c Fix SF #1442937, Bad Coroutine link 2006-03-04 23:31:45 +00:00
Neal Norwitz 7356dcb705 SF #1442767, docs for os.statvfs miss f_bsize parameter. Will backport. 2006-03-03 23:11:42 +00:00
Brett Cannon 3096c53eaa Fix latex typos as spotted by George Yoshida. 2006-03-02 03:52:06 +00:00
Martin v. Löwis 49c5da1d88 Patch #1440601: Add col_offset attribute to AST nodes. 2006-03-01 22:49:05 +00:00
Brett Cannon 54ac29497e Document PEP 352 changes. Also added GeneratorExit. 2006-03-01 22:10:49 +00:00
Martin v. Löwis c9066cafba Fix warning that texcheck complained about. 2006-03-01 16:37:55 +00:00
Fredrik Lundh 1f2dac5766 markup glitch (spotted by George Yoshida) 2006-03-01 12:43:53 +00:00
Martin v. Löwis 3b19754079 Document new Py_ssize_t API. 2006-03-01 05:47:11 +00:00
Martin v. Löwis 497114e027 Add tool to check documentation against declaration. 2006-03-01 05:18:07 +00:00
Martin v. Löwis 29fafd8708 Make documentation match the implementation. 2006-03-01 05:16:03 +00:00
Neal Norwitz 77e42fff31 George Yoshida points out that the special characters
from Tools/compiler/ast.txt are not used anywhere else in asttable.txt.
So remove "\&".
2006-02-28 17:46:48 +00:00
Fredrik Lundh d3188639c3 markup glitch (spotted by George Yoshida) 2006-02-28 12:11:57 +00:00
Anthony Baxter d615110949 XXX something for amk's attention 2006-02-28 07:21:42 +00:00
Martin v. Löwis 40d8459dbf Add generation of the version. 2006-02-28 00:30:54 +00:00
Guido van Rossum c2e20744b2 PEP 343 -- the with-statement.
This was started by Mike Bland and completed by Guido
(with help from Neal).

This still needs a __future__ statement added;
Thomas is working on Michael's patch for that aspect.

There's a small amount of code cleanup and refactoring
in ast.c, compile.c and ceval.c (I fixed the lltrace
behavior when EXT_POP is used -- however I had to make
lltrace a static global).
2006-02-27 22:32:47 +00:00
Neal Norwitz f9f61b4aa2 Note version added for conditional expressions 2006-02-27 16:31:12 +00:00
Martin v. Löwis 577b5b960d Create _ast module.
Cleanup Python-ast.c generation.
2006-02-27 15:23:19 +00:00
Thomas Wouters dca3b9c797 PEP 308 implementation, including minor refdocs and some testcases. It
breaks the parser module, because it adds the if/else construct as well as
two new grammar rules for backward compatibility. If no one else fixes
parsermodule, I guess I'll go ahead and fix it later this week.

The TeX code was checked with texcheck.py, but not rendered. There is
actually a slight incompatibility:

>>> (x for x in lambda:0)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: iteration over non-sequence

changes into

>>> (x for x in lambda: 0)
  File "<stdin>", line 1
    (x for x in lambda: 0)
                     ^
SyntaxError: invalid syntax

Since there's no way the former version can be useful, it's probably a
bugfix ;)
2006-02-27 00:24:13 +00:00
Guido van Rossum 1968ad32cd - Patch 1433928:
- The copy module now "copies" function objects (as atomic objects).
  - dict.__getitem__ now looks for a __missing__ hook before raising
    KeyError.
  - Added a new type, defaultdict, to the collections module.
    This uses the new __missing__ hook behavior added to dict (see above).
2006-02-25 22:38:04 +00:00
Georg Brandl b518d8c7d7 Fix casing of function names. 2006-02-22 11:46:55 +00:00
Neal Norwitz e51fc53b6a George Yoshida's fix. 2006-02-22 05:51:48 +00:00
Georg Brandl 7d42d3cd59 fix typo 2006-02-21 20:41:29 +00:00
Georg Brandl 868e704e27 Document "multifile" as deprecated. 2006-02-21 19:23:49 +00:00
Tim Peters d34350e47e At Brian Wichmann's request, added words warning against
using the old Wichmann-Hill generator,  Also pointed to
a newer version of his generator, and weakened the claim
about what jumpahead() does now.

Note sure I got the LaTeX entirely correct for \seeurl.
If it's broken, please fix it ;-)

Bugfix candidate!  (These changes make just as much
sense for 2.4.)
2006-02-21 19:19:00 +00:00
Walter Dörwald b075fcea3a Fix table header. 2006-02-21 18:51:32 +00:00
Tim Peters 4d0bd0b32c Trimmed trailing whitespace. 2006-02-21 18:48:34 +00:00
Georg Brandl 124a4e58c4 Bug #947571: By default, urllib.urlopen() does not raise IOErrors
on server error codes. Make this clear.
2006-02-20 21:26:18 +00:00
Georg Brandl 69774c212a Bug #1102649: add a note to pickle docs that pickle files should be
opened in binary mode.
2006-02-20 13:12:02 +00:00
Georg Brandl 9b743f514c Bug #1013800: document PyFunction_* functions 2006-02-20 12:57:53 +00:00
Georg Brandl 71322121d7 Bug #1323369: document possible values of sys.getwindowsversion()
platform field
2006-02-20 12:15:23 +00:00
Georg Brandl 8f7c54eaa5 Bug #1413790: zipfile now sanitizes absolute archive names that are
not allowed by the specs.
2006-02-20 08:40:38 +00:00
Thomas Wouters 6302a5a9b0 Fix typpo. 2006-02-19 20:08:18 +00:00
Neal Norwitz 87f2875252 Minor tweaks 2006-02-19 19:18:18 +00:00
Georg Brandl c3e950cbf3 Clarify how hook_compressed determines how to open a file. 2006-02-19 15:20:29 +00:00
Georg Brandl c98eeede17 Patch #1215184: FileInput now can be given an opening hook which can
be used to control how files are opened.
2006-02-19 14:57:47 +00:00
Georg Brandl c029f873cb Patch #1212287: fileinput.input() now has a mode parameter for
specifying the file mode input files should be opened with.
2006-02-19 14:12:34 +00:00
Georg Brandl 67e9fb9d7a Patch #1215184: fileinput now has a fileno() function for getting the
current file number.
2006-02-19 13:56:17 +00:00
Georg Brandl 602b9ba6b3 Patch #1349274: gettext.install() now optionally installs additional
translation functions other than _() in the builtin namespace.
2006-02-19 13:26:36 +00:00
Georg Brandl 1dc5a84aee Bug #801349: document that start/stop/step slice arguments can be None 2006-02-19 00:12:42 +00:00
Georg Brandl 4caeff9867 Patch #1415507: clarify docs on reference stealing 2006-02-18 22:55:59 +00:00
Georg Brandl f4f4415a18 Patch #1393157: os.startfile() now has an optional argument to specify
a "command verb" to invoke on the file.
2006-02-18 22:29:33 +00:00
Georg Brandl 6aab16e9f6 Move "httpresponses" dict from urllib2 to httplib where it belongs. 2006-02-17 19:17:25 +00:00
Georg Brandl 5d076961e2 Patch #1417555: SimpleHTTPServer now returns Last-Modified headers. 2006-02-17 13:34:16 +00:00
Georg Brandl bcd548bdb2 Update "undocumented modules" section. 2006-02-17 11:51:41 +00:00
Georg Brandl b56230b30d Add deprecation notices to modules deprecated since 2000. 2006-02-17 11:18:58 +00:00
Georg Brandl 1b6726732c Bug #1432350: arrayobject should use PyObject_VAR_HEAD 2006-02-17 08:56:33 +00:00
Thomas Wouters bbdf6078f6 Fix broken example of csv.reader use (it returns an iterator, which isn't
indexable) by using the same 'for' construct as all other examples. (Also
emphasizes that reading from a random iterable is no different than reading
from a file.)
2006-02-16 14:57:05 +00:00
Vinay Sajip 55aafab04f Added some more versionchanged markup. 2006-02-15 21:47:32 +00:00
Fred Drake 4482929734 use correct function in example 2006-02-15 06:55:57 +00:00
Neal Norwitz c16dd48ee1 Doc some user visible changes 2006-02-13 02:04:37 +00:00
Georg Brandl 8ed1ca8fe1 Even more copyright year locations! 2006-02-11 18:22:59 +00:00
Georg Brandl b69406dc09 Update general copyright years to 2006. 2006-02-11 15:30:36 +00:00
Vinay Sajip b4549c4a7e Added information on function name added to LogRecord, and the 'extra' keyword parameter. 2006-02-09 08:54:11 +00:00
Armin Rigo a871ef2b3e Added the cProfile module.
Based on lsprof (patch #1212837) by Brett Rosen and Ted Czotter.
With further editing by Michael Hudson and myself.
History in svn repo: http://codespeak.net/svn/user/arigo/hack/misc/lsprof

* Module/_lsprof.c is the internal C module, Lib/cProfile.py a wrapper.
* pstats.py updated to display cProfile's caller/callee timings if available.
* setup.py and NEWS updated.
* documentation updates in the profiler section:
   - explain the differences between the three profilers that we have now
   - profile and cProfile can use a unified documentation, like (c)Pickle
   - mention that hotshot is "for specialized usage" now
   - removed references to the "old profiler" that no longer exists
* test updates:
   - extended test_profile to cover delicate cases like recursion
   - added tests for the caller/callee displays
   - added test_cProfile, performing the same tests for cProfile
* TO-DO:
   - cProfile gives a nicer name to built-in, particularly built-in methods,
     which could be backported to profile.
   - not tested on Windows recently!
2006-02-08 12:53:56 +00:00
Andrew M. Kuchling 5eefdca654 Update projected release date 2006-02-08 11:36:09 +00:00