Commit Graph

8653 Commits

Author SHA1 Message Date
Andrew M. Kuchling 6edff59e3b Add items 2007-10-16 22:58:03 +00:00
Raymond Hettinger abfd8dff3b More docs, error messages, and tests 2007-10-16 21:28:32 +00:00
Georg Brandl 5fbf663703 Fix email example. 2007-10-13 13:20:03 +00:00
Raymond Hettinger 68995867d5 Accept Jim Jewett's api suggestion to use None instead of -1 to indicate unbounded deques. 2007-10-10 00:26:46 +00:00
Andrew M. Kuchling 4b3074c795 Eliminate camelcase function name 2007-10-08 23:23:03 +00:00
Raymond Hettinger a48a29947a Eliminate camelcase function name 2007-10-08 21:26:58 +00:00
Georg Brandl 814b04600c #1199: docs for tp_as_{number,sequence,mapping}, by Amaury Forgeot d'Arc.
No need to merge this to py3k!
2007-10-08 14:12:47 +00:00
Raymond Hettinger b6893f2bf8 Missed a line in the docs 2007-10-08 09:56:29 +00:00
Raymond Hettinger 2115bbc4da Add comments to NamedTuple code.
Let the field spec be either a string or a non-string sequence (suggested by Martin Blais with use cases).
Improve the error message in the case of a SyntaxError (caused by a duplicate field name).
2007-10-08 09:14:28 +00:00
Georg Brandl 16fd6c4617 #1123: fix the docs for the str.split(None, sep) case.
Also expand a few other methods' docs, which had more info in the deprecated string module docs.
2007-10-08 07:50:24 +00:00
Fred Drake 06f8067acf move descriptions of ac_(in|out)_buffer_size to the right place
http://bugs.python.org/issue1053
2007-10-05 02:48:32 +00:00
Raymond Hettinger a7fc4b13e0 Add __asdict__() to NamedTuple and refine the docs.
Add maxlen support to deque() and fixup docs.
Partially fix __reduce__().  The None as a third arg was no longer supported.
Still needs work on __reduce__() to handle recursive inputs.
2007-10-05 02:47:07 +00:00
Fred Drake c9b7163da5 wrap lines to <80 characters before fixing errors 2007-10-05 02:46:12 +00:00
Raymond Hettinger 50e90e265f itertools.count() no longer limited to sys.maxint. 2007-10-04 00:20:27 +00:00
Mark Summerfield d92e871ad8 Added note in footnote about string comparisons about
unicodedata.normalize().
2007-10-03 08:53:21 +00:00
Georg Brandl ba2e519082 #1208: document match object's boolean value. 2007-09-27 06:26:58 +00:00
Andrew M. Kuchling 99479ebf9e Add various items 2007-09-25 00:09:42 +00:00
Andrew M. Kuchling 6d407e4d3d Typo fix 2007-09-24 23:46:28 +00:00
Andrew M. Kuchling 9c90635bcb Remove stray odd character; grammar fix 2007-09-24 23:45:51 +00:00
Georg Brandl e4186252b1 #1196: document default radix for int(). 2007-09-24 17:59:28 +00:00
Georg Brandl 97ca58370a Fix typo and double word. 2007-09-24 17:55:47 +00:00
Georg Brandl 4a21268a74 Patch #1181: add os.environ.clear() method. 2007-09-20 17:57:59 +00:00
Georg Brandl efa7d51ee6 #1176: document that string methods don't take keyword args. 2007-09-20 16:45:27 +00:00
Georg Brandl 5d242eef74 alternate -> alternative. 2007-09-20 08:44:59 +00:00
Raymond Hettinger 7268e9d1ff Fit nits 2007-09-20 03:03:43 +00:00
Sean Reifscheider 111c0ea34a issue1172: Documentation of "done" attribute in cgi module. 2007-09-18 23:34:44 +00:00
Raymond Hettinger cbab5949c9 Cleanup docs for NamedTuple. 2007-09-18 22:18:02 +00:00
Georg Brandl 745e48dffa A bit of reordering, also show more subheadings in the lang ref index. 2007-09-18 07:24:40 +00:00
Raymond Hettinger 2b03d45bb9 Handle corner cased on 0-tuples and 1-tuples. Add verbose option so people can see how it works. 2007-09-18 03:33:19 +00:00
Andrew M. Kuchling de37a8cec7 Add item; sort properly 2007-09-18 01:36:16 +00:00
Raymond Hettinger d36a60e1e3 Sync-up named tuples with the latest version of the ASPN recipe.
Allows optional commas in the field-name spec (help when named tuples are used in conjuction with sql queries).
Adds the __fields__ attribute for introspection and to support conversion to dictionary form.
Adds a  __replace__() method similar to str.replace() but using a named field as a target.
Clean-up spelling and presentation in doc-strings.
2007-09-17 00:55:00 +00:00
Bill Janssen 296a59d3be Add support for asyncore server-side SSL support. This requires
adding the 'makefile' method to ssl.SSLSocket, and importing the
requisite fakefile class from socket.py, and making the appropriate
changes to it to make it use the SSL connection.

Added sample HTTPS server to test_ssl.py, and test that uses it.

Change SSL tests to use https://svn.python.org/, instead of
www.sf.net and pop.gmail.com.

Added utility function to ssl module, get_server_certificate,
to wrap up the several things to be done to pull a certificate
from a remote server.
2007-09-16 22:06:00 +00:00
Georg Brandl 7e84c7f4b5 Remove bdb from the "undocumented modules" list. 2007-09-15 16:53:36 +00:00
Facundo Batista e90bc3c81c Some additions (examples and a bit on the tutorial). 2007-09-14 21:29:52 +00:00
Facundo Batista 7c82a3e9c6 Included the new functions, and new descriptions. 2007-09-14 18:58:34 +00:00
Andrew M. Kuchling 1338fbfe59 Make target unique 2007-09-13 22:50:10 +00:00
Andrew M. Kuchling f10878b74c Add various items 2007-09-13 22:49:34 +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 5a25fcd585 Fix #1139: PyFile_Encoding really is PyFile_SetEncoding. 2007-09-12 18:10:56 +00:00
Georg Brandl 9c478bd850 Fix #1122: wrong return type documented for various _Size() functions. 2007-09-12 18:08:33 +00:00
Georg Brandl bb07a7df91 Bug #1152: use non-deprecated name in example. 2007-09-12 18:05:57 +00:00
Georg Brandl 0001422a0a New documentation page for the bdb module.
(This doesn't need to be merged to Py3k.)
2007-09-12 18:03:51 +00:00
Bill Janssen 93bf9ce9b7 Fix some documentation bugs. 2007-09-11 02:42:07 +00:00
Bill Janssen 98d19dafd9 More work on SSL support.
* Much expanded test suite:

  All protocols tested against all other protocols.
  All protocols tested with all certificate options.
  Tests for bad key and bad cert.
  Test of STARTTLS functionality.
  Test of RAND_* functions.

* Fixes for threading/malloc bug.

* Issue 1065 fixed:

  sslsocket class renamed to SSLSocket.
  sslerror class renamed to SSLError.
  Function "wrap_socket" now used to wrap an existing socket.

* Issue 1583946 finally fixed:

  Support for subjectAltName added.
  Subject name now returned as proper DN list of RDNs.

* SSLError exported from socket as "sslerror".

* RAND_* functions properly exported from ssl.py.

* Documentation improved:

  Example of how to create a self-signed certificate.
  Better indexing.
2007-09-10 21:51:02 +00:00
Martin v. Löwis 3994240b6c Allow making update with no prior checkout. 2007-09-10 13:19:10 +00:00
Gregory P. Smith e9fef694b4 Change socket.error to inherit from IOError rather than being a stand
alone class.  This addresses the primary concern in

 http://bugs.python.org/issue1706815

python-dev discussion here:

 http://mail.python.org/pipermail/python-dev/2007-July/073749.html

I chose IOError rather than EnvironmentError as the base class since
socket objects are often used as transparent duck typed file objects
in code already prepared to deal with IOError exceptions.

also a minor fix:

 urllib2 - fix a couple places where IOError was raised rather than URLError.
           for better or worse, URLError already inherits from IOError so
           this won't break any existing code.

 test_urllib2net - replace bad ftp urls.
2007-09-09 23:36:46 +00:00
Georg Brandl 8360d5de7e Fix a wrong indentation for sublists. 2007-09-07 14:14:40 +00:00
Thomas Heller 2825b2ea44 Add a 'c_longdouble' type to the ctypes module. 2007-09-07 06:32:17 +00:00
Thomas Heller a3a7ddaae5 Fix typo: c_float represents to C float type. 2007-09-06 20:26:20 +00:00
Georg Brandl ecabc37b08 Backport from 3k: #1116: fix reference to old filename. 2007-09-06 14:49:56 +00:00
Georg Brandl 5768d577d3 Backport from Py3k: Bug #1684991: explain lookup semantics for __special__ methods (new-style classes only). 2007-09-05 13:36:44 +00:00
Bill Janssen ffe576dc78 SSL certificate distinguished names should be represented by tuples 2007-09-05 00:46:27 +00:00
Martin v. Löwis 58bd49f5fe Patch #1388440: Add set_completion_display_matches_hook and
get_completion_type to readline.
2007-09-04 13:13:14 +00:00
Mark Summerfield fcb444a8bf Added cross-references plus a note about dict & list shallow copying. 2007-09-04 08:16:15 +00:00
Andrew M. Kuchling b4c629566c Add more items 2007-09-01 21:18:31 +00:00
Andrew M. Kuchling 364b841683 Wording change 2007-09-01 21:17:58 +00:00
Andrew M. Kuchling 6c066dd3ad Add various items 2007-09-01 20:43:36 +00:00
Andrew M. Kuchling 24e99c43c6 Markup fix 2007-09-01 20:31:59 +00:00
Walter Dörwald 73f83d2bc6 Fix typo. 2007-09-01 18:34:05 +00:00
Walter Dörwald 90014e0a3c Fix wrong function names. 2007-09-01 18:18:09 +00:00
Skip Montanaro 222907da56 Added a note and examples to explain that re.split does not split on an
empty pattern match. (issue 852532).
2007-09-01 17:40:03 +00:00
Georg Brandl 847cae6743 Document sets' ">" and "<" operations (backport from py3k). 2007-09-01 15:49:49 +00:00
Georg Brandl 95b571a084 Fix RST link (backport from Py3k). 2007-09-01 07:51:24 +00:00
Georg Brandl 3acd6d5f58 Fix subitem markup. 2007-08-31 08:47:51 +00:00
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