Commit Graph

8539 Commits

Author SHA1 Message Date
Georg Brandl 9856e05d56 Document new shorthand notation for index entries. 2007-08-31 06:59:27 +00:00
Lars Gustäbel 89241a3889 Warn about possible risks when extracting untrusted archives. 2007-08-30 20:24:31 +00:00
Mark Summerfield 7f626f4c34 Added more cross-references. 2007-08-30 15:03:03 +00:00
Georg Brandl f11ed159f3 Stronger urge to convert filenames to str before using them as argument to ZipFile.write(). 2007-08-30 10:09:42 +00:00
Bill Janssen 426ea0a864 This contains a number of things:
1) Improve the documentation of the SSL module, with a fuller
   explanation of certificate usage, another reference, proper
   formatting of this and that.

2) Fix Windows bug in ssl.py, and general bug in sslsocket.close().
   Remove some unused code from ssl.py.  Allow accept() to be called on
   sslsocket sockets.

3) Use try-except-else in import of ssl in socket.py.  Deprecate use of
   socket.ssl().

4) Remove use of socket.ssl() in every library module, except for
   test_socket_ssl.py and test_ssl.py.
2007-08-29 22:35:05 +00:00
Walter Dörwald f0d1c1f3ec Fix title endtag in HTMLCalender.formatyearpage(). Fix documentation for
HTMLCalender.formatyearpage() (there's no themonth parameter).

This fixes issue1046.
2007-08-28 16:38:26 +00:00
Georg Brandl 23b8ddc110 Fix some glitches. 2007-08-28 10:48:18 +00:00
Sean Reifscheider 99cafb99ed Adding basic imputil documentation. 2007-08-28 09:07:54 +00:00
Georg Brandl ae0ee8a473 Document rev. 57574. 2007-08-28 08:29:08 +00:00
Guido van Rossum 8ee23bbe7c Patch 10124 by Bill Janssen, docs for the new ssl code. 2007-08-27 19:11:11 +00:00
Neal Norwitz 9a65c89ec0 Spell check (also americanify behaviour, it's almost 3 times as common) 2007-08-26 01:42:03 +00:00
Guido van Rossum 4f2c3ddca4 Server-side SSL and certificate validation, by Bill Janssen.
While cleaning up Bill's C style, I may have cleaned up some code
he didn't touch as well (in _ssl.c).
2007-08-25 15:08:43 +00:00
Nick Coghlan 3af0e785e7 Revert misguided attempt at fixing incompatibility between -m and -i switches (better fix coming soon) 2007-08-25 04:32:07 +00:00
Georg Brandl d558f67d5d Document new utility functions in test_support. 2007-08-24 18:27:43 +00:00
Georg Brandl b3c572ba51 Fix #1012: wrong URL to :mod:`site` in install/index.rst. 2007-08-24 17:46:54 +00:00
Georg Brandl 94bda3a586 Bug #1011: fix rfc822.Message.getheader docs. 2007-08-24 17:23:23 +00:00
Georg Brandl 3761422749 Bug #1758696: more info about descriptors. 2007-08-23 21:42:54 +00:00
Georg Brandl 604c121eee Bug #1625381: clarify match vs search introduction. 2007-08-23 21:36:05 +00:00
Georg Brandl b7a837d81b Bug #1734111: document struct.Struct.size. 2007-08-23 21:21:36 +00:00
Georg Brandl 4ad9b8206c Bug #1752332: httplib no longer uses socket.getaddrinfo(). 2007-08-23 21:18:44 +00:00
Georg Brandl a3a68a0db4 Clarify wording a bit. 2007-08-23 20:55:44 +00:00
Georg Brandl 154cc588d3 Bug #1594966: fix misleading usage example 2007-08-23 20:53:28 +00:00
Georg Brandl 3e0f735ce1 Bug #1694833: fix imp.find_module() docs wrt. packages. 2007-08-23 20:50:23 +00:00
Georg Brandl 891f1d339b Bug #1573854: fix docs for sqlite3 cursor rowcount attr. 2007-08-23 20:40:01 +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 7cf40799ef Bug #1766421: "return code" vs. "status code". 2007-08-23 17:57:05 +00:00
Georg Brandl 4debd55874 Bug #1768121: fix wrong/missing opcode docs. 2007-08-23 17:54:11 +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
Georg Brandl fdca6d8599 Demand version 2.5.1 since 2.5 has a bug with codecs.open context managers. 2007-08-21 06:01:18 +00:00
Georg Brandl c553f42907 Fix stray backticks. 2007-08-19 18:43:50 +00:00
Georg Brandl 3f8fbf0589 Fix PDB command descriptions. 2007-08-18 06:05:56 +00:00
Brett Cannon ea424b5a28 Clarify the comment about setting the PYTHON variable for the Doc Makefile. 2007-08-17 18:51:57 +00:00
Georg Brandl 6c82b6c5ca Use glossary x-refs, document new ``!`` feature. 2007-08-17 16:54:59 +00:00
Walter Dörwald 6e39080649 Backport r57105 and r57145 from the py3k branch: UTF-32 codecs. 2007-08-17 16:41:28 +00:00
Georg Brandl 437e6a3b15 Move the glossary from the tutorial to toplevel.
Prepare for cross-linking with the new .. glossary:: directive.
2007-08-17 06:27:11 +00:00
Georg Brandl 690b97c005 Note that smtplib example needs a mailserver. 2007-08-17 05:58:36 +00:00
Georg Brandl ee354b1e96 Fix problem reported by Andre Roberge. 2007-08-17 05:52:24 +00:00
Matthias Klose f0e291870b - mark the findCaller 2-element tuple/3-element tuple change as new in 2.4 2007-08-16 12:03:44 +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 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