Commit Graph

8549 Commits

Author SHA1 Message Date
Georg Brandl bf863b17f0 Replace "Caveat" paragraphs by .. warning::s. 2007-08-15 19:06:04 +00:00
Georg Brandl 7f758c49fa Mark deprecated modules as such. 2007-08-15 18:41:25 +00:00
Georg Brandl 09a5c3e6bb Fix a wrong path in the Makefile. 2007-08-15 18:30:42 +00:00
Georg Brandl 7094a0c9a8 Don't use "?=" which seems to be a GNUism. 2007-08-15 18:02:37 +00:00
Georg Brandl 64dec73154 Add the roman.py module which docutils require. 2007-08-15 17:27:29 +00:00
Georg Brandl 87d2ccf768 Fail somewhat more gracefully when using Python < 2.5. 2007-08-15 17:25:27 +00:00
Georg Brandl 8ec7f65613 Move the 2.6 reST doc tree in place. 2007-08-15 14:28:01 +00:00
Georg Brandl f56181ff53 Delete the LaTeX doc tree. 2007-08-15 14:26:55 +00:00
Brett Cannon 2ee4128e9b Remove test.test_support.guard_warnings_filter.
test.test_support.catch_warning is more full-featured and provides the same
functionality.

Since guard_warnings_filter was added in 2.6 there is no
backwards-compatibility issues.
2007-08-14 05:51:06 +00:00
Brett Cannon 5153266d13 Clarify the docs for TransientResource. 2007-08-14 03:42:13 +00:00
Georg Brandl 9616444427 Revert the fix for #1548891, it broke backwards compatibility with arbitrary read buffers.
Fixes #1730114.
2007-08-08 13:03:41 +00:00
Georg Brandl 52c0c368b9 Bug #1769002: fix a now-wrong sentence in the tutorial. 2007-08-07 07:13:24 +00:00
Georg Brandl e7fe6c3db2 Patch #1765839: add link to https+proxy urllib2 opener. 2007-08-06 07:52:20 +00:00
Matthias Klose eb8ff67fd7 - Allow Emacs 22 for building the documentation in info format. 2007-08-02 21:33:13 +00:00
Georg Brandl 1ae6856522 try-except-finally is new in 2.5. 2007-07-29 09:11:15 +00:00
Georg Brandl 304f9ff770 Clarify PEP 343 description. 2007-07-29 08:26:10 +00:00
Georg Brandl c473149a5a tabs, newlines and crs are valid XML characters. 2007-07-26 09:36:25 +00:00
Nick Coghlan 13c25c08ca Fix an incompatibility between the -i and -m command line switches as reported on python-dev by PJE - runpy.run_module now leaves any changes it makes to the sys module intact after the function terminates 2007-07-24 13:58:28 +00:00
Georg Brandl b68c944c3c Add description for wave.setcomptype() values 2007-07-18 22:36:53 +00:00
Georg Brandl a3a4c2f411 Use "Unix" as platform name, not "UNIX". 2007-07-18 06:37:55 +00:00
Andrew M. Kuchling 6111ce3667 Typo fix 2007-07-14 20:58:21 +00:00
Georg Brandl b89c9eeb35 Clarify webbrowser.open description. 2007-07-14 17:32:41 +00:00
Georg Brandl cf3a70441d Bug #1753406: missing \versionadded for subprocess.check_call. 2007-07-14 17:12:23 +00:00
Raymond Hettinger 928713c740 Correct the docs for takewhile(). Improve the recipe for nth(). Should be backported 2007-07-13 12:09:41 +00:00
Georg Brandl 4b3ab6fcc0 Patch #1675424: Added tests for uncovered code in the zipfile module.
The KeyError raised by Zipfile.getinfo for nonexistent names now has
  a descriptive message.
2007-07-12 09:59:22 +00:00
Georg Brandl 9467bc5ad1 Bug #1637365: add subsection about "__name__ == __main__" to the
Python tutorial.
2007-07-12 09:37:49 +00:00
Georg Brandl c8011d649e Patch #1731659: improve time.strptime docs. 2007-07-12 09:06:41 +00:00
Georg Brandl 152ff5f592 Remove duplicate sentence from alarm() doc. 2007-07-02 11:54:28 +00:00
Georg Brandl 6eed49f919 Document smtp.SMTPAuthenticationError. 2007-06-30 11:01:01 +00:00
Georg Brandl a37bd0f4a9 Fix a variable name in winreg docs. 2007-06-27 14:09:56 +00:00
Georg Brandl 00a15bbe2e Bug #1742901: document None behavior of shlex.split. 2007-06-25 15:21:23 +00:00
Georg Brandl 9731eefcfc Bug #1739115: make shutil.rmtree docs clear wrt. file deletion. 2007-06-19 12:38:20 +00:00
Lars Gustäbel 072aaf7150 Added missing \versionchanged tag for the new exclude
parameter.
2007-06-18 20:05:55 +00:00
Lars Gustäbel 104490e615 Added exclude keyword argument to the TarFile.add() method. 2007-06-18 11:42:11 +00:00
Neal Norwitz 9d0476f7da Revert last change for SF #1738754, there's no print in there. 2007-06-18 02:50:15 +00:00
Neal Norwitz cc1934a297 SF #1738754, remove extra backslash in string 2007-06-18 02:46:36 +00:00
Neal Norwitz f2eb4cba1a SF #1738670, make example in doc work 2007-06-17 18:48:32 +00:00
Georg Brandl d8f77debd1 Add missing \versionadded. 2007-06-16 17:10:12 +00:00
Andrew M. Kuchling 0b4589f60d Add a word 2007-06-15 22:43:03 +00:00
Facundo Batista 3ed365be0e Added versionchanged flag to all the methods which received
a new optional timeout parameter, and a versionadded flag to
the socket.create_connection function.
2007-06-11 16:27:08 +00:00
Neal Norwitz 68a57ac411 SF #1734732, lower case the module names per PEP 8.
Will backport.
2007-06-11 05:35:10 +00:00
Thomas Heller 1605ba3a0d Fix wrong documentation, and correct the punktuation.
Closes [1700455].
2007-06-08 19:08:31 +00:00
Facundo Batista 10951d51e2 Added an optional timeout parameter to function urllib2.urlopen,
with tests in test_urllib2net.py (must have network resource
enabled to execute them). Also modified test_urllib2.py because
testing mock classes must take it into acount. Docs are also
updated.
2007-06-06 17:15:23 +00:00
Collin Winter 50b79ce8e6 Patch #1731049: make threading.py use a proper "raise" when checking internal state, rather than assert statements (which get stripped out by -O). 2007-06-06 00:17:35 +00:00
Neal Norwitz a38c7c282e Update expected birthday of 2.6 2007-06-02 18:33:53 +00:00
Neal Norwitz 03b75fa4e1 Add some spaces in the example code. 2007-05-31 04:14:22 +00:00
Georg Brandl d4e42dccf0 Fix rst markup. 2007-05-29 07:16:47 +00:00
Raymond Hettinger 1749a13532 Explain when groupby() issues a new group. 2007-05-28 05:23:22 +00:00
Lars Gustäbel a0fcb9384e Added errors argument to TarFile class that allows the user to
specify an error handling scheme for character conversion. Additional
scheme "utf-8" in read mode. Unicode input filenames are now
supported by design. The values of the pax_headers dictionary are now
limited to unicode objects.

Fixed: The prefix field is no longer used in PAX_FORMAT (in
conformance with POSIX).
Fixed: In read mode use a possible pax header size field.
Fixed: Strip trailing slashes from pax header name values.
Fixed: Give values in user-specified pax_headers precedence when
writing.

Added unicode tests. Added pax/regtype4 member to testtar.tar all
possible number fields in a pax header.

Added two chapters to the documentation about the different formats
tarfile.py supports and how unicode issues are handled.
2007-05-27 19:49:30 +00:00
Peter Astrand 81a191b351 Applied patch 1669481, slightly modified: Support close_fds on Win32 2007-05-26 22:18:20 +00:00
Walter Dörwald 5f9b6c9a1b Fix typo. 2007-05-26 21:04:13 +00:00
Vinay Sajip cf99b65932 Updated documentation for SysLogHandler (#1720726). 2007-05-25 07:06:55 +00:00
Georg Brandl c90bc75994 shlex.split() now has an optional "posix" parameter. 2007-05-24 16:49:29 +00:00
Georg Brandl a69c02ecd1 Remove the "panel" module doc file which has been ignored since 1994. 2007-05-22 14:28:17 +00:00
Neal Norwitz 6f145fce06 Document new params to HTTPSConnection 2007-05-22 06:03:36 +00:00
Georg Brandl 2134e754f2 Patch #1686487: you can now pass any mapping after '**' in function calls. 2007-05-21 20:34:16 +00:00
George Yoshida 5faa75f3c1 fix against r55474 [Remove the macfs module]
Remove "libmacfs.tex" from Makefile.deps and mac/mac.tex.
2007-05-21 04:41:21 +00:00
Andrew M. Kuchling 0f852e2740 Note removed modules 2007-05-21 00:03:15 +00:00
Brett Cannon 5e2635103c Remove the macfs module. This led to the deprecation of macostools.touched();
it completely relied on macfs and is a no-op on OS X according to code
comments.
2007-05-20 23:17:38 +00:00
Nick Coghlan c568cc162a Fix typo in example (should be backported, but my maintenance branch is woefully out of date) 2007-05-20 11:12:49 +00:00
Brett Cannon dc48b74497 Remove the rgbimg module. It has been deprecated since Python 2.5. 2007-05-20 07:09:50 +00:00
Raymond Hettinger 5a41daf096 Improvements to NamedTuple's implementation, tests, and documentation 2007-05-19 01:11:16 +00:00
Fred Drake 88d96ade59 fix argument name in documentation; match the implementation 2007-05-17 19:29:58 +00:00
Brett Cannon d75f043c33 Remove the gopherlib module. It has been raising a DeprecationWarning since
Python 2.5.

Also remove gopher support from urllib/urllib2.  As both imported gopherlib the
usage of the support would have raised a DeprecationWarning.
2007-05-16 22:42:29 +00:00
Georg Brandl f1135f30f8 Bug #1719995: don't use deprecated method in sets example. 2007-05-16 13:44:18 +00:00
Neal Norwitz 25e4461666 Remove references to stdwin which was removed long ago. 2007-05-13 20:54:19 +00:00
Neal Norwitz 7072559db9 Remove Amoeba doc which was removed in version 1.0! according to Misc/HISTORY.
Hopefully Guido won't shed a tear. :-)
2007-05-13 20:45:05 +00:00
Georg Brandl 2dd7d179de Bug #1046945: document SWIG options of distutils. 2007-05-12 21:06:41 +00:00
Georg Brandl e3e62b3783 Update DDJ link. 2007-05-11 11:43:56 +00:00
Georg Brandl c5207c8425 Patch #1714700: clarify os.linesep vs. tfiles opened in text mode.
(backport)
2007-05-11 11:04:26 +00:00
Neal Norwitz 6bf8fa66ff Deprecate os.popen* and popen2 module in favor of the subprocess module. (forgot the doc) 2007-05-11 07:13:30 +00:00
Neal Norwitz 0999a1150a Add markup for True/False. Will backport 2007-05-09 06:43:15 +00:00
Georg Brandl cc40ff831c Bug #1713535: typo in logging example. 2007-05-05 18:55:37 +00:00
Brett Cannon 229cee2d3d Deprecate BaseException.message as per PEP 352. 2007-05-05 01:34:02 +00:00
Walter Dörwald 27f4abf3b1 Clarify the behaviour of PyUnicode_DecodeUTF16(): A BOM is only skipped
in native order mode, and only if it's the first two bytes.
2007-05-03 15:13:55 +00:00
Vinay Sajip c0a293c692 Added documentation for new optional credentials argument to SMTPHandler.__init__(). 2007-05-01 10:21:45 +00:00
Georg Brandl 5a006b3978 Bug #1710295: exceptions are now new-style classes. 2007-05-01 06:04:11 +00:00
Georg Brandl 58ef8cd29c Version fix (bug #1708710) 2007-04-27 19:20:00 +00:00
Steve Holden 6e6eaa7a67 Minor wording change on slicing aide-memoire. 2007-04-26 14:23:12 +00:00
Fred Drake 452f5df64a fix some markup errors 2007-04-26 04:42:19 +00:00
Collin Winter c2898c5a67 Standardize on test.test_support.run_unittest() (as opposed to a mix of run_unittest() and run_suite()). Also, add functionality to run_unittest() that admits usage of unittest.TestLoader.loadTestsFromModule(). 2007-04-25 17:29:52 +00:00
Georg Brandl e47c508850 Markup fix. 2007-04-25 06:25:55 +00:00
Georg Brandl 3dc6e90a2e Patch #1698768: updated the "using Python on the Mac" intro. 2007-04-25 06:24:59 +00:00
Raymond Hettinger e133a95d1c Fix markup 2007-04-24 22:13:43 +00:00
Georg Brandl 18afb37845 Bug #1705717: error in sys.argv docs. 2007-04-24 15:10:09 +00:00
Georg Brandl 556697e412 Some new year updates. 2007-04-24 10:36:42 +00:00
Neal Norwitz 8eea9ac889 Fix SF #1703110, Incorrect example for add_password() (use uri, not host) 2007-04-24 04:53:12 +00:00
Raymond Hettinger 4db5fe970c SF 1193128: Let str.translate(None) be an identity transformation 2007-04-12 04:10:00 +00:00
Georg Brandl 5176180610 Repair missing spaces after \UNIX. 2007-04-11 23:28:44 +00:00
Andrew M. Kuchling 5bf02cd17f Describe undocumented third argument to touchline() 2007-04-11 13:47:13 +00:00
Andrew M. Kuchling 400a49ba79 Add window.chgat() method, submitted via e-mail by Fabian Kreutz 2007-04-11 13:39:00 +00:00
Georg Brandl 781aef2d6b Repair a duplicate label and some obsolete uses of \setindexsubitem. 2007-04-10 21:39:38 +00:00
Brett Cannon 55a1864832 Doc that file.next() has undefined behaviour when called on a file opened with
'w'.  Closes bug #1569057.

To be backported once 2.5 branch is unfrozen.
2007-04-08 04:29:32 +00:00
Andrew M. Kuchling 615b49b097 Some grammar fixes 2007-04-06 01:11:58 +00:00
Facundo Batista c3a35e19cc Now using unittest for the tests infraestructure. Also split the
tests in those who need the network, and that who doesn't.
2007-04-03 14:05:08 +00:00
Georg Brandl b28ef9b429 Fix the strange case of
\begin{methoddesc}[NNTP]{...}

where

\ifx#1\@undefined ended up comparing N and N, therefore executing
the true part of the conditional, blowing up at \@undefined.
2007-04-03 07:04:27 +00:00
Raymond Hettinger 9e56d5beeb SF #1382213: Tutorial section 9.5.1 ignores MRO for new-style classes 2007-04-03 01:39:43 +00:00
Georg Brandl 5447850f6f Fix the class name of strings. 2007-04-01 23:31:30 +00:00
Georg Brandl 5f4c580776 Remove bogus entry. 2007-04-01 23:29:10 +00:00
Georg Brandl 30d6c04696 Some semantic fixes. 2007-04-01 22:47:31 +00:00
Georg Brandl 6ec04ffc5d Explicit class names. 2007-04-01 22:40:12 +00:00
Georg Brandl ae91afdcfb Lots of explicit class names for method and member descs. 2007-04-01 22:39:10 +00:00
Georg Brandl b8e8df2e63 Another fix. 2007-04-01 21:39:52 +00:00
Georg Brandl 4e9165d2dd Fix a lot of markup and meta-information glitches. 2007-04-01 21:29:15 +00:00
Georg Brandl 43445315ae Typo fix. 2007-03-31 11:59:54 +00:00
Georg Brandl dc580bd821 Duplicate label fix. 2007-03-31 11:58:36 +00:00
Georg Brandl 5201364de5 Markup fix. 2007-03-31 11:54:58 +00:00
Georg Brandl b8b88743a8 repair string literal. 2007-03-31 10:17:31 +00:00
Georg Brandl 8c09b14978 Markup fix. 2007-03-30 19:14:02 +00:00
Georg Brandl 92a9fc0a2f Duplicate label fix. 2007-03-30 19:01:38 +00:00
Andrew M. Kuchling 588a95d594 Add item. (Oops, accidentally checked this in on my branch) 2007-03-30 18:00:15 +00:00
Georg Brandl f3c123d82d Markup fix. 2007-03-30 17:48:39 +00:00
Georg Brandl bc7d71a8fd Duplicate label fix. 2007-03-30 17:47:21 +00:00
Georg Brandl 749757329a Label name fix. 2007-03-30 17:39:39 +00:00
Georg Brandl 459ef66f6e Markup fix. 2007-03-30 15:49:05 +00:00
Collin Winter d4a0118029 Bug #1688274: add documentation for C-level class objects. 2007-03-30 14:01:25 +00:00
Facundo Batista 93c33680a0 Added the posibility to pass the timeout to FTP.connect, not only when
instantiating the class. Docs and tests are updated.
2007-03-30 13:00:35 +00:00
Facundo Batista b6a5c9d605 Added timout parameter to telnetlib.Telnet. Also created
test_telnetlib.py with a basic test and timeout ones.
Docs are also updated.
2007-03-29 18:22:35 +00:00
Georg Brandl 9499b7117a These are actually methods. 2007-03-29 07:41:32 +00:00
Facundo Batista 366d6262f8 Added timeout to smtplib (to SMTP and SMTP_SSL). Also created
the test_smtplib.py file, with a basic test and the timeout
ones. Docs are updated too.
2007-03-28 18:25:54 +00:00
Facundo Batista 1b1c347311 Added an optional timeout to poplib.POP3. Also created a
test_poplib.py file with a basic test and the timeout
ones. Docs are also updated.
2007-03-27 18:23:21 +00:00
Georg Brandl f03facfe90 Some nits. 2007-03-26 20:28:28 +00:00
Facundo Batista 51b7abc519 Added an optional timeout to FTP class. Also I started a test_ftplib.py
file to test the ftp lib (right now I included a basic test, the timeout
one, and nothing else).
2007-03-26 20:18:31 +00:00
Georg Brandl 85fd7ac93d Markup fix. 2007-03-25 19:04:55 +00:00
Georg Brandl 6b5e1aa167 Markup fix. 2007-03-25 18:44:35 +00:00
Brett Cannon 27ef61ca18 Change the docs to no longer claim that unittest is preferred over doctest for
regression tests.
2007-03-25 01:32:36 +00:00
Georg Brandl 3d52e5f07d Revert accidental change. 2007-03-24 22:27:56 +00:00
Georg Brandl b881b9aacf Remove typo accent. 2007-03-24 22:20:34 +00:00
Žiga Seilnacht c64ad484a9 Patch #1489771: update syntax rules in Python Reference Manual.
Python 2.5 added support for explicit relative import statements and
yield expressions, which were missing in the manual.
Also fix grammar productions that used the names from the Grammar file,
markup that broke the generated grammar.txt, and wrap some lines that
broke the pdf output.  Will backport.
2007-03-24 14:24:26 +00:00
Facundo Batista 07c78be0b4 Added a 'create_connect()' function to socket.py, which creates a
connection with an optional timeout, and modified httplib.py to
use this function in HTTPConnection. Applies patch 1676823.
2007-03-23 18:54:07 +00:00
Martin v. Löwis 2f401d7186 Patch #1686451: Fix return type for PySequence_{Count,Index,Fast_GET_SIZE}.
Will backport.
2007-03-23 10:35:49 +00:00
Georg Brandl bfcc975527 Bug #1685704: use -m switch in timeit docs. 2007-03-22 08:05:45 +00:00
Facundo Batista 3ff9e55890 Minor clarification, saying that blocking means no timeout (from bug #882297) 2007-03-21 19:41:24 +00:00
Andrew M. Kuchling 4732c6e164 Put code examples at left margin instead of indenting them 2007-03-21 16:59:20 +00:00
Andrew M. Kuchling 7af1bdf619 Fix sentence, and fix typo in example 2007-03-21 16:57:32 +00:00
Andrew M. Kuchling 8aa30927ab Add comments on maintenance of this file 2007-03-21 14:32:43 +00:00
Georg Brandl 5e0b865b0f Patch #1684834: document some utility C API functions. 2007-03-21 09:16:53 +00:00
Georg Brandl cae9f3d916 New test for rev. 54407 which only uses directories under TESTFN. 2007-03-21 09:10:29 +00:00
Neal Norwitz c990f6454f Try backing out 54407 to see if it corrects the problems on the Windows
buildbots.  This rev was backported, so we will need to keep both branches
in sync, pending the outcome of the test after this checkin.
2007-03-20 05:23:09 +00:00
Neal Norwitz 216f9b0709 Add a comment about 3k migration 2007-03-20 05:08:23 +00:00
Neal Norwitz b9523df1e6 Add some doc that was left out from some change to platform.py 2007-03-20 05:07:28 +00:00
Collin Winter a8785cc26a Patch #1630118: add a SpooledTemporaryFile class to tempfile. 2007-03-19 18:52:08 +00:00
Georg Brandl 1d4b834574 Patch #1682878: the new socket methods are recv_into and recvfrom_into, not *_buf. 2007-03-18 08:25:00 +00:00
Georg Brandl 2b869943fa Patch #1675423: PyComplex_AsCComplex() now tries to convert an object
to complex using its __complex__() method before falling back to the
__float__() method. Therefore, the functions in the cmath module now
can operate on objects that define a __complex__() method.
 (backport)
2007-03-17 16:08:45 +00:00
Collin Winter 6f187743ff Patch 1339796: add a relpath() function to os.path. 2007-03-16 22:16:08 +00:00
Žiga Seilnacht 594965d17a Whitespace cleanup. Also remove the empty lines
from the previous check in.
2007-03-16 12:11:11 +00:00
Žiga Seilnacht 6f2d09c949 Patch #1623563: allow __class__ assignment for classes with __slots__.
The old and the new class are still required to have the same slot
names, but the order in which they are specified is not relevant.
2007-03-16 11:59:38 +00:00
Georg Brandl 6ab8452036 RFE #1670167: fix in isinstance() docs. 2007-03-16 08:33:47 +00:00
Georg Brandl 5a80ff6111 Add \versionadded tag. 2007-03-16 08:24:21 +00:00
Georg Brandl 8844e438b1 Patch #1273829: os.walk() now has a "followlinks" parameter. If set to
True (which is not the default), it visits symlinks pointing to
directories.
2007-03-16 08:22:40 +00:00