Commit Graph

1941 Commits

Author SHA1 Message Date
Éric Araujo 713d3039dc Fix usage of :option: in the docs (#9312).
:option: is used to create a link to an option of python, not to mark
up any instance of any arbitrary command-line option.  These were
changed to ````.

For modules which do have a command-line interface, lists of options
have been properly marked up with the program/cmdoption directives
combo.  Options defined in such blocks can be linked to with :option:
later in the same file, they won’t link to an option of python.

Finally, the markup of command-line fragments in optparse.rst has
been cleaned to use ``x`` instead of ``"x"``, keeping that latter
form for actual Python strings.

Patch by Eli Bendersky and Éric Araujo.
2010-11-18 16:38:46 +00:00
Éric Araujo b10089edba Remove spurious space that was breaking Vim’s reST highlighting. 2010-11-18 14:22:08 +00:00
Kristján Valur Jónsson 6331520950 Issue 10260
Adding the wait_for() method to threading.Condition
2010-11-18 12:46:39 +00:00
Alexander Belopolsky a47bbf5a4b Issue #10446: Several changes to module documentation generated by pydoc:
1. Online reference manual link is now version-specific and the
   'MODULE DOCS' section renamed to 'MODULE REFERENCE'.

2. 'FILE' section is moved to the end of the file.

3. Special names processed by pydoc such as __version__ or __credits__
   are now excluded from the DATA section.

4. Defined __all__ to prevent pydoc from exposing undocumented details
   about itself.

5. Removed Python 2.3 compatibility code.
2010-11-18 01:52:54 +00:00
Antoine Pitrou 664c2d1fc0 Issue #10443: Add the SSLContext.set_default_verify_paths() method. 2010-11-17 20:29:42 +00:00
Antoine Pitrou b6d4ee5361 Issue #10440: Support RUSAGE_THREAD as a constant in the resource module.
Patch by Robert Collins.
2010-11-17 16:19:35 +00:00
Éric Araujo 6e6cb8e0e4 Provide links to Python source where the code is short, readable and
informative adjunct to the docs.  Forward-port of Raymond's r86225 and
r86245 using the new source reST role added in #10334.
2010-11-16 19:13:50 +00:00
Vinay Sajip 8593ae6451 Logging: added stack_info argument. 2010-11-14 21:33:04 +00:00
Fred Drake 5a7c11f92f fix copy-editing level nits 2010-11-13 05:24:17 +00:00
Antoine Pitrou f3b001f966 Issue #4471: Add the IMAP.starttls() method to enable encryption on
standard IMAP4 connections.  Original patch by Lorenzo M. Catucci.
2010-11-12 18:49:16 +00:00
Georg Brandl 40d23e81dc Fix weird line block in table. 2010-11-12 08:09:26 +00:00
Georg Brandl 5e92a50ac0 #10008: Fix duplicate index entry. 2010-11-12 06:20:12 +00:00
R. David Murray c7399d0a0f #7950: add warning about security implications of shell=True to subprocess docs
Patch by Chris Rebert.
2010-11-12 00:35:31 +00:00
R. David Murray 6495136e40 #1466065: add validate option to base64.b64decode
Patch by Neil Tallim.  This provides a mechanism for module
users to achieve RFC 3548 compliance in the cases where ignoring
non-base64-alphabet input characters is *not* mandated by the RFC that
references RFC 3548.
2010-11-11 20:09:20 +00:00
Georg Brandl bb27c128a5 Review the new configparser docs. 2010-11-11 07:26:40 +00:00
Łukasz Langa 26d513cf2f Issue #5412: extend configparser to support mapping access 2010-11-10 18:57:39 +00:00
Ask Solem ff7ffdd752 Issue #8028: multiprocessing: Documented that ``Process.terminate``
is only intented for use by the parent process.
2010-11-09 21:52:33 +00:00
Ask Solem 518eaa8a76 Issue #7707: Documented that multiprocessing.Queue operations during
import can lead to deadlocks.
2010-11-09 21:46:03 +00:00
Ask Solem 1d3b89397b Documented the new error_callback keyword argument to multiprocessing.Pool's apply_async and map_async 2010-11-09 21:36:56 +00:00
Antoine Pitrou fb0469112f Issue #10022: The dictionary returned by the `getpeercert()` method
of SSL sockets now has additional items such as `issuer` and `notBefore`.
2010-11-09 20:21:19 +00:00
Antoine Pitrou 859c4ef0a0 Make `usenetrc` False by default (the old behaviour of having it True by
default could be rather confusing).
2010-11-09 18:58:42 +00:00
Antoine Pitrou 1cb121ecea Issue #1926: Add support for NNTP over SSL on port 563, as well as
STARTTLS.  Patch by Andrew Vant.
2010-11-09 18:54:37 +00:00
Alexander Belopolsky 14fb79977b Issue #7061: Added a 'Turtle star' sidebar 2010-11-09 18:40:03 +00:00
Alexander Belopolsky e1f849c7d2 Fixed a typo in ReST markup. 2010-11-09 03:13:43 +00:00
Victor Stinner 58c0752a33 Issue #10335: Add tokenize.open(), detect the file encoding using
tokenize.detect_encoding() and open it in read only mode.
2010-11-09 01:08:59 +00:00
R. David Murray 7dff9e08fb #10321: Add support for sending binary DATA and Message objects to smtplib 2010-11-08 17:15:13 +00:00
Georg Brandl 49d474195f Fix typo. 2010-11-08 11:08:35 +00:00
Georg Brandl facfb15bb9 Fix latex conversion glitch in property/feature descriptions. 2010-11-08 11:05:18 +00:00
Victor Stinner e14e212221 Fix encode/decode method doc of str, bytes, bytearray types
* Specify the default encoding: write 'utf-8' instead of
   sys.getdefaultencoding(), because the default encoding is now constant
 * Specify the default errors value
2010-11-07 18:41:46 +00:00
Senthil Kumaran 7089a4e127 Fix Issue10226 - Clarifying the role of the netloc separator. 2010-11-07 12:57:04 +00:00
Mark Dickinson 4a3c7c4ecf Issue #10145: the float.is_integer method was undocumented. 2010-11-07 12:48:18 +00:00
Mark Dickinson 43ef32ae36 Issue 10297: Add missing import in decimal example snippet. 2010-11-07 11:24:44 +00:00
Eric Smith 5ad85f81b0 Added example for str.format_map(). 2010-11-06 13:22:13 +00:00
Éric Araujo 1cb25aa2e3 Tweak example to make clear the argument is a boolean, not any integer.
With Raymond’s approval.
2010-11-06 07:03:07 +00:00
Éric Araujo c6ecb012da Fix wrapper/wrapped typo (with Raymond’s blessing) 2010-11-06 06:33:03 +00:00
Éric Araujo 8f9626b08b Fix typo 2010-11-06 06:30:16 +00:00
Éric Araujo 2642ad07ee Fix typo from r86170. 2010-11-06 04:59:27 +00:00
Antoine Pitrou a078115434 Issue #10282: Add a `nntp_implementation` attribute to NNTP objects. 2010-11-05 19:16:37 +00:00
Ezio Melotti 4841fd60fb Merge the doc for assertTrue/False, assert[Not]AlmostEqual, assert[Not]RegexpMatches, rephrase a couple of paragraphs, and remove redundant doc about the msg arg. 2010-11-05 15:43:40 +00:00
Antoine Pitrou 08eeadac27 Issue #10283: Add a `group_pattern` argument to NNTP.list(). 2010-11-04 21:36:15 +00:00
Ezio Melotti 8f2e07b7d0 Move the deprecated aliases in a new section. 2010-11-04 19:09:28 +00:00
Eric Smith 27bbca6f79 Issue #6081: Add str.format_map. str.format_map(mapping) is similar to str.format(**mapping), except mapping does not get converted to a dict. 2010-11-04 17:06:58 +00:00
Ezio Melotti 9794a26de9 Merge the doc for assertIs[Not], assertIs[Not]None, and assert[Not]IsInstance. 2010-11-04 14:52:13 +00:00
Raymond Hettinger fd15191b92 Demote one warning to a note. There's no security risk here, just a note on usage and avialability. 2010-11-04 03:02:56 +00:00
Raymond Hettinger f4477703a5 Put warning block in the main flow of text. 2010-11-04 02:39:07 +00:00
Phillip J. Eby b6d4a8e4de Implement http://bugs.python.org/issue10155 using And Clover's patch, w/added
docs and support for more client-generated CGI variables.  (This should
complete the WSGI 1.0.1 compliance changes for Python 3.x.)
2010-11-03 22:39:01 +00:00
Ezio Melotti 327433f864 Divide the context manager signature from the normal one for consistency with the other methods. 2010-11-03 20:51:17 +00:00
Ezio Melotti 9c02c2ffa2 Minor cleanups to unittest doc. 2010-11-03 20:45:31 +00:00
Ezio Melotti 4370b30139 List the assert* methods in tables in unittest doc. 2010-11-03 20:39:14 +00:00
Antoine Pitrou 7dd1af00ad Issue #10285: explain the `flag` return field better in NNTP.list().
Patch by Julien Élie.
2010-11-03 18:32:54 +00:00
Antoine Pitrou 4103bc09a4 Issue #10281: nntplib now returns None for absent fields in the OVER/XOVER
response, instead of raising an exception.
2010-11-03 18:18:43 +00:00
Phillip J. Eby a01799f71a Update docs (and sample app in wsgiref.simple_server) to reflect PEP 3333. 2010-11-03 00:46:45 +00:00
Michael Foord 7a26cb9772 Updating unittest docs to reflect change in unittest.TestCase.assert[Not]AlmostEqual signature change 2010-11-02 14:27:10 +00:00
Martin v. Löwis 16f344df36 Issue #10184: Touch directories only once when extracting a tarfile. 2010-11-01 21:39:13 +00:00
Alexander Belopolsky ea13d9d86b Issue #10199: Moved Demo/turtle under Lib/ 2010-11-01 17:39:37 +00:00
Alexander Belopolsky 6509599056 Issue #7061: Simplified a section title. 2010-11-01 15:45:34 +00:00
Raymond Hettinger b373799e05 Issue 7447: Improve docs for sum(). 2010-10-31 21:23:24 +00:00
Antoine Pitrou e974571d36 Issue #10160: Speed up operator.attrgetter. Patch by Christos Georgiou. 2010-10-31 15:26:04 +00:00
Vinay Sajip c5b273011b Added style argument to logging.basicConfig() and documented this change. 2010-10-31 14:59:16 +00:00
Raymond Hettinger b643ef8f8e Issue #5729: json.dumps to support using '\t' as an indent string 2010-10-31 08:00:16 +00:00
Alexander Belopolsky a9615d14de Issues #7061, #10225: Fixed doctests in turtle manual 2010-10-31 00:51:11 +00:00
Georg Brandl 6ce29fa7a8 Fix test_mailbox by supporting context manager protocol for get_file() returns. 2010-10-30 14:33:28 +00:00
Alexander Belopolsky 3cdfb12360 Issue 7061: Explained 'gon' 2010-10-29 17:16:49 +00:00
Lars Gustäbel 9cbdd75ec5 Add read support for all missing variants of the GNU sparse
extensions. Thus, in addition to GNUTYPE_SPARSE headers, sparse
information in pax headers created by GNU tar can now be decoded.
All three formats 0.0, 0.1 and 1.0 are supported.
On filesystems that support this, holes in files are now restored
whenever a sparse member is extracted.
2010-10-29 09:08:19 +00:00
Georg Brandl 3122ce3e5d (?:...) is a non-capturing, but still grouping construct. 2010-10-29 06:17:38 +00:00
Georg Brandl 5c66bcaa1a Fix markup error and update false positive entries from "make suspicious". 2010-10-29 05:36:28 +00:00
Georg Brandl b98273fff9 Re-add "debugger" label, it is used in pydoc-topics. 2010-10-29 05:24:24 +00:00
Georg Brandl 30176890d0 send_bytes obviously needs bytes... 2010-10-29 05:22:17 +00:00
Georg Brandl 5bc168600a Review new Barrier docs. 2010-10-28 13:07:50 +00:00
Kristján Valur Jónsson 3be00037d6 issue 8777
Add threading.Barrier
2010-10-28 09:43:10 +00:00
Georg Brandl b9a4391754 #10218: return timeout status from Condition.wait, mirroring other primitives' behavior. 2010-10-28 09:03:20 +00:00
Georg Brandl 4d54088599 #7351: add more consistent exception name alias. 2010-10-28 06:42:33 +00:00
Georg Brandl 7424dd359c #5975: add unix_dialect to csv module. 2010-10-27 07:27:06 +00:00
Alexander Belopolsky f0a0d14c28 Issue #7061: Dropped "for Tk" from turtle module title and moved its
doc section under frameworks.  Also fixed a couple of markup issues
that affected TOC rendering.
2010-10-27 03:06:43 +00:00
Georg Brandl 599dbfca2f #10200: typo. 2010-10-26 19:58:11 +00:00
Georg Brandl 70cd7bc748 #10200: typo. 2010-10-26 19:31:06 +00:00
Georg Brandl 19208900f4 Markup fix. 2010-10-26 06:59:23 +00:00
Vinay Sajip a39c571061 logging: Added style option to Formatter to allow %, {} or himBHformatting. 2010-10-25 13:57:39 +00:00
Georg Brandl 2062937aff Add documentation about the default warnings filters. 2010-10-24 15:16:02 +00:00
Georg Brandl 08be72d0aa Add a new warning gategory, ResourceWarning, as discussed on python-dev. It is silent by default,
except when configured --with-pydebug.

Emit this warning from the GC shutdown procedure, rather than just printing to stderr.
2010-10-24 15:11:22 +00:00
Georg Brandl 872a702bbd Fix style. 2010-10-24 14:32:45 +00:00
Nick Coghlan 543af75961 Issue 5178: Add tempfile.TemporaryDirectory (original patch by Neil Schemenauer) 2010-10-24 11:23:25 +00:00
R. David Murray 8451c4b6e0 #1349106: add linesep argument to generator.flatten and header.encode. 2010-10-23 22:19:56 +00:00
Georg Brandl 1e908af335 #6518: enable context manager protocol for ossaudiodev types. 2010-10-23 17:31:52 +00:00
Antoine Pitrou d532321f7b Issue #5639: Add a *server_hostname* argument to `SSLContext.wrap_socket`
in order to support the TLS SNI extension.  `HTTPSConnection` and
`urlopen()` also use this argument, so that HTTPS virtual hosts are now
supported.
2010-10-22 18:19:07 +00:00
Alexander Belopolsky c08f544844 Fixed a typo 2010-10-21 22:29:36 +00:00
Alexander Belopolsky 41f56f0192 Issue #7061: Fixed section title 2010-10-21 18:15:39 +00:00
Antoine Pitrou 9583cac633 Issue #10089: Add support for arbitrary -X options on the command-line.
They can be retrieved through a new attribute `sys._xoptions`.
2010-10-21 13:42:28 +00:00
Vinay Sajip 05ed69590b logging: Improved StreamHandler documentation. 2010-10-20 20:34:09 +00:00
Vinay Sajip 22246fdd9d logging: clarified Filter documentation. 2010-10-20 11:40:02 +00:00
R. David Murray f19076e592 Correct signature of BytesGenerator in docs. 2010-10-19 23:05:35 +00:00
Vinay Sajip fc082cafa6 logging: Documented usage of callables as filters. 2010-10-19 21:13:49 +00:00
Alexander Belopolsky 435d306aa9 Issue #7061: Fixed some of the issues in turtle module documentation
reported by Terry J. Reedy.
2010-10-19 21:07:52 +00:00
Georg Brandl f285bcca28 Be consistent in the spelling of thread-safe(ty). 2010-10-19 21:07:16 +00:00
Georg Brandl 7004bd1a3d #10092: Properly reset locale in Locale*Calendar classes. The context manager was buggy because setlocale() returns the *new* locale, not the old. Also add a test for this. 2010-10-19 18:54:25 +00:00
R. David Murray 7cefc30d34 Tighten up 'byte string' wording in base64 docs. 2010-10-17 23:12:16 +00:00
R. David Murray a90032a3fb #1343: Add short_empty_elements option to XMLGenerator.
Patch and tests by Neil Muller.
2010-10-17 22:46:45 +00:00
Georg Brandl 134c35b191 #9730: fix example. 2010-10-17 11:36:28 +00:00
Georg Brandl 2379877246 Fix documentation of dis.opmap direction. 2010-10-17 11:29:07 +00:00
Georg Brandl c16e8f17ac Make twisted example a bit more logical. 2010-10-17 11:23:56 +00:00
Georg Brandl c8148265dc Port changes to pickle docs apparently lost in py3k. 2010-10-17 11:13:37 +00:00
Georg Brandl 8527126f85 #9237: document sys.call_tracing(). 2010-10-17 11:06:14 +00:00
Georg Brandl 6f4e68d82c #5962: clarify sys.exit() vs. threads. 2010-10-17 10:51:45 +00:00
Georg Brandl e0bf91d597 Some markup and style fixes in argparse docs. 2010-10-17 10:34:28 +00:00
Georg Brandl 9375492be3 #9112: document error() and exit() methods of ArgumentParser. 2010-10-17 10:28:04 +00:00
Georg Brandl 0036bcf8d8 #9105: move pickle warning to a bit more prominent location. 2010-10-17 10:24:54 +00:00
Georg Brandl 047e486c45 Remove second parser module example; it referred to non-readily-available example files, and this kind of discovery is much better done with the AST nowadays anyway. 2010-10-17 10:22:28 +00:00
Georg Brandl 531d76b096 #5212: md5 weaknesses do not affect hmac, so remove the note about that. 2010-10-17 10:09:06 +00:00
Georg Brandl f3d008737e Fix copy-paste error in example. 2010-10-17 10:07:29 +00:00
Georg Brandl eec2d768cd #8968: add actual name of token constants. 2010-10-17 09:46:11 +00:00
Georg Brandl 80b75fd288 Fix hmac docs: it takes and returns bytes, except for hexdigest(). 2010-10-17 09:43:35 +00:00
Georg Brandl 7716ca6cdd #8855: add shelve security warning. 2010-10-17 09:37:54 +00:00
Georg Brandl 96115fb2d3 #8811: small fixes to sqlite3 docs. 2010-10-17 09:33:24 +00:00
Georg Brandl 8e9eb95c40 #8686: remove potentially confusing wording that does not add any value. 2010-10-17 09:23:05 +00:00
Georg Brandl edc9e7ff17 #8556: use less confusing mapping key in example. 2010-10-17 09:19:03 +00:00
Georg Brandl 17ef0d51d7 Note that maxtasksperchild is new in 3.2. 2010-10-17 06:21:59 +00:00
Georg Brandl 8e4ddcfaea #10122: typo fix. 2010-10-16 18:51:05 +00:00
Barry Warsaw a40453df37 abiflags: alphabetize and versionadded 2010-10-16 14:17:50 +00:00
Barry Warsaw 8cf4eae522 First (uncontroversial) part of issue 9807.
* Expose the build flags to Python as sys.abiflags
* Shared library libpythonX.Y<abiflags>.so
* python-config --abiflags
* Make two distutils tests that failed with --enable-shared (even before this
  patch) succeed.
* Fix a few small style issues.
2010-10-16 01:04:07 +00:00
Georg Brandl 392c92a0c6 #10072: assume a bit less knowledge of the FTP protocol in the ftplib docs. 2010-10-15 19:46:19 +00:00
Georg Brandl d4460aaacd #4785: document strict argument of JSONDecoder, plus add object_pairs_hook in the docstrings. 2010-10-15 17:03:02 +00:00
Georg Brandl b67878a522 #7790: move table of struct_time members to the actual description of struct_time. 2010-10-15 17:01:15 +00:00
Georg Brandl 39cadc3ffe #4968: updates to inspect.is* function docs. 2010-10-15 16:53:24 +00:00
Georg Brandl d0b0e1d869 #6798: fix wrong docs for the arguments to several trace events. 2010-10-15 16:42:37 +00:00
Georg Brandl f1f8d47d38 #7303: add documentation for useful pkgutil functions and classes. 2010-10-15 16:35:46 +00:00
Georg Brandl 3ed4114f7d #9801: document how list and dict proxies created by Managers behave w.r.t. mutable items. 2010-10-15 16:19:43 +00:00
Georg Brandl c1c4bf85c1 #9683: remove broken dead code dealing with nested arguments removed from Py3k, and update the docs and docstrings accordingly. 2010-10-15 16:07:41 +00:00
Georg Brandl f74cf77c8d #7771: reference to documentation of dictview methods and operations. 2010-10-15 16:03:02 +00:00
Georg Brandl 1f7fffb308 #2830: add html.escape() helper and move cgi.escape() uses in the standard library to it. It defaults to quote=True and also escapes single quotes, which makes casual use safer. The cgi.escape() interface is not touched, but emits a (silent) PendingDeprecationWarning. 2010-10-15 15:57:45 +00:00
Senthil Kumaran 279b56d9a7 Fix a minor docs bug. 2010-10-15 15:21:19 +00:00
Georg Brandl b4dac71a87 #5355: Provide mappings from Expat error numbers to string descriptions and backwards, in order to actually make it possible to analyze error codes provided by ExpatError. 2010-10-15 14:46:48 +00:00
Senthil Kumaran 8227045bbe Fix sphinx role markups. 2010-10-15 13:29:33 +00:00
Senthil Kumaran 46a48bef3f Fix ``make check`` warnings. 2010-10-15 13:10:10 +00:00
Senthil Kumaran 916bd38a06 Fixing some sphinx inline directives - detected using ``make check``. 2010-10-15 12:55:19 +00:00
Senthil Kumaran d449a8ad87 Issue10100 - fromfd is now available on all platforms 2010-10-15 09:02:14 +00:00
Antoine Pitrou b1c5496738 Issue #7523: Add SOCK_CLOEXEC and SOCK_NONBLOCK to the socket module,
where supported by the system.  Patch by Nikita Vetoshkin.
2010-10-14 15:05:38 +00:00
Senthil Kumaran 383c32dd38 Issue10063 - file:// scheme will stop accessing remote hosts via ftp protocol 2010-10-14 11:57:35 +00:00
Georg Brandl 268e4d4cf3 #1710703: write zipfile structures also in the case of closing a new, but empty, archive. 2010-10-14 06:59:45 +00:00
Georg Brandl 539c165299 #6825: small correction to split() docs. 2010-10-14 06:46:08 +00:00
Georg Brandl 7c4cad51ba #10046: small correction to atexit docs. 2010-10-14 06:43:22 +00:00
Georg Brandl 4eb6597b62 #3865: add note about benchmarking with profilers, and move licensing stuff to bottom of document. 2010-10-14 06:41:42 +00:00
Georg Brandl 8f7b427b5b #7642: update to os.system() docs. 2010-10-14 06:35:53 +00:00
Antoine Pitrou 834bd81c51 Issue #10041: The signature of optional arguments in socket.makefile()
didn't match that of io.open(), and they also didn't get forwarded
properly to TextIOWrapper in text mode.  Patch by Kai Zhu.
2010-10-13 16:17:14 +00:00
Antoine Pitrou 1ab19ca161 Fix grammar 2010-10-13 10:39:21 +00:00
Antoine Pitrou 803e6d670c Issue #9003: http.client.HTTPSConnection, urllib.request.HTTPSHandler and
urllib.request.urlopen now take optional arguments to allow for
server certificate checking, as recommended in public uses of HTTPS.
2010-10-13 10:36:15 +00:00
Benjamin Peterson 73a3f2d4d4 fix spelling #10078 2010-10-12 23:07:13 +00:00
Antoine Pitrou b0182c8ca5 Issue #10075: Add a session_stats() method to SSLContext objects. 2010-10-12 20:09:02 +00:00
Antoine Pitrou 0518842b69 Make comment about SSL support more accurate 2010-10-12 16:44:39 +00:00
Senthil Kumaran 79941b5c09 Fix Issue7285 - multiprocessing module, example code error. 2010-10-10 06:13:49 +00:00
Raymond Hettinger 2f08df3690 Issue #10029: Fix sample code in the docs for zip(). 2010-10-10 05:54:39 +00:00
Victor Stinner 62165d67a2 Document that the 'strict' error handler is used to encode/decode filenames on
Windows
2010-10-09 10:34:37 +00:00
Benjamin Peterson fc8408cbe8 remove author names from prose 2010-10-09 01:58:37 +00:00
R. David Murray 7c0a2271ff What's new entry for email 5.1. 2010-10-08 21:37:39 +00:00
R. David Murray 96fd54eaec #4661: add bytes parsing and generation to email (email version bump to 5.1.0)
The work on this is not 100% complete, but everything is present to
allow real-world testing of the code.  The only remaining major todo
item is to (hopefully!) enhance the handling of non-ASCII bytes in headers
converted to unicode by RFC2047 encoding them rather than replacing them with
'?'s.
2010-10-08 15:55:28 +00:00
Antoine Pitrou 59fdd6736b Issue #1589: Add ssl.match_hostname(), to help implement server identity
verification for higher-level protocols.
2010-10-08 10:37:08 +00:00
Georg Brandl 682d7e0e07 Fix errors found by "make suspicious". 2010-10-06 10:26:05 +00:00
Georg Brandl 60203b41b0 Migrate to Sphinx 1.0 C language constructs. 2010-10-06 10:11:56 +00:00
Georg Brandl 64a41edb03 Copyedit of os.symlink() docs. 2010-10-06 08:52:48 +00:00
Georg Brandl a102ae3426 #10034: import readline in longer example. 2010-10-06 05:08:32 +00:00
Senthil Kumaran c08d9070db fix a typo. 2010-10-05 18:46:56 +00:00
Senthil Kumaran 242690f870 Remove the references of FTPS from the urllib Documentation. There is no support for it yet. 2010-10-05 18:35:41 +00:00
Georg Brandl eeed95538e Indent version tags properly. 2010-10-05 07:16:01 +00:00
Antoine Pitrou 7b998e9f52 GzipFile.peek improvements, suggested by Nir Aides. 2010-10-04 21:55:14 +00:00
Giampaolo Rodolà 977c707b42 Fix issue 6706: adds new handle_accepted() method to asyncore.dispatcher 2010-10-04 21:08:36 +00:00
Gerhard Häring e0941c5bd2 Fixes #10020 2010-10-03 21:47:06 +00:00
Senthil Kumaran 7cafd2644a Fix - issue10010 .. index:: position in the docs. 2010-10-02 03:16:04 +00:00
Amaury Forgeot d'Arc ea8676bf8b Lower the tone of the warning about SSL certificate validation. 2010-10-01 23:42:24 +00:00
Senthil Kumaran 0f476d49f8 Issue1491 - BaseHTTPServer incorrectly implements response code 100 2010-09-30 06:09:18 +00:00
Antoine Pitrou 69ab95105f Issue #9360: Cleanup and improvements to the nntplib module. The API
now conforms to the philosophy of bytes and unicode separation in Python 3.
A test suite has also been added.
2010-09-29 15:03:40 +00:00
Antoine Pitrou 79ecd7621e Issue #9983: warn that urllib and httplib don't perform SSL certificate validation. 2010-09-29 11:24:21 +00:00
Antoine Pitrou c3ed2e7f83 Issue #9962: GzipFile now has the peek() method. 2010-09-29 10:49:46 +00:00
Brian Curtin 1771b54bed Implement #8521. Added named argument handling to winreg's CreateKeyEx,
DeleteKeyEx, and OpenKeyEx.

Note that CKE and DKE are new functions for 3.2 so I didn't give them a
versionchanged because of the existing versionadded. OpenKeyEx already
existed so it gets a versionchanged tag.
2010-09-27 17:56:36 +00:00
Vinay Sajip 76ca3b430c logging: Updated library configuration documentation. 2010-09-27 13:53:47 +00:00
Antoine Pitrou a305ca786c Fix typo. 2010-09-25 22:12:00 +00:00
Georg Brandl fda2106ac2 #9562: slight clarification. 2010-09-25 16:56:36 +00:00
Georg Brandl a0fc3d37d3 #9944: fix typo. 2010-09-25 13:30:03 +00:00
Vinay Sajip 972412d168 Updated SysLogHandler documentation. 2010-09-23 20:31:24 +00:00
Brian Curtin e8e4b3bfd6 #9808. Implement os.getlogin for Windows, completed by Jon Anglin.
The test is semi-dumb, it just makes sure something comes back since we
don't have a solid source to validate the returned login. We can't be 100%
sure that the USERNAME env var will always match what os.getlogin() returns,
so we don't make any specific assertion there.
2010-09-23 20:04:14 +00:00
Antoine Pitrou e5768cf348 Small fixes in the gzip docs 2010-09-23 16:45:17 +00:00
Antoine Pitrou 7b9698435d Issue #1675951: Allow GzipFile to work with unseekable file objects.
Patch by Florian Festi.
2010-09-23 16:22:51 +00:00
Vinay Sajip 5577892ca9 logging: Improved documentation re. blocking handlers. 2010-09-23 09:09:15 +00:00
Vinay Sajip 0637d493e9 logging: added QueueListener and documentation. 2010-09-23 08:15:54 +00:00
Vinay Sajip 0258ce8f0a logging: Added QueueHandler.prepare and updated documentation. 2010-09-22 20:34:53 +00:00
Georg Brandl 6faee4e2ce #9911: doc copyedits. 2010-09-21 14:48:28 +00:00
Vinay Sajip c84f016988 Added some methods to LoggerAdapter, and updated documentation. 2010-09-21 11:25:39 +00:00
Senthil Kumaran ceff566886 Document HTTPReponse.fileno() method 2010-09-21 01:57:43 +00:00
Barry Warsaw ebbef6fef2 Issue 9877: expose sysconfig.get_makefile_filename() in the public API. 2010-09-20 15:29:53 +00:00
Vinay Sajip 83eadd1488 logging: hasHandlers additions documented. 2010-09-20 10:31:18 +00:00
Antoine Pitrou e1f2f30328 Be more precise as to what operations are supported 2010-09-19 13:56:11 +00:00
Antoine Pitrou dab642605b Remove references to read() and write() methods, which are useless synonyms of
recv() and send()
2010-09-19 13:31:06 +00:00
Antoine Pitrou 792ff3e7be Mention that SSL sockets provide the basic socket API. 2010-09-19 13:19:21 +00:00
Georg Brandl 035cedb4a3 Edit concurrent docs, add versionadded and see also reference to the PEP. 2010-09-19 09:31:09 +00:00
Benjamin Peterson c713fc73cb edit concurrent.future docs 2010-09-19 04:23:17 +00:00
Brian Quinlan 81c4d36928 Initial implementation of PEP 3148 2010-09-18 22:35:02 +00:00
Vinay Sajip ac00799d61 Improved Filter documentation. 2010-09-17 12:45:26 +00:00
Vinay Sajip c8c8c6968b Improved basicConfig and custom level documentation. 2010-09-17 10:09:04 +00:00
Raymond Hettinger 8f5dbc83ea Fix typo in example regular expression. 2010-09-17 06:26:45 +00:00
Raymond Hettinger 37ade9cb61 Add tokenizer example to regex docs. 2010-09-16 12:02:17 +00:00
Antoine Pitrou 11cb961b38 Add cross-references to the glossary entry for file objects. 2010-09-15 11:11:28 +00:00
Antoine Pitrou 0b65b0fc83 Add a glossary entry for file objects. 2010-09-15 09:58:26 +00:00
Antoine Pitrou 5aa0d10560 Improve docs for socket.makefile() and SocketIO 2010-09-15 09:32:45 +00:00
Raymond Hettinger 476a31ef1e Issue 9802: Document min()/max() sort stability 2010-09-14 23:13:42 +00:00
Antoine Pitrou 328ec7455f Issue #9854: The default read() implementation in io.RawIOBase now
handles non-blocking readinto() returning None correctly.
2010-09-14 18:37:24 +00:00
Antoine Pitrou 9e0b864ac0 Issue #1552: socket.socketpair() now returns regular socket.socket
objects supporting the whole socket API (rather than the "raw"
_socket.socket objects).
2010-09-14 18:00:02 +00:00
Vinay Sajip 0055c421fe Tidied example script. 2010-09-14 09:42:39 +00:00
Vinay Sajip de72692465 Tidied example script. 2010-09-14 06:59:24 +00:00
Raymond Hettinger 98a5f3f838 Issue 9840: Add reprlib.recursive_repr(), a decorator for handling recursive calls to __repr__ methods. 2010-09-13 21:36:00 +00:00
Daniel Stutzbach 9f0cbf1c72 Issue #9213: Add index and count methods to range objects, needed to
meet the API of the collections.Sequence ABC.
2010-09-13 21:16:29 +00:00
Vinay Sajip 1b5646ac56 Enhanced HTTPHandler documentation. 2010-09-13 20:37:50 +00:00
Vinay Sajip 63891ed082 Expanded QueueHandler documentation. 2010-09-13 20:02:39 +00:00
Benjamin Peterson 0f4dd9a8e5 add spaces 2010-09-13 01:31:57 +00:00
Benjamin Peterson c7b1cfa463 remove less complete of duplicate docs 2010-09-13 01:30:04 +00:00
Benjamin Peterson c985f1f013 remove duplicate statement 2010-09-13 01:25:38 +00:00
Vinay Sajip 4039aff814 Issue #9827: clarified LogRecord documentation. 2010-09-11 10:25:28 +00:00
Victor Stinner b55e498f56 Issue #767645: fix os.path.supports_unicode_filenames definition
os.listdir(str) always returns unicode and it can return non-ascii filenames
even if supports_unicode_filenames is False.
2010-09-11 00:22:12 +00:00
Victor Stinner 5b519e0201 Issue #9632: Remove sys.setfilesystemencoding() function: use PYTHONFSENCODING
environment variable to set the filesystem encoding at Python startup.
sys.setfilesystemencoding() creates inconsistencies because it is unable to
reencode all filenames in all objects.
2010-09-10 21:57:59 +00:00
Amaury Forgeot d'Arc ba117ef7e9 #4617: Previously it was illegal to delete a name from the local
namespace if it occurs as a free variable in a nested block.  This limitation
of the compiler has been lifted, and a new opcode introduced (DELETE_DEREF).

This sample was valid in 2.6, but fails to compile in 3.x without this change::

   >>> def f():
   ...     def print_error():
   ...        print(e)
   ...     try:
   ...        something
   ...     except Exception as e:
   ...        print_error()
   ...        # implicit "del e" here


This sample has always been invalid in Python, and now works::

   >>> def outer(x):
   ...     def inner():
   ...        return x
   ...     inner()
   ...     del x

There is no need to bump the PYC magic number: the new opcode is used
for code that did not compile before.
2010-09-10 21:39:53 +00:00
Georg Brandl 4785916d62 release() is probably not the most important method 2010-09-10 20:43:53 +00:00
Benjamin Peterson 4f5e298075 add reference to file object 2010-09-10 18:50:38 +00:00
Nick Coghlan e8814fbb32 As per python-dev discussion with Eli, properly document and publish dis.show_code 2010-09-10 14:08:04 +00:00
Antoine Pitrou 6e6cc830c4 Issue #9757: memoryview objects get a release() method to release the
underlying buffer (previously this was only done when deallocating the
memoryview), and gain support for the context management protocol.
2010-09-09 12:59:39 +00:00
Raymond Hettinger 6c60d099e5 Improve the repr for the TokenInfo named tuple. 2010-09-09 04:32:39 +00:00
Raymond Hettinger 44d7b6ad60 Add docstring to cmd.Cmd.do_help() 2010-09-09 03:53:22 +00:00
Raymond Hettinger bd889e8c40 Add a working example for the cmd module. 2010-09-09 01:40:50 +00:00
Giampaolo Rodolà b383dbb45e Fix issue 9794: adds context manager protocol to socket.socket so that socket.create_connection() can be used with the 'with' statement. 2010-09-08 22:44:12 +00:00
Vinay Sajip 121a1c4e11 logging: Added QueueHandler. 2010-09-08 10:46:15 +00:00
Amaury Forgeot d'Arc 4b6fdf3852 #6394: Add os.getppid() support for Windows. 2010-09-07 21:31:17 +00:00
Antoine Pitrou e339651b6f Update nntplib examples to use a public news server.
The example still doesn't work as-is under py3k, due to incomplete
or buggy porting of the nntplib module.
2010-09-07 18:44:12 +00:00
Raymond Hettinger 3149f9c614 typo 2010-09-07 05:35:10 +00:00
Raymond Hettinger b21dac1e38 Remove outdated reference to Wichmann-Hill algorithm. 2010-09-07 05:32:49 +00:00
Raymond Hettinger 0515661314 Issues #7889, #9025 and #9379: Improvements to the random module. 2010-09-07 04:44:52 +00:00
Raymond Hettinger f763a728ad Document which part of the random module module are guaranteed. 2010-09-07 00:38:15 +00:00
Raymond Hettinger 435cb0f233 Document which part of the random module module are guaranteed. 2010-09-06 23:36:31 +00:00
Vinay Sajip c31be6307f Updated information on logging contextual information. 2010-09-06 22:18:20 +00:00
Raymond Hettinger f45abc97bf Add method to OrderedDict for repositioning keys to the ends. 2010-09-06 21:26:09 +00:00
Antoine Pitrou 4bc12ef47d Issue #9754: Similarly to assertRaises and assertRaisesRegexp, unittest
test cases now also have assertWarns and assertWarnsRegexp methods to
check that a given warning type was triggered by the code under test.
2010-09-06 19:25:46 +00:00
Antoine Pitrou 972ee13e03 Issue #5506: BytesIO objects now have a getbuffer() method exporting a
view of their contents without duplicating them.  The view is both readable
and writable.
2010-09-06 18:48:21 +00:00
Brian Curtin 6285774f06 Implement #7566 - os.path.sameopenfile for Windows.
This uses the GetFileInformationByHandle function to return a tuple of values
to identify a file, then ntpath.sameopenfile compares file tuples, which
is exposed as os.path.sameopenfile.
2010-09-06 17:07:27 +00:00
Gregory P. Smith 13b55291ac hashlib has two new constant attributes: algorithms_guaranteed and
algorithms_avaiable that respectively list the names of hash algorithms
guaranteed to exist in all Python implementations and the names of hash
algorithms available in the current process.

Renames the attribute new in 3.2a0 'algorithms' to 'algorithms_guaranteed'.
2010-09-06 08:30:23 +00:00
Georg Brandl c86adb4c5c #9780: both { and } are not valid fill characters. 2010-09-06 06:49:07 +00:00
Raymond Hettinger 7fefaffcc2 Clean-up example of using fileinput as a context manager. 2010-09-05 23:50:32 +00:00
Georg Brandl a9b51d2a0e #9747: fix copy-paste error in getresgid() doc. 2010-09-05 17:07:12 +00:00
Raymond Hettinger 02566ec89f Adopt more descriptive attribute names as suggested on python-dev. 2010-09-04 22:46:06 +00:00
Antoine Pitrou 74a69fa662 Issue #9225: Remove the ROT_FOUR and DUP_TOPX opcode, the latter replaced
by the new (and simpler) DUP_TOP_TWO.  Performance isn't changed, but
our bytecode is a bit simplified.  Patch by Demur Rumed.
2010-09-04 18:43:52 +00:00
Fred Drake cc645b9a59 add consistent support for the vars and default arguments on all
configuration parser classes
(http://bugs.python.org/issue9421)
2010-09-04 04:35:34 +00:00
Georg Brandl 0b37b333a8 Fix missing word. 2010-09-03 22:49:27 +00:00
Georg Brandl 0bb73b8be8 #9767: doctest run over json docs. 2010-09-03 22:36:22 +00:00
Daniel Stutzbach 045b3ba184 Issue #9212: Added the missing isdisjoint method to the dict_keys and
dict_items views.  The method is required by the collections.Set ABC,
which the views register as supporting.
2010-09-02 15:06:06 +00:00
Raymond Hettinger 6f80b4c8b7 Cleanup heapq docs 2010-09-01 21:27:31 +00:00
Antoine Pitrou 1ce3eb5c5b Issue #8990: array.fromstring() and array.tostring() get renamed to
frombytes() and tobytes(), respectively, to avoid confusion.  Furthermore,
array.frombytes(), array.extend() as well as the array.array()
constructor now accept bytearray objects.  Patch by Thomas Jollans.
2010-09-01 20:29:34 +00:00