acc74e6c63
Issue #20650 : Tweak some awkward wording.
2014-02-28 10:06:18 -05:00
871119eb2f
whatsnew: fix textwrap/shorten entry, and improve the related docs.
...
I had incorrectly added back the shorten method when I initially
made the whatsnew entry, but the shorten function docs were not
correct according to the code. I also improved the wording in
general.
2014-02-27 18:01:43 -05:00
5ea5d2c3f7
Issue #20759 : Fix some typos in the mock docs.
2014-02-26 09:34:43 -06:00
984689821d
Close #20759 : Fix some typos in the mock docs. (Merge with 3.3)
2014-02-26 09:38:39 -06:00
13cc883aaa
whatsnew: DynanicClassAttribute ( #19030 ), Py_SetStandardStreamEncoding ( #16129 )
...
Adding missing docs for DynamicClassAttribute by copying the docstring. The
doc entry could stand some expansion, which I will note on the issue.
2014-02-25 16:03:14 -05:00
ef85119618
Issue #20765 : Add missing documentation for PurePath.with_name() and PurePath.with_suffix().
2014-02-25 20:33:02 +01:00
7cae336890
whatsnew: Request.method can be overridden in subclasses ( #18978 ).
...
Jason doced the change in the constructor *method* description, but
not the description of Request.method, so I added the change there
as well.
2014-02-25 10:22:50 -05:00
3e97585b3e
Clarify that flow control works for datagrams, except on BSD.
2014-02-24 14:31:25 -08:00
8920e915fa
whatsnew: http.server --bind cli option.
...
Also some fixups in the docs.
2014-02-24 17:21:42 -05:00
4f91364598
Merge #20628 : make it clear that DictReader/Writer *fieldnames* is a Sequence.
...
Including the subsequent line re-wrapping.
2014-02-24 15:34:48 -05:00
f031a6f334
#20628 : wrap lines to < 80.
2014-02-24 15:32:54 -05:00
df714b9f70
#20628 : make it clear that DictReader/Writer *fieldnames* is a Sequence.
...
Patch by Sean Rodman.
2014-02-24 15:29:22 -05:00
de0e1d30d8
asyncio doc: fix references in subprocess doc
2014-02-24 13:19:19 +01:00
07171242d5
subprocess.Popen.wait doc: mention asyncio to avoid busy loop
2014-02-24 13:18:47 +01:00
06a70621ed
merge with 3.3
2014-02-24 09:27:16 +01:00
c4f44c027e
Closes #20735 : remove erroneous deprecated marker from stringprep docs
2014-02-24 09:26:53 +01:00
6e1bc7cab9
whatsnew: textwrap.shorten.
...
Also add the missing TextWrapper.shorten method doc.
2014-02-23 10:22:07 -05:00
32f30a8d9b
#20677 : fix typo in enum docs. Patch by Saimadhav Heblikar.
2014-02-23 17:13:31 +02:00
98681d4ac1
Reflow paragraph.
2014-02-22 16:32:07 -05:00
928924d1a1
whatsnew: os.path.ismount recognizes volumes mounted below root.
2014-02-22 16:31:26 -05:00
b070b3f502
whatsnew: frozen package __path__; and min/max versionadded.
2014-02-22 15:05:08 -05:00
7a19355c77
asyncio.docs: Document subprocess_exec and subprocess_shell. Issue #20694 .
2014-02-20 20:10:28 -05:00
f9200ae398
asyncio.docs: Improve wordings; add a note to the Coroutines section. Issue #20706
2014-02-20 16:20:44 -05:00
35669ae77e
asyncio.docs: Improve documentation of Streams. Issue #20696 .
2014-02-20 14:10:02 -05:00
d5797422dd
asyncio.docs: Document Error Handling API and asyncio.Handle
2014-02-19 20:58:44 -05:00
aabc131224
asyncio doc: remove reference to _DEBUG (now replaced with PYTHONASYNCIODEBUG
...
env var), document the default debug mode
2014-02-20 01:44:10 +01:00
7ef60cd8c2
asyncio, Tulip issue #136 : Add get/set_debug() methods to BaseEventLoopTests.
...
Add also a PYTHONASYNCIODEBUG environment variable to debug coroutines since
Python startup, to be able to debug coroutines defined directly in the asyncio
module.
2014-02-19 23:15:02 +01:00
03e9cb2b0b
asyncio: document new create_unix_connection() and create_unix_server() methods
...
of BaseEventLoop
2014-02-19 13:32:34 +01:00
8b21d91e35
Issue #20493 : Document that asyncio should not exceed one day
2014-02-18 09:37:43 +01:00
0aba4dc1ed
Close #20649 : Fix typo in asyncio doc. Patch written by Brett Cannon.
2014-02-18 09:22:00 +01:00
38df2adaeb
Close #20652 : asyncio doc: close the event loop in run_forever() example. Fix
...
also typo. Patch written by Vajrasky Kok.
2014-02-17 10:54:30 +01:00
23f628de4a
Issue #20616 : Add a format() method to tracemalloc.Traceback.
2014-02-16 23:53:38 +01:00
c77974e033
Merge from 3.3
2014-02-16 12:18:17 -05:00
3137885c36
#12211 : remove paragraph about NaNs
2014-02-16 12:09:35 -05:00
87a113b807
Merge from 3.3
2014-02-16 11:15:13 -05:00
8cb1ec3274
#12211 : clarify math.copysign() documentation and docstring
2014-02-16 11:11:25 -05:00
a3d0ffe2c6
Merge from 3.3
2014-02-15 17:22:41 -05:00
e5235f1624
#20241 : use correct RFC number
2014-02-15 17:11:06 -05:00
ac6e578691
Merge from 3.3
2014-02-15 16:40:08 -05:00
46ff4ee81c
Clarify versionchanged sentence. Closes #20497 .
2014-02-15 16:39:37 -05:00
30f240150e
merge 3.3
2014-02-15 15:39:01 -05:00
4da9ab0357
#20237 : make a revision pass over the XML vulnerabilities section
2014-02-15 15:33:44 -05:00
504f6e8653
#19890 : merge with 3.3.
2014-02-15 16:59:39 +02:00
e426b71789
#19890 : fix typo in multiprocessing docs. Patch by Mike Short.
2014-02-15 16:58:52 +02:00
28773465e6
ayncio, Tulip issue 129: BaseEventLoop.sock_connect() now raises an error if
...
the address is not resolved (hostname instead of an IP address) for AF_INET and
AF_INET6 address families.
2014-02-13 09:24:37 +01:00
2167e29d31
whatsnew: os.path.samestat on windows, keyword defaults evaluation order.
2014-02-12 00:02:34 -05:00
d630e79cc7
whatsnew: object.__format__ raises TypeError on non-empty string.
...
See issues #7994 and #9856 . I also modified with wording of the format doc
entry to better match what really happens, and added a versionchanged to the
datamodel object.__format__ section.
2014-02-11 18:34:22 -05:00
bbe3335f65
Deprecate Popen.wait()'s undocumented endtime parameter. issue20572.
2014-02-11 09:21:03 -08:00
ad88d7a26b
Python 3.4.0rc1 release: Updated pydoc topics, fixed suspicious markup errors.
2014-02-10 04:26:10 -08:00
b082731fbb
Issue #20517 : Functions in the os module that accept two filenames
...
now register both filenames in the exception on failure.
This required adding new C API functions allowing OSError exceptions
to reference two filenames instead of one.
2014-02-09 22:05:19 -08:00
136fea253e
More complete documentation of event loops and policies.
...
Documented the AbstractEventLoopPolicy interface explicitly and explained the
relation between the global loop & policy access functions. Added an initial
section that explains the connections in general terms. Documented missing XXX
methods.
2014-02-09 06:55:58 -08:00
b73c83318d
Various formatting & grammar fixes in asyncio* docs.
2014-02-09 06:07:47 -08:00
8b402629ae
Fix typo in library/ipc.rst
2014-02-09 05:54:13 -08:00
0b094ce170
do not line break reference
2014-02-16 12:46:30 -05:00
0c3949c963
asyncio: Remove Process.subprocess attribute; it's too easy to get inconsistent
...
Process and Popen objects
2014-02-09 02:51:40 +01:00
c9d1a6b85e
merge
2014-02-08 18:36:57 -06:00
a1afeec9aa
Spelling corrections. Submitted to python-dev by python@mrabarnett.plus.com
2014-02-08 18:36:14 -06:00
12c68b20b7
asyncio doc: fix gather() doc
2014-02-09 01:35:24 +01:00
aa029dad50
Tweaks to What's New and some referenced docs
2014-02-09 10:10:24 +10:00
96bb437ae8
Close #20563 : Declare ipaddress API stable
2014-02-09 09:18:26 +10:00
127242654d
merge from 3.3
...
Include the mention of ResourceWarning being displayed by default by the test runner.
Addressing #issue 20529
2014-02-08 14:28:44 -08:00
409ea5dac1
Include the mention of ResourceWarning being displayed by default by the test runner.
...
Addressing #issue 20529
2014-02-08 14:28:03 -08:00
c1567df61e
asyncio doc: document missing event loop methods
2014-02-08 23:22:58 +01:00
ffbe3c67df
asyncio doc: sort methods
2014-02-08 22:50:07 +01:00
ca1b794dac
Close issue20534: all pickle protocols now supported.
2014-02-08 11:36:27 -08:00
73afe2a972
Close #20481 : Disallow mixed type input in statistics
...
The most appropriate coercion rules are not yet clear, so simply
disallowing mixed type input for 3.4.
(Committed on Steven's behalf)
2014-02-08 19:58:04 +10:00
85310a50a9
Issue #20505 : Remove resolution and _granularity from selectors and asyncio
...
* Remove selectors.BaseSelector.resolution attribute
* Remove asyncio.BaseEventLoop._granularity attribute
2014-02-07 23:34:58 +01:00
27e9de669b
#20531 : Revert e20f98a8ed71, the 3.4 version of the #19063 fix.
2014-02-07 12:40:37 -05:00
790202d613
asyncio doc: mention that asyncio is not thread-safe
2014-02-07 19:03:05 +01:00
02384bfa94
#20477 : add examples of using the new contentmanager API.
2014-02-07 10:55:17 -05:00
303718c3d7
Fix empty strings to empty bytes objects.
2014-02-06 21:11:33 +02:00
5e028ae09e
Fix empty strings to empty bytes objects.
2014-02-06 21:10:41 +02:00
c72e638643
Close issue20412: Updated Enum docs to have referencable Enum and IntEnum classes
2014-02-06 08:13:14 -08:00
3303b6abc8
Merge for issue #20488
2014-02-06 09:49:53 -05:00
07fbd78473
Issue #20488 : Update docs to say importlib is *the* implementaiton of
...
import and not *an* implementation.
2014-02-06 09:46:08 -05:00
94e44a935b
Issue #14455 : fix handling of unsigned long long values for binary plist files
...
Values in the range of an unsigned long long, but outside of the range
of a signed long long were serialized as a negative value.
Due to a bug in PyObjC my test scripts indicated that the previous behavior
matched Apple's plist code, instead the handle large unsigned values correctly.
The change to plistlib.py is from a patch by Serhiy.
2014-02-06 11:19:18 +01:00
58af25e930
#14515 : clarify that TemporaryDirectory's __enter__ returns the name.
2014-02-05 14:56:39 -05:00
23686074b0
#14515 : clarify that TemporaryDirectory's __enter__ returns the name.
2014-02-05 14:53:40 -05:00
3c9bb69fa1
Add missing word ("thread") to sentence about call_soon_threadsafe.
2014-02-04 13:49:34 -08:00
5cb84ed5b1
asyncio doc: add an example to schedule a coroutine from a different thread
2014-02-04 18:18:27 +01:00
d8b24d756a
Closes #20509 : Merged documentation update from 3.3.
2014-02-04 16:42:04 +00:00
6068b6c977
Issue #20509 : Added cross-reference in documentation.
2014-02-04 16:28:07 +00:00
e48d4db000
asyncio doc: add an example of asyncio.subprocess with communicate() and wait()
2014-02-03 23:26:28 +01:00
b79eb0502c
asyncio.subprocess: Replace Process.get_subprocess() method with a
...
Process.subprocess read-only property
2014-02-03 23:08:14 +01:00
233eac42d4
remove extra backtick
2014-02-03 14:08:00 -05:00
3bc647c0fa
Issue #20472 : asyncio: Adjust the note about Mac OS X on PTY, specify that it
...
requires at least Mac OS X 10.6.
2014-02-03 00:35:46 +01:00
9c2389d282
Issue #20423 : fix documentation of io.StringIO's newline parameter
2014-02-02 22:49:03 +01:00
be7ff9f2f9
Issue #20423 : fix documentation of io.StringIO's newline parameter
2014-02-02 22:48:25 +01:00
084443809f
asyncio: document the new asyncio.subprocess module
2014-02-02 22:43:39 +01:00
4885f49e7f
whatsnew: filecmp.clear_cache, and reword description of cache in docs.
2014-02-02 11:11:01 -05:00
9592edb834
asyncio doc: add "asyncio-" prefix to references
2014-02-02 15:03:02 +01:00
606ab031c1
asyncio doc: add "Concurrency and multithreading" section
2014-02-01 03:18:58 +01:00
45b27ed53d
asyncio doc: document the granularity of the event loop
...
Improve also the "Logging" section
2014-02-01 02:36:43 +01:00
607bc3dd82
Merge with 3.3
2014-01-31 11:31:14 -06:00
19c1f3dce6
Fix unfinished thought in xml overview page. Suggested by Bo Bayles on docs@.
2014-01-31 11:30:36 -06:00
d71e52fc33
inspect.doc: Soften the note about inspect.signature not supporting
...
all builtin functions.
2014-01-30 00:22:57 -05:00
224c9c1f49
inspect.docs: Document constructors for Signature & Parameter #20442
2014-01-30 00:12:02 -05:00
783568980a
inspect.docs: Document constructors for Signature & Parameter #20442
2014-01-30 00:10:54 -05:00
1ad5afc050
asyncio: document iscoroutine(), iscoroutinefunction() and wait_for()
...
Mention that wait_for() now accepts None for the timeout.
2014-01-30 00:18:50 +01:00
f40c66334d
asyncio doc: close the loop at exit
2014-01-28 23:32:40 +01:00
eecbbad89b
Fix doc reference to OS X 10.9 Mavericks.
2014-01-27 19:03:07 -07:00
041ff9be13
asyncio doc: list Windows and Mac OS X limitations and explain how to work
...
around them
2014-01-28 02:24:22 +01:00
eedf1c1ebf
asyncio doc: subprocess_exec/subprocess_shell are not available on Windows
2014-01-27 23:01:41 +01:00
2393dca472
inspect.signature: Use '/' to separate positional-only parameters from
...
the rest in Signature.__str__. #20356
2014-01-27 15:07:58 -05:00
ea2d66e68a
doc/inspect: Clarify docs for __defaults__, add docs for __kwdefaults__ #20380
2014-01-27 14:26:28 -05:00
32970b8dec
asyncio: IncompleteReadError is a subclass of EOFError
2014-01-27 12:18:49 +01:00
b7f19ff94b
asyncio: document the IncompleteReadError exception
2014-01-27 11:58:49 +01:00
8b86348dfa
asyncio: document add_signal_handler/remove_signal_handler, add an example for
...
signals
2014-01-27 10:07:50 +01:00
b9915973f3
Issue #20367 : Fix behavior of concurrent.futures.as_completed() for duplicate
...
arguments. Patch by Glenn Langford.
2014-01-27 09:11:48 +01:00
e6994ff6e3
Fix issue #20367 : concurrent.futures.as_completed() for duplicate arguments.
...
Patch by Glenn Langford.
2014-01-26 09:57:51 -08:00
9ad116bcd0
Document asyncio.QueueFull/Empty.
2014-01-25 17:38:31 -08:00
669eeaf933
Merge latest Tulip into asyncio
...
- Make the new granularity attribute private
- Simplify BaseEventLoop._run_once(): avoid math.ceil(), use simple arithmetic
instead
2014-01-26 00:02:31 +01:00
6029e08691
Issue 19944: Fix importlib.find_spec() so it imports parents as needed.
...
The function is also moved to importlib.util.
2014-01-25 15:32:46 -07:00
f67255ab94
Issue #20311 : asyncio: Add a granularity attribute to BaseEventLoop: maximum
...
between the resolution of the BaseEventLoop.time() method and the resolution of
the selector. The granuarility is used in the scheduler to round time and
deadline.
2014-01-25 15:01:33 +01:00
635fca9704
Issue #20311 : selectors: Add a resolution attribute to BaseSelector.
2014-01-25 14:56:48 +01:00
62f8eccdbf
asyncio doc: document StreamWriter.drain()
2014-01-24 18:47:26 +01:00
8c462c5a80
asyncio doc: move AbstractServer to the event loop page
...
Add also entries in the table of content for each synchronization primitive
class.
2014-01-24 18:11:43 +01:00
4b4f9ebfea
asyncio doc: add a "Coroutines and protocols" section
2014-01-24 17:33:20 +01:00
1374bd41b1
asyncio: mention that transports/protocols are low-level, streams are high-level
2014-01-24 15:34:19 +01:00
5c66189e88
Issue #20189 : Four additional builtin types (PyTypeObject,
...
PyMethodDescr_Type, _PyMethodWrapper_Type, and PyWrapperDescr_Type)
have been modified to provide introspection information for builtins.
Also: many additional Lib, test suite, and Argument Clinic fixes.
2014-01-24 06:17:25 -08:00
c520edc08b
asyncio doc: add an client example using streams
2014-01-23 11:25:48 +01:00
24f8ebf4c5
asyncio doc: Move streams to their own dedicated page
2014-01-23 11:05:01 +01:00
c8ea81330c
asyncio doc: link create_connection() to open_connection() and create_server()
...
to start_server()
Rename also the "Network functions" section to "Stream functions" and move it to the Stream section.
2014-01-23 11:02:09 +01:00
7235c05085
asyncio doc: move stream classes to their own class
2014-01-23 10:54:57 +01:00
3eb45d3eae
asyncio: Fix open_connection() documentation, writer is a StreamWriter
2014-01-23 10:20:18 +01:00
5116f78221
Issue #20301 : Merge with 3.3
2014-01-21 13:50:13 -06:00
f7d2874d30
Issue #20301 : Mention the correct KEY_* value as the default
...
for 'access' in winreg.DeleteKeyEx. Already correct in the docs
function signature and docstring. Noticed by Justin Foo.
2014-01-21 13:49:22 -06:00
a67a79da24
Merge with 3.3
2014-01-21 00:02:17 -05:00
30ffe7eb68
Issue #20222 : file is no longer a builtin in 3.x.
2014-01-21 00:01:51 -05:00
b6457249bf
Fix the description of pickle protocol numbers
2014-01-21 02:39:54 +01:00
679688e70d
Fix grammar and add markup
2014-01-20 08:13:31 -08:00
3245e79b82
Formatting & rst link markup fixes
2014-01-20 07:51:31 -08:00
029981bbfc
Clarify what the loop arguments means for functions listed in 18.5.2.5
2014-01-20 07:02:22 -08:00
2d26af82c1
Explain the 'result' argument in asyncio.sleep
2014-01-20 06:59:23 -08:00
5a6d4bf671
Fixes Issue #20165 : The unittest module no longer considers tests marked with
...
@expectedFailure successful if they pass.
2014-01-20 01:11:18 -08:00
27b490c713
merge 3.3 ( #6627 )
2014-01-20 00:12:24 -05:00
1cfe009b96
put notes in a ..note section
2014-01-20 00:10:23 -05:00
f6ffb4b264
document that a new Python thread context is created in ctypes callbacks ( closes #6627 )
...
Patch by Nikolaus Rath.
2014-01-20 00:09:53 -05:00
dc3cce077d
merge 3.3 ( #17811 )
2014-01-18 22:57:05 -05:00
e83ed43281
improve description of buffers argument for readv/writev ( closes #17811 )
...
Patch by Nikolaus Rath.
2014-01-18 22:54:59 -05:00
3c16c1d821
merge 3.3
2014-01-18 00:49:30 -05:00
af69fe2311
rm extra whitespace
2014-01-18 00:49:04 -05:00
9308c420d3
merge 3.3
2014-01-18 00:47:06 -05:00
eacec1ccff
link to builtin open not io.open
2014-01-18 00:47:00 -05:00
d8af6700b9
merge 3.3 ( #17814 )
2014-01-18 00:46:49 -05:00
3d8814e1d3
describe type of Popen streams ( closes #17814 )
...
Patch more or less by Nikolaus Rath.
2014-01-18 00:45:56 -05:00
24f60b4616
Issues #20194,20195: Add missing :deprecated: markers to some module
...
docs.
2014-01-17 12:06:28 -05:00
c089f70b54
Issue #18394 : Document that cgi.FieldStorage now cleans up after its
...
'file' attribute properly in Python 3.4.
Thanks to Marcel Hellkamp for pointing out the oversight.
2014-01-17 11:03:19 -05:00
9731183390
asyncio: oops, add missing word :-)
2014-01-17 10:31:02 +01:00
59759ff234
asyncio doc: replace "coroutine" with "coroutine object" or "coroutine function"
2014-01-16 19:30:21 +01:00
db39a0da0c
asyncio: add a new "Develop with asyncio" section to the documentation
2014-01-16 18:58:01 +01:00
5cacb84d83
merge 3.3 ( #20272 )
2014-01-16 10:10:26 -05:00
2989f587a7
linkify chain.from_iterable ( closes #20272 )
2014-01-16 10:10:13 -05:00
a65d121607
merge 3.3 ( #20278 )
2014-01-16 09:53:22 -05:00
216e47d834
update pysqlite website ( closes #20278 )
2014-01-16 09:52:38 -05:00
3763f2bc07
Merged documentation update from 3.3.
2014-01-15 15:09:43 +00:00
cbefe3b9a0
Added cookbook entry on alternative formatting styles.
2014-01-15 15:09:05 +00:00
6ed2893aae
Merged documentation update from 3.3.
2014-01-15 13:29:24 +00:00
350e623623
Clarified documentation note on module-level convenience functions.
2014-01-15 13:28:39 +00:00
6db6653bbc
Issue #14455 : Fix some issues with plistlib
...
* Negative integer support in binary plists was broken
* Better exception for invalid data
* Fix the versionadded/versionchanged markup in the documentation
* Add the interface cleanup to what's new for 3.4
2014-01-15 11:32:35 +01:00
5c15424aa9
Closes #20253 : Merge typo fix
2014-01-14 09:10:33 -06:00
9774ce0cab
Issue #20253 : Fixed a typo in the ipaddress docs that advertised an
...
illegal attribute name. Found by INADA Naoki.
2014-01-14 09:09:48 -06:00
92b7adb60d
merge
2014-01-14 12:27:44 +01:00
e74f96ded5
Merge typo fix.
2014-01-13 20:39:21 -06:00
80602e0e1b
Fix typo.
2014-01-13 20:38:57 -06:00
75ff6d284a
Merge #20236 : Fix sphinx markup.
2014-01-13 13:51:42 -05:00
66c9350a89
#20236 : Fix sphinx markup.
2014-01-13 13:51:17 -05:00
95be7ff911
merge from 3.3
...
Issue #19082 : Working xmlrpc.server and xmlrpc.client examples. Both in modules and in documentation.
2014-01-12 16:07:59 -08:00
939e2db48d
Issue #19082 : Working xmlrpc.server and xmlrpc.client examples. Both in modules and in documentation.
2014-01-12 16:06:58 -08:00
632c812942
small grammar fix.
2014-01-12 18:03:12 +01:00
fa5a765506
Fix minor markup bug: sub-toctrees should not have :numbered:
2014-01-11 19:52:17 +01:00
0ae7ae1fc9
whatsnew: InspectLoader.get_code now concrete, b32decode raises binascii.Error.
...
And a news item rephrase.
2014-01-08 18:16:02 -05:00
fdc58fd897
Merge: Fix verb tense in base64 docs, and the phrasing of a news entry.
2014-01-08 18:14:20 -05:00
78ee3289e9
Fix verb tense in base64 docs, and the phrasing of a news entry.
2014-01-08 18:09:29 -05:00
8d942296bb
Issue #19719 : Update various finder and loader ABCs such that their
...
old methods now provide implementations when PEP 451 APIs are present.
This should help with backwards-compatibility with code which has not
been updated to work with PEP 451.
2014-01-07 15:52:42 -05:00
0bce6e7462
whatsnew: expand 'dis' entry.
...
Also add one missing versionadded.
2014-01-07 14:30:17 -05:00
a101bdb88c
whatsnew: ssl getpeercert/do_handshake raise OSError, weakref __callback__.
...
Also add a missing word to gc entry, and delete a now-obsolete doc note
in the weakref __callback__ docs. (Opened an issue for rewriting
the section that compares finalizers and __del__ method.)
2014-01-06 16:32:05 -05:00
410d320703
whatsnew: XMLPullParser, plus some doc updates.
...
I was confused by the text saying that read_events "iterated", since it
actually returns an iterator (that's what a generator does) that the
caller must then iterate. So I tidied up the language. I'm not sure
what the sentence "Events provided in a previous call to read_events()
will not be yielded again." is trying to convey, so I didn't try to fix that.
Also fixed a couple more news items.
2014-01-04 23:52:50 -05:00
0056936a4b
whatsnew: deprecation of HTTPConnection's strict parameter.
2014-01-03 13:04:25 -05:00
42fa110035
whatsnew: unittest import time SkipTest reported as skip not error.
2014-01-03 13:03:36 -05:00
a475a8d313
whatsnew: http.server send_error explain parameter.
...
Also rewrote the send_error description for clarity and correct English.
2014-01-03 13:03:00 -05:00
24e43308b7
* Issue #16113 : Remove sha3 module again.
...
Patch by Christian Heimes, with modifications.
2014-01-03 14:05:06 +01:00
12e930f3a4
#17282 : Document unittest.main defaultTest argument.
2014-01-02 13:37:26 -05:00
3a990c69b8
remove brackets
2014-01-02 12:22:30 -06:00
6e731b0a41
Merge and update #17282 : Document unittest.main defaultTest argument.
...
In 3.4 defaultTest can also be a list (see issue 15132).
2014-01-02 13:43:02 -05:00
c22eaecd53
merge 3.3 ( closes #20108 )
2014-01-02 12:26:50 -06:00
d592bb2dc4
whatsnew: afic.open supports 'with'.
2013-12-31 13:45:38 -05:00
fced3ec2db
whatsnew: argparse FileType accepts errors and encodings args.
2013-12-31 11:18:01 -05:00
2bc930f044
whatsnew: epoll supports with.
...
Also reworded the description of the feature in the docs.
2013-12-31 11:17:21 -05:00
4d1639f4e5
Closes issue 20031. Document unittest.TextTestRunner.run method.
2013-12-29 23:38:55 +00:00
3e86ba4e32
Issue #19422 : Explicitly disallow non-SOCK_STREAM sockets in the ssl module, rather than silently let them emit clear text data.
2013-12-28 17:26:33 +01:00
e6d2f159fc
Issue #19422 : Explicitly disallow non-SOCK_STREAM sockets in the ssl module, rather than silently let them emit clear text data.
2013-12-28 17:30:51 +01:00
473f45b4bc
whatsnew: rewrite urllib, doctest, and poplib sections.
...
Also collapse redundant versionadded/versionchanged markup in
poplib.stls entry.
2013-12-27 17:01:16 -05:00
0e814634e5
whatsnew for gc.get_stats, plus doc tweaks.
...
Clarified the "At the moment" wording, and added the get_stats entry in the
module summary that Serhiy noted was missing at the end of issue 16351.
Given that pydoc lists all the function docstrings, I'm not sure that module
summary section is actually needed; but, it is probably better to address that
when the module is converted to use Argument Clinic. In the meantime we
should keep the list complete.
2013-12-26 15:11:28 -05:00
575fb31955
shelf in with stmt, fish/csh in venv, ElementTree short_empty_elements keyword.
...
Also added versionadded for for fish/csh, fixed indentation of versionadded
for ElementTree.write, and make the behavior of shelf as a context manager
explicit in the docs.
2013-12-25 23:21:03 -05:00
3edcc7832e
#16832 : s/integer/object/ in docs/docstring, and add whatsnew entry.
2013-12-24 16:13:32 -05:00
f47036c130
Removed spaces before colons and semicolons.
2013-12-24 11:04:36 +02:00
89e84e7523
Removed spaces before colons and semicolons.
2013-12-24 11:05:24 +02:00
2a6145290b
Removed spaces before commas and periods.
2013-12-23 18:21:57 +02:00
a4d170d985
Removed spaces before commas and periods.
2013-12-23 18:20:51 +02:00
6256fcbc97
Close #19734 : ignore pip env vars in ensurepip
2013-12-23 16:16:07 +10:00
a936c40ede
s/lightweight/minimal/, as per issue #11379 .
2013-12-22 01:57:45 +01:00
f20ea13996
s/lightweight/minimal/, as per issue #11379 .
2013-12-22 01:57:01 +01:00
ac18622126
Add links to discussion of multiprocessing spawn/forkserver feature.
2013-12-20 17:23:57 -05:00
748bad2cd0
Tidy up ssl whatsnew references, make ssl section formatting consistent.
...
Also remove some extra blank lines in the ssl doc acctions for tls1.1/1.2,
and reflow a paragraph.
2013-12-20 17:08:39 -05:00
cde1a06a54
Include sha3 addition in hashlib section of whatsnew.
...
And link to it from the summary, and link to the Hash Algorithms
section of hashlib from the linked description.
2013-12-20 16:33:52 -05:00
6d5cb07382
Move versionadded for tracemalloc into the standard location (right after title)
2013-12-20 14:48:50 -05:00
43ad138160
Move versionadded for ensurepip into the standard location (right after title)
2013-12-20 14:40:11 -05:00
6a14381530
Fix Sphinx markup for asyncio modules so :mod:`asyncio` links work.
2013-12-20 14:37:39 -05:00
fd1ff1c888
Add versionadded to enum docs.
2013-12-20 14:20:49 -05:00
f468d5b259
Closes #19902 : Merged update from 3.3.
2013-12-19 11:51:19 +00:00
800e11b406
Issue #19902 : Added list of logging levels.
2013-12-19 11:50:24 +00:00
e61f4df275
Closes #20005 : Fix typo in operator docs. Patch by Claudiu Popa.
2013-12-18 12:22:35 -06:00
0bffca006a
Issue #20005 : Fix typo in operator docs. Patch by Claudiu Popa.
2013-12-18 12:21:49 -06:00
ca2d854df8
Issue #19713 : Update importlib docs for module spec changes, including deprecations.
2013-12-16 23:06:52 -07:00
5100311bd8
Issue #20001 : Add the SVG source of the pathlib-inheritance diagram to Hg
2013-12-16 21:13:40 -08:00
1d006a2c0e
Backout a1a05e2724dd: shutil.which(bytes) is a new feature and my patch does not work on Windows
2013-12-16 23:39:40 +01:00
fffb96ba66
Issue #18283 : shutil.which() now supports bytes argument, not only text argument.
2013-12-16 22:48:48 +01:00
f6abb70b48
Mention specific exceptions instead of OSError where appropriate.
2013-12-16 21:00:53 +01:00
0048c98fef
Issue #19921 : When Path.mkdir() is called with parents=True, any missing parent is created with the default permissions, ignoring the mode argument (mimicking the POSIX "mkdir -p" command).
...
Patch by Serhiy.
2013-12-16 20:22:37 +01:00
720c7e28cb
Issue #19700 : set __spec__ appropriately in runpy
...
Note that __spec__.name is not currently guaranteed to be in
sys.modules when the code is running, only __name__ is.
The "running module is in sys.modules" invariant will be
expanded to also cover __spec__.name in a subsequent patch.
2013-12-15 20:33:02 +10:00
530a69fafc
#19970 : fix additional typo in 3.4 asyncio docs.
2013-12-14 11:26:06 -05:00
66f8518acb
#19981 : merge with 3.3.
2013-12-14 12:43:08 +02:00
956040a7cc
#19981 : fix typo in email.mailbox docs. Patch by Claudiu Popa.
2013-12-14 12:42:29 +02:00
706a7296d7
merge for issue #19963
2013-12-13 13:58:47 -05:00
98620d87f2
Issue #19963 : Document that importlib.import_module() will import
...
parent packages automatically.
2013-12-13 13:57:41 -05:00
86e139ad65
asyncio doc: explain where does the task come from.
2013-12-13 12:51:24 +01:00
68bccb4922
asyncio doc: change style of the sequence diagram to focus on the control flow
2013-12-13 12:47:39 +01:00
2748bc735e
asyncio: remove references to the Tulip project, rename Tulip to asyncio.
...
Patch written by Vajrasky Kok.
2013-12-13 10:57:04 +01:00
1c4b892d71
Add a sequence diagram for the chained coroutines example
2013-12-12 12:35:17 +01:00
50bfbb9903
#19063 : fix set_payload handling of non-ASCII string input.
...
This version of the fix raises an error instead of accepting the invalid
input (ie: if a non-ASCII string is used but no charset is specified).
2013-12-11 16:52:11 -05:00
b282b3d804
Issue #18864 : Add a setter for ModuleSpec.has_location.
2013-12-10 22:16:41 -07:00
a6fa15367f
asyncio doc: simplify task example
2013-12-10 12:20:14 +01:00
0839ed4730
asyncio doc: don't document Task.cancel(), already documented in Future.cancel()
2013-12-10 12:18:15 +01:00
742520be43
asyncio: document Task.current_task()
2013-12-10 12:14:50 +01:00
fc25d629ab
asyncio: don't document private functions
2013-12-10 02:52:49 +01:00
34f2946a11
asyncio: fix 2nd task example
2013-12-10 02:51:05 +01:00
dbd8950b28
asyncio doc: rewrite the callback hello world to use call_soon() instead of a
...
direct call.
2013-12-10 02:47:22 +01:00
b69d62dcac
assyncio doc: rewrite, improve and move coroutine, Future and Task examples
2013-12-10 02:09:46 +01:00
a881a7f205
asyncio doc: explain why the loop is running twice
2013-12-09 13:19:23 +01:00
d8f11e9265
asyncio: another Future example using add_done_callback()
2013-12-09 13:04:12 +01:00
45c2fd9f8a
asyncio doc: add an example with Future
2013-12-09 12:40:17 +01:00
bd6932a576
Closes #18430 : Document that peek() may change the position of the underlying
...
file for the BZ2File, GzipFile and LZMAFile classes.
2013-12-08 19:50:05 +01:00
6976104a36
#18430 : Document that peek() may change the position of the underlying file for
...
the BZ2File, GzipFile and LZMAFile classes.
2013-12-08 19:47:22 +01:00
ca616a2709
- Issue #19736 : Add module-level statvfs constants defined for GNU/glibc
...
based systems.
2013-12-08 15:23:07 +01:00
5bb414d176
Issue #19343 : Expose FreeBSD-specific APIs in resource module. Original patch by Koobs.
2013-12-08 14:35:55 +01:00
9710ff04ac
Silently ignore unregistering closed files. Fixes issue 19876. With docs and slight test refactor.
2013-12-07 15:57:01 -08:00
d05c9ff845
Issue #6784 : Strings from Python 2 can now be unpickled as bytes objects.
...
Initial patch by Merlijn van Deen.
I've added a few unrelated docstring fixes in the patch while I was at
it, which makes the documentation for pickle a bit more consistent.
2013-12-07 01:09:27 -08:00
d45a46b60d
merge 3.3 ( #19910 )
2013-12-06 20:12:51 -05:00
933142a8f2
document that compile() can take bytes ( closes #19910 )
2013-12-06 20:12:39 -05:00
9bcb1127f1
Mention pickle protocol 4, and some tweaks.
2013-12-07 01:05:57 +01:00
9858e8b98d
Issue #19900 : improve generalities at the start of the pickle module doc
2013-12-07 00:57:44 +01:00
d4d60554bc
Issue #19900 : improve generalities at the start of the pickle module doc
2013-12-07 00:56:59 +01:00
f9c54944df
Merge socket doc changes from 3.3
2013-12-04 21:15:24 +01:00
a5cc9d68b9
Tweak the socket module doc layout
2013-12-04 21:11:03 +01:00
e3658a70c3
Issue #19882 : tweak docs for socket.close()
2013-12-04 21:02:42 +01:00
31d83228c2
asyncio doc: add some notes on the ping example
2013-12-04 11:16:17 +01:00
99c2ab4b83
asyncio doc: oh, asyncio module has its own Future class
...
Improve also wait() documentation: mention that the first parameter is a
sequence
2013-12-03 19:17:25 +01:00
cf6f72e329
Fix typo in asyncio.AbstractServer documentation
2013-12-03 18:23:52 +01:00
c6fba92ebc
asyncio doc: add one more example of coroutines
2013-12-03 17:37:31 +01:00
85a2be7da7
ayncio: replace the disclamer with a seealso section
2013-12-03 15:04:36 +01:00
15faa9c8ad
asyncio doc: simplify ping example, remove the useless timeout
2013-12-03 15:04:18 +01:00
afbf827875
asyncio doc: fix definition of stop() method
2013-12-03 02:05:42 +01:00
933a8c82ce
asyncio doc: reorder methods; typo
2013-12-03 01:59:38 +01:00
1ca5ba611b
asyncio io: group transports and protocols in a new title
2013-12-03 01:49:43 +01:00
0c6f1ca40c
asyncio doc: write a complete TCP echo example, client and server
...
Example based on tcp_echo.py example from Tulip source code.
2013-12-03 01:46:39 +01:00
3e09e32c8a
asyncio doc: move coroutine example to the Task page
2013-12-03 01:22:06 +01:00
ea3183f5b8
Split asyncio documentation into subfiles
2013-12-03 01:08:00 +01:00
fa2ce78a21
asyncio doc: change level of titles
...
Remove also a duplicated Protocols section!
2013-12-03 00:56:27 +01:00
b3be72cac3
asyncio doc: reorder sections
2013-12-03 00:49:26 +01:00
34d8df5171
asyncio: document wait() function
2013-12-03 00:42:59 +01:00
dd339a248c
asyncio doc
...
* complete create_connection() prototype
* link to Server
* document get_extra_info() keys
2013-12-03 00:32:48 +01:00
a5768f7292
Issue #19785 : smtplib now supports SSLContext.check_hostname and server name
...
indication for TLS/SSL connections.
2013-12-02 20:44:17 +01:00
216d463b1f
Issue #19783 : nntplib now supports SSLContext.check_hostname and server name
...
indication for TLS/SSL connections.
2013-12-02 20:20:11 +01:00
1bc7068d7f
Issue #19784 : poplib now supports SSLContext.check_hostname and server name
...
indication for TLS/SSL connections.
2013-12-02 20:10:50 +01:00
b8a3f58158
merge
2013-12-02 20:02:04 +01:00
48aae57996
Issue #19782 : imaplib now supports SSLContext.check_hostname and server name
...
indication for TLS/SSL connections.
2013-12-02 20:01:29 +01:00
475546facf
Fixed regex match representation in an example.
2013-12-02 20:23:19 +02:00
0c924b83ee
asyncio: sort some methods
2013-12-02 17:52:31 +01:00
b09f9b33d2
asyncio doc: group transport method by classes
...
Declare classes because they are mentionned in documentation of other functions
2013-12-02 17:46:04 +01:00
e91f180efe
asyncio: more documentation
2013-12-02 17:40:48 +01:00
be490633be
asyncio: document network functions, and stream reader/writer
2013-12-02 17:28:32 +01:00
b55c4d4539
Issue #19814 : Clarify argparse's docs w.r.t prefix matching
2013-12-02 05:50:48 -08:00
f3114532e4
Issue #19814 : Clarify argparse's docs w.r.t prefix matching
2013-12-02 05:49:54 -08:00
c37dd614b6
asyncio: document locks
2013-12-02 14:31:16 +01:00
0da1d29c8a
asyncio: document Queue classes
2013-12-02 14:06:03 +01:00
60efaae4f9
Document Task class and task functions
2013-12-02 13:47:23 +01:00
3c3c4f5a11
asyncio: cleanup doc
2013-12-02 13:04:25 +01:00
550a09ef86
Issue #19833 : Document more asyncio.BaseEventLoop methods
2013-12-02 12:41:54 +01:00
4e70bb84e6
Issue #19833 : add 2 examples to asyncio doc (hello world)
2013-12-02 12:21:30 +01:00
8dc434e092
Issue #19833 : asyncio doc: add class name to methods
2013-12-02 12:20:57 +01:00
5f5657ee50
(Merge 3.3) Issue #19728 : Fix sys.getfilesystemencoding() documentation
2013-12-02 12:17:29 +01:00
22d0418f71
Issue #19728 : Fix sys.getfilesystemencoding() documentation
2013-12-02 12:16:46 +01:00
e5b5edfa2c
Issue #19781 : ftplib now supports SSLContext.check_hostname and server name
...
indication for TLS/SSL connections.
2013-12-02 02:56:02 +01:00
1aa9a75fbf
Issue #19509 : Add SSLContext.check_hostname to match the peer's certificate
...
with server_hostname on handshake.
2013-12-02 02:41:19 +01:00
837a6e012f
Issue #19849 : selectors: Document the possibility of early select() wakeup upon
...
EINTR.
2013-12-01 13:23:48 +01:00
8b1e2f351d
Closes #19789 : Merged update from 3.3.
2013-11-30 22:46:29 +00:00
a9c179bd3e
Issue #19789 : Clarified documentation for logging.disable.
2013-11-30 22:45:29 +00:00
8519e5ade6
More realistic example for selectors.py.
2013-11-29 14:51:18 -08:00
a951f3d1ac
Remove trailing blanks.
2013-11-29 18:57:47 +01:00
a9f90bc602
Set the FDs non-blocking in the selectors example.
2013-11-29 18:52:51 +01:00
0e90e99188
Issue #19795 : Improved markup of True/False constants.
2013-11-29 12:19:53 +02:00
fbc1c26803
Issue #19795 : Improved markup of True/False constants.
2013-11-29 12:17:13 +02:00
b6e66ebdf7
Some minor clarifications in the documentation of pathlib + inheritance diagram
2013-11-28 06:53:05 -08:00
889d24ee3a
Revert unrelated changes introduced by changeset b2066bc8cab9 (issue #19795 ).
2013-11-29 23:40:35 +02:00
c034156f26
Change pathlib documentation to use "raise" instead of "throw".
2013-11-27 14:42:55 -08:00
5362abf4ec
Issue #19818 : tracemalloc, the number of frame limit cannot be zero anymore
2013-11-27 23:39:55 +01:00
3c0481d426
Close #19798 : replace "maximum" term with "peak" in get_traced_memory()
...
documentation. Use also the term "current" for the current size.
2013-11-27 21:39:49 +01:00
03cc56539f
Issue #19793 : Improved markup for True/False constants in pathlib documentation.
2013-11-26 21:37:12 +02:00
6bfe39272e
Issue #19794 : Improved markup for True/False constants.
2013-11-26 17:33:13 +02:00
22dc4d5fa8
Issue #19794 : Improved markup for True/False constants.
2013-11-26 17:32:16 +02:00
5831882c08
merge with 3.3
2013-11-26 08:25:45 +01:00
1833ac37b5
Markup fix.
2013-11-26 08:25:24 +01:00
8e3708d88b
Issue #18874 : allow to call tracemalloc.Snapshot.statistics(cumulative=True)
...
with traceback_limit=1
2013-11-26 00:45:47 +01:00
00773df9f3
Issue #18874 : apply Jim Jewett's patch on tracemalloc doc
2013-11-26 00:40:10 +01:00
c7cf5fca7c
Issue #19691 : remove outdated mention about RuntimeError
2013-11-25 19:11:07 +01:00
9527f16bf4
Issue #19691 : remove outdated mention about RuntimeError
2013-11-25 19:08:32 +01:00
d476ab1276
merge with 3.3
2013-11-25 08:52:24 +01:00
37b70bb908
Closes #19622 : clarify message about bufsize changes in 3.2.4 and 3.3.1.
2013-11-25 08:48:37 +01:00
db5e74fab3
Fix doc markup error.
2013-11-25 08:29:44 +01:00
fb310a9ec6
Merge broken link fix from 3.3.
2013-11-25 06:41:00 +02:00
f5005883ba
Fix broken link in html.entities docs.
2013-11-25 06:40:12 +02:00
ed007d5b1b
Fix suspicious markup in the docs.
2013-11-24 16:09:26 +01:00
a4b7a7548c
Issue #3158 : doctest can now find doctests in functions and methods
...
written in C.
As a part of this, a few doctests have been added to the builtins module
(on hex(), oct(), and bin()), a doctest has been fixed (hopefully on all
platforms) on float, and test_builtins now runs doctests in builtins.
2013-11-24 01:19:09 -06:00
d27b455bbc
Issue #13477 : Added command line interface to the tarfile module.
...
Original patch by Berker Peksag.
2013-11-24 01:53:29 +02:00
3a9079742f
Issue #19722 : Added opcode.stack_effect(), which accurately
...
computes the stack effect of bytecode instructions.
2013-11-23 14:49:22 -08:00
32eddc1bbc
Issue #16203 : Add re.fullmatch() function and regex.fullmatch() method,
...
which anchor the pattern at both ends of the string to match.
Original patch by Matthew Barnett.
2013-11-23 23:20:30 +02:00
3062c9a6c8
Issue #19641 : Added the audioop.byteswap() function to convert big-endian
...
samples to little-endian and vice versa.
2013-11-23 22:26:01 +02:00
6787a3806e
Issue #15204 : Deprecated the 'U' mode in file-like objects.
2013-11-23 22:12:06 +02:00
6bdd98622e
#10712 : 2to3 has a new "asserts" fixer that replaces deprecated names of unittest methods.
2013-11-23 21:14:42 +02:00
7571941db6
#19639 : update the repr of the match objects in the docs. Patch by Claudiu Popa.
2013-11-23 20:27:27 +02:00
c9dc4a2a8a
Issue #17810 : Implement PEP 3154, pickle protocol 4.
...
Most of the work is by Alexandre.
2013-11-23 18:59:12 +01:00
95401c5f6b
#13633 : Added a new convert_charrefs keyword arg to HTMLParser that, when True, automatically converts all character references.
2013-11-23 19:52:05 +02:00
be0c3250b1
Issue #19668 : Added support for the cp1125 encoding.
2013-11-23 18:52:23 +02:00
5bef410471
Tweak ssl docs
2013-11-23 16:16:29 +01:00
5de397e158
merge
2013-11-23 15:59:07 +01:00
4c05b472dd
Issue #19689 : Add ssl.create_default_context() factory function. It creates
...
a new SSLContext object with secure default settings.
2013-11-23 15:58:30 +01:00
235c5e0dd6
Issue #17201 : ZIP64 extensions now are enabled by default.
...
Patch by William Mallard.
2013-11-23 15:55:38 +02:00
6b2ff98df4
Correct documentation clientAuth -> CLIENT_AUTH
2013-11-23 14:42:01 +01:00
72d28500b3
Issue #19292 : Add SSLContext.load_default_certs() to load default root CA
...
certificates from default stores or system stores. By default the method
loads CA certs for authentication of server certs.
2013-11-23 13:56:58 +01:00
a30d82f597
Document create_connection
2013-11-23 13:55:35 +01:00
9a62a1987f
Start documenting the event loop
2013-11-23 13:10:08 +01:00
4d1046c7e6
Document asyncio transport APIs
2013-11-23 12:50:52 +01:00
3728d6ced0
Issue #18874 : Remove tracemalloc.set_traceback_limit()
...
tracemalloc.start() now has an option nframe parameter
2013-11-23 12:37:20 +01:00
ed3b0bca3e
Issue #18874 : Implement the PEP 454 (tracemalloc)
2013-11-23 12:27:24 +01:00
2427b50fdd
Issue #8813 : X509_VERIFY_PARAM is only available on OpenSSL 0.9.8+
...
The patch removes the verify_flags feature on Mac OS X 10.4 with OpenSSL 0.9.7l 28 Sep 2006.
2013-11-23 11:24:32 +01:00
9c1aed8f94
Close #7475 : Restore binary & text transform codecs
...
The codecs themselves were restored in Python 3.2, this
completes the restoration by adding back the convenience
aliases.
These aliases were originally left out due to confusing
errors when attempting to use them with the text encoding
specific convenience methods. Python 3.4 includes several
improvements to those errors, thus permitting the aliases
to be restored as well.
2013-11-23 11:13:36 +10:00
f8d0ff9f42
Add source link for asyncio.
2013-11-22 16:53:25 -08:00
74193af0cf
Finish protocol documentation
2013-11-23 01:21:11 +01:00
a035e1b000
Start documenting protocols
2013-11-23 01:08:43 +01:00
Brett Cannon
R David Murray
Zachary Ware
Antoine Pitrou
Guido van Rossum
Victor Stinner
Georg Brandl
Ezio Melotti
Yury Selivanov
Andrew Kuchling
Benjamin Peterson
Gregory P. Smith
Larry Hastings
Eli Bendersky
Brian Curtin
Nick Coghlan
Senthil Kumaran
Ethan Furman
Serhiy Storchaka
Ronald Oussoren
Vinay Sajip
Ned Deily
Eric Snow
Terry Jan Reedy
Martin v. Löwis
Michael Foord
Nadeem Vawda
doko@ubuntu.com
Christian Heimes
Alexandre Vassalotti
Charles-François Natali
Guido van Rossum