56d3a03f70
Update doc version switcher for 3.4/3.5.
2014-03-17 07:36:45 +01:00
3c5c56f3c0
Merged default into 3.4 branch. 3.4 branch is now effectively 3.4.1rc1.
2014-03-16 22:54:05 -07:00
2221f666eb
merge 3.3 ( #11448 )
2014-03-16 15:56:24 -05:00
a48d9eaa5c
improve set_tunnel docs ( closes #11448 )
...
Patch by Ryan Kelly, karl, and Nikolaus Rath.
2014-03-16 15:55:39 -05:00
7bdf786e74
Issue #20950 : Fix typo asyncio doc, wait() has no self parameter
...
self parameter is implicit. Mention also that communicate() and wait() are
coroutines.
2014-03-16 21:29:31 +01:00
3101b70762
Final documentation fixes for 3.4.0 final.
2014-03-15 22:43:17 -07:00
cf1a3cd2c7
Release bump for 3.4.0 final.
2014-03-15 22:34:24 -07:00
0548f5c514
Regenerate pydoc_topics, fix markup errors, in preparation for 3.4.0 final.
2014-03-15 22:29:19 -07:00
3732ed2414
Merge in all documentation changes since branching 3.4.0rc1.
2014-03-15 21:13:56 -07:00
ffa1f27950
Bring PEP 453 What's New entry up to date
...
We changed a few details of the pip integration over the course
of the Python 3.4 beta and release candidate cycle, but I hadn't
updated the What's New entry appropriately.
The Py2/Py3 split on POSIX and the generally challenges of
dealing with parallel installs means we haven't attained
complete consistency across all environments, but hopefully
this updated text is clearer about the end result.
Relevant to issue #20909 .
2014-03-16 13:55:19 +10:00
01f2129249
whatsnew: Fix Features section title, use title/sentence case consistently.
...
closes #20931
2014-03-15 23:27:30 -04:00
34784e6bf7
Issue #20931 : Fix other confusingly-worded heading.
2014-03-15 20:15:55 -07:00
8bc7ef63a4
Close #16665 : improve documentation for hex(). Patch by Jessica McKellar.
2014-03-16 02:13:07 +01:00
d5358b94d1
whatsnew: Clarify heading.
2014-03-15 21:15:18 -04:00
790bf0db77
Close #16665 : improve documentation for hex(). Patch by Jessica McKellar.
2014-03-16 02:12:20 +01:00
bbd392e9e2
merge 3.3
2014-03-15 15:24:10 -05:00
0392271073
send people to the right editors page ( #20938 )
2014-03-15 15:23:32 -05:00
b69c0c16cd
whatsnew: final edit pass.
2014-03-14 18:31:07 -04:00
f0b2ef1502
Issue #20884 : whatsnew: Frozen modules don't set __file__ anymore.
2014-03-14 09:46:28 -04:00
a0b9eeb66d
whatsnew: link from module_spec section to Deprecation, for replacements.
2014-03-13 22:17:28 -04:00
6dfc632f1f
whatsnew: difflib.isbjunk &c were removed, not deprecated.
...
Also move NEWS item to correct position (it was in 3.3).
2014-03-13 21:34:54 -04:00
d664db8a7b
whatsnew: difflib.isbjunk &c were removed, not deprecated.
...
Also move NEWS item to correct position (it was in 3.3).
2014-03-13 21:34:54 -04:00
44b03c5bf0
whatsnew: small tweaks to codecs entry.
2014-03-13 20:56:27 -04:00
bcf7012d19
whatsnew: linkify some pip things, and explain why non-inheriting is good.
2014-03-13 19:53:38 -04:00
f446d7a70b
Remove references to make targets deleted in eef7899ea7ab
2014-03-13 19:30:43 -04:00
7bf50318bd
Clarify distutils’ clean command (ref #6142 )
2014-03-13 18:32:18 -04:00
ef04c59f53
Clarify distutils’ clean command (ref #6142 )
2014-03-13 16:17:11 -04:00
a85e100b4d
Issue #19407 : Fix typos in new distribution & installation guides.
...
Also applies to cherry pick Issue #20909 .
2014-03-13 12:42:36 -07:00
66646e2ea4
whatsnew: remove 'draft' note, tidy up summary, collect SSLContext stuff.
...
Since Victor linked to it in a block, it seems to make sense to have
all the SSLContext changes next to each other. I also sorted all the
SSL security enhancements next to each other in the security
enhancements summary.
2014-03-13 14:36:09 -04:00
d73721a7e4
whatsnew: collections no longer implicitly imports 'abc' ( #20784 ).
2014-03-13 12:00:17 -04:00
b895505625
whatsnew: HTTPError.headers ( #15701 ).
2014-03-13 11:33:29 -04:00
5253034c78
whatsnew: make it clear I'm the editor, not author of all text.
2014-03-13 11:10:01 -04:00
45fc8713bd
Make distutils error messages more helpful ( #11599 ).
...
When running external programs such as a C compiler and getting an
error code, distutils only prints the program name. With this change,
one can get the full command line by setting the DISTUTILS_DEBUG
environment variable.
This should have no compatibility issues, unless there are tools
that depend on the exact format of distutils debug messages.
2014-03-13 04:55:35 -04:00
21317b654e
merge 3.3 ( #19060 )
2014-03-12 21:42:04 -05:00
5eea8a7780
remove unnecessary word ( closes #19060 )
...
Patch by Anastasia Filatova.
2014-03-12 21:41:35 -05:00
fa5e6e4773
Fix note markup ( #16805 ).
...
Patch by Tshepang Lekhonkhobe, reviewed by Georg Brandl.
2014-03-12 19:51:00 -04:00
40e1ffc78e
whatsnew: fix unittest subtest example.
2014-03-12 09:31:50 -04:00
97c3642532
What's New in Python 3.4: more security changes
2014-03-13 14:54:46 +01:00
e300797ca4
Issue #19407 : fix link
2014-03-13 22:33:33 +10:00
f7614d55a2
Close #19407 : New installation & distribution guides
...
- based on pip and other PyPA tools
- includes references to the new Python Packaging User Guide
where appropriate (and the relevant section is at least
partially filled in)
- started new FAQ sections
- both guides aim to introduce users to basic open source
concepts if they aren't aware of them
- existing guides have been relocated (now linked from the
distutils docs) rather then removed, since there is
some needed material that has yet to be relocated to the
distutils docs as a reference for the legacy formats
2014-03-13 22:13:45 +10:00
9e0622713e
Merge heads
2014-03-13 06:02:15 -04:00
f1e8c70cf0
Merge 3.3 ( #11599 )
2014-03-13 05:59:31 -04:00
2fb3b82706
asyncio doc: functions are coroutine, they don't return a coroutine
...
It's not exact, but easier to understand.
2014-03-13 10:58:03 +01:00
39930c9ca0
Close #20889 : asyncio doc: Document acquire(), locked() and release() method of
...
Condition
2014-03-13 10:54:18 +01:00
d079d3a289
Close #20787 : asyncio doc: fix typo. Patch written by akira.
2014-03-13 10:50:01 +01:00
605765fa32
merge 3.3 ( #19060 )
2014-03-12 21:42:04 -05:00
abdc16ee1b
Merge 3.3 ( #16805 )
2014-03-12 19:51:50 -04:00
a0fe1f74f9
Merge 3.3 ( #4931 )
2014-03-12 04:10:51 -04:00
fc773a2d4b
Avoid “error: None” messages from distutils ( #4931 ).
...
Thanks to Amaury Forgeot d’Arc and Philip J. Eby.
2014-03-12 03:34:02 -04:00
03a4da55cb
whatsnew: spelling errors.
...
Corrections from Jim Jewett in #19861 .
2014-03-11 21:58:54 -04:00
600e08dc1c
Merge #20030 : doc that TestLoader.discover returns a TestSuite.
2014-03-11 18:46:37 -04:00
ed5d95b76b
#20030 : doc that TestLoader.discover returns a TestSuite.
...
Patch by Lita Cho.
2014-03-11 18:46:00 -04:00
86deec1917
merge 3.3
2014-03-11 14:26:21 -05:00
8e4b3c7f55
improve algorithms_* documentation
2014-03-11 14:26:12 -05:00
f4ce4170ef
whatsnew: doctest finds tests in extension modules ( #3158 )
...
#19861 msg213159
2014-03-11 15:10:53 -04:00
162d7ca3cc
merge 3.3 ( closes #20892 )
2014-03-11 13:59:48 -05:00
bfca3ca114
fix typo ( closes #20892 )
2014-03-11 13:59:37 -05:00
49bef7b3eb
whatsnew: mention that upgrading PIP means it doesn't get unistalled.
...
#19861 msg213156.
2014-03-11 14:57:30 -04:00
6cd3a0d598
whatsnew: summary section tweaks.
...
Removed an entry made redundant by the new security section,
Moved 'marshal' to the section on features other platforms
will need to support, and mention that 'help' is improved
by the inspect/pydoc changes (#19561 msg213153).
2014-03-11 14:03:24 -04:00
11a4270b6a
What's New in Python 3.4: Security improvements
2014-03-11 13:17:30 +01:00
637d2e9296
Issue #20888 : improve "Pretty Top" example of tracemalloc, use linecache
2014-03-11 08:12:48 +01:00
0c18282da6
whatsnew: remove XXXs.
...
Can't figure out what the other issue was for the importlib
changes. Did find a small typo in the reload doc, though.
2014-03-10 21:38:37 -04:00
4896ebee1f
whatsnew: take credit.
...
They aren't all my words, but most of them are :).
2014-03-10 18:15:09 -04:00
9ea2a630fe
whatsnew: deprecation of ElementTree XMLParser *html* and iterparse *parser*.
...
#17741
2014-03-10 18:09:54 -04:00
30781e93b0
whatsnew: urllib Request objects are now reusable.
...
#16464 , #17485 , #17272 .
2014-03-10 17:06:00 -04:00
0c5598beaf
whatsnew: shutil copyfile SameFileError ( #1492704 )
2014-03-10 16:12:10 -04:00
8df4ec70d3
whatsnew: os.open O_PATH and O_TMPFILE.
2014-03-10 15:48:22 -04:00
a69bb5cc48
whatsnew: os.open O_TMPFILE ( #18673 ).
2014-03-10 15:41:59 -04:00
60de1a0fd5
whatsnew: json dump-with-indent whitespace change ( #16333 ).
2014-03-10 15:41:28 -04:00
e8db162f62
whatsnew: PEP 424 implementation.
2014-03-10 15:00:33 -04:00
d840b8d613
whatsnew: multiprocessing start methods and context ( #8713 and #18999 )
...
Also tweaked the docs a bit to use our standard style for
versionadded/changed. (I'm guessing there are other places
in the multiprocessing docs where similar tweaks should be made.)
2014-03-10 14:27:21 -04:00
18a364fc3d
Closes #20090 : update Doc/README and the error message in sphinx-build.py to make
...
it clear that any Python 3.x is not usable with the checked out Sphinx.
2014-03-10 19:26:57 +01:00
f2e677cec9
whatsnew: remove redundant entry.
2014-03-10 13:21:09 -04:00
c51ebce03b
whatsnew: logging.config.listen *verify* ( #15452 ).
2014-03-10 12:03:01 -04:00
416616fc6f
whatsnew: logging.fileConfig accepts ConfigParser instances. ( #16110 )
...
And missing NEWS entry.
2014-03-10 11:51:19 -04:00
c5f5d69517
whatsnew: total_ordering supports NotImplemented ( #10042 )
2014-03-10 11:02:45 -04:00
a6ea7a3c8f
whatsnew: filecmp.DEFAULT_IGNORES ( #15442 )
2014-03-10 10:47:56 -04:00
c08383633a
whatsnew: Message.set_param *replace*, Policy.content_manager.
...
Also cleaned up the email section and fixed some markup bugs in the
email docs.
2014-03-10 10:08:05 -04:00
c51eaf5ca0
whatsnew: ChainMap.new_child *m* argument.
...
And NEWS entry.
2014-03-10 09:49:19 -04:00
02e77d17fa
Closes #20090 : update Doc/README.txt for the changes in the 3.4 branch.
2014-03-10 19:31:52 +01:00
b6111f5529
Remove unused sphinx-build.py entry script.
2014-03-10 19:10:29 +01:00
fa06047af1
whatsnew: add porting note for pyvenv --without-pip.
2014-03-10 09:20:37 -04:00
dcbd83321b
whatsnew: tarfile cli ( #13477 ).
2014-03-09 21:19:57 -04:00
7ad765169c
whatsnew: dis.stack_effect ( #19722 ).
2014-03-09 21:07:37 -04:00
9561ce2f0f
whatsnew: oops, create_default_context doesn't return what the stdlib uses.
2014-03-09 21:00:14 -04:00
b5ac4d7eaa
whatsnew: expand re.fullmatch entry with the motivation for the feature.
2014-03-09 20:52:28 -04:00
ced82ef752
whatsnew: give Hugo credit for his preliminary work on regex patch.
2014-03-09 20:46:32 -04:00
2177be2c3a
whatsnew: auidioop.byteswap ( #16685 ).
2014-03-09 20:42:49 -04:00
0cf177205c
whatsnew: porting note for sysconfig 'SO' key deprecation.
2014-03-09 20:39:52 -04:00
c38f89146d
whatsnew: 'U' mode deprecation ( #15204 ).
2014-03-09 20:33:35 -04:00
98a6738dca
whatsnew: cp1125 codec ( #19668 ).
2014-03-09 20:13:16 -04:00
f20cfb2081
whatsnew: ssl.create_default_context ( #19689 ).
2014-03-09 19:58:17 -04:00
e7fa1204e2
whatsnew: allowZip64 defaults to True ( #17201 ).
2014-03-09 19:57:19 -04:00
01e6accd19
whatsnew: SSLContext.load_default_certs ( #19292 ).
2014-03-09 19:41:25 -04:00
f3b3e9e23c
whatsnew: pdb works for debugging asyncio programs ( #16596 ).
2014-03-09 19:40:30 -04:00
6ae5eef542
Merge #19953 : Clarify the wording of the augmented assignment discussion.
2014-03-09 18:51:35 -04:00
14d7b718ba
#19953 : Clarify the wording of the augmented assignment discussion.
...
Patch by Priya Pappachan, based on suggestions from Terry Reedy
and myself.
2014-03-09 18:51:16 -04:00
c402577056
whatsnew: venv with_pip, pyvenv --without-pip ( #19552 )
2014-03-09 18:09:51 -04:00
2450c1d54a
whatsnew: more accurate deprecation section titles.
2014-03-09 17:13:31 -04:00
336fd7f788
whatsnew: deprecation of sysconfig SO key ( #19555 ).
2014-03-09 17:11:00 -04:00
6978722828
whatsnew: SSLContext.verify_flags and constants. ( #8813 )
2014-03-09 17:01:34 -04:00
1d342b2e8b
whatsnew: plistlib new api and deprecations ( #14455 )
...
Also fixed the versionchanged/deprecation tags in the docs.
2014-03-09 15:09:04 -04:00
2dd0473722
whatsnew: SSLSocket.getpeercert new values returned. ( #18379 )
2014-03-09 12:55:58 -04:00
4e40cec924
whatsnew: sys.__interactivehook__. ( #5845 )
...
I decided to leave the (slightly expanded) Other Improvements
entry as well, since someone looking for command line behavior
changes isn't going to look in the 'sys' module section.
2014-03-09 12:03:30 -04:00
04ea3f35bd
whatsnew: SSLcontext.load_verify_locations cadata argument ( #18138 )
2014-03-08 23:19:45 -05:00
e6bd31ea92
whatsnew: hmac conforms to pep 247. ( #18775 )
2014-03-08 23:18:09 -05:00
3d234837ed
whatsnew: hmac *digestmod* accepts strings, and default is deprecated. ( #17276 )
2014-03-08 22:43:12 -05:00
958e4da660
whatsnew: tidy up html notes, add porting note for expand_charrefs.
2014-03-08 21:40:29 -05:00
1cd0e85d01
whatsnew: glob.escape.
2014-03-08 21:23:21 -05:00
c210de1ea1
whatsnew: base65 encodings. ( #17618 )
...
Also updated the base64 module title and introduction to adjust for
the fact that these new encodings are included.
Also adjusted the wording about the base64 alphabets (see
issue #20837 ).
2014-03-08 12:53:28 -05:00
9bd6a37df2
whatsnew: dbm.open is context manager. ( #19282 )
2014-03-08 12:00:52 -05:00
cbf479ae64
whatsnew: sunau/aifc/wave writeframes[raw] accept any bytes-like ( #8311 )
2014-03-08 11:46:05 -05:00
5d6240e871
whatsnew: Wave_write handles unseekable files. ( #5202 )
...
Also clarify the documentation of this feature.
2014-03-08 11:14:29 -05:00
1635578d5f
Improve descriptions of introspection changes
...
Several of the introspection changes in Python 3.4 are indirect,
where inspect module changes affected pydoc, and those in turn
affected the help builtin. This update adds versionchanged
notes in the key locations, as well as more coverage in the
What's New document (in particular, a note in the porting
section regarding the expanded domain for inspect.getfullargspec).
2014-03-08 16:36:37 +10:00
8591563628
whatsnew: audioop accepts any bytes-like, rejects strings.
2014-03-07 21:35:31 -05:00
6c50101fc9
whatsnew: inet_pton/inet_ntop support windows ( #7171 ).
...
Added versionchanged to docs.
2014-03-07 21:22:39 -05:00
99e1bfad09
whatsnew: sunau supports 24 bit samples.
2014-03-07 21:15:56 -05:00
c4c7b1ccb6
whatsnew: cp273 codec ( #10907797 )
...
Also updated the docs and added the aliases mentioned by the
references.
2014-03-07 21:00:34 -05:00
a3188ef476
Update pydoc topics and suspicious filters.
2014-03-09 04:12:12 -07:00
47d083cf1a
whatsnew: cp273 codec ( #10907797 )
...
Also updated the docs and added the aliases mentioned by the
references.
2014-03-07 21:00:34 -05:00
e2684d93e2
whatsnew: get[status|output] works on windows.
...
Since 3.3.4.... :(
2014-03-07 20:06:24 -05:00
48b6b70b95
#10197 : Update get[status]output versionchanged with actual version.
...
This was perhaps on the border between a bug fix and a feature since
the Python3 docs did not originally say it was unix only. However, the
functions never worked anywhere but unix, and the docs were changed to
say it was unix only well before the windows support was added.
Unfortunately, windows support was added in 3.3.4 as well as 3.4.
That leaves us in the uncomfortable position of needing the tag to say
"version changed: 3.3.4" :(
2014-03-07 20:04:41 -05:00
95b696a010
#10197 : Update get[status]output versionchanged with actual version.
...
This was perhaps on the border between a bug fix and a feature since
the Python3 docs did not originally say it was unix only. However, the
functions never worked anywhere but unix, and the docs were changed to
say it was unix only well before the windows support was added.
Unfortunately, windows support was added in 3.3.4 as well as 3.4.
That leaves us in the uncomfortable position of needing the tag to say
"version changed: 3.3.4" :(
2014-03-07 20:04:17 -05:00
c39e892955
Issue #20813 : Backport Python 2/3 HOWTO updates
2014-03-07 12:28:35 -05:00
6634e15d77
Issue #20812 : Add a short opener to the Python 2/3 porting HOWTO.
...
Thanks to Nick Coghlan for the suggestion.
2014-03-07 12:27:10 -05:00
beec02ac06
whatsnew: note in deprecation section about html.parser strict.
2014-03-06 13:40:53 -05:00
393c8f36ef
whatsnew: rewrite resource entry: prlimit and new constants.
2014-03-06 12:47:31 -05:00
6674ac0873
whatsnew: ipaddress is_global
...
Also tweaked the docs a bit and added the missing entry for
the ipv6 is_global.
2014-03-06 11:51:37 -05:00
83db8fc3cc
whatsnew: improve PyZipFile filterfuc entry, and its docs ( #19274 ).
2014-03-05 10:48:01 -05:00
62b4b9eecb
Close #20839 : pkgutil.find_loader now uses importlib.util.find_spec
2014-03-04 20:39:42 +10:00
01cc2d5fb8
Issue20653: fix ReST for Enum
2014-03-03 15:02:04 -08:00
2da950460d
Close issue20653: improve functional API docs; minor code changes
2014-03-03 12:42:52 -08:00
04edfdf320
whatsnew: tweak a couple importlib porting notes.
...
I had missed that there was already an entry for the Frozen package change, so
I combined mine with the existing one. Also added the info about the reload
change to the entry for the other changes to reload, but I'm missing an issue
number for the rest of the attribute behavior changes so I left myself an
XXX as a reminder to find it.
2014-03-03 08:56:43 -05:00
66902edf23
whatsnew: Windows build uses ASLR and DEP.
2014-03-03 08:26:49 -05:00
dc855b7b1f
Close #20839 : pkgutil.find_loader now uses importlib.util.find_spec
2014-03-04 20:39:42 +10:00
c913a7a6f6
Issue20653: fix ReST for Enum
2014-03-03 15:02:04 -08:00
9c45444727
Close issue20653: improve functional API docs; minor code changes
2014-03-03 12:42:52 -08:00
adb2e2ab64
Close #20814 : doc: Fix "Pretty top" example of tracemalloc
2014-03-03 11:57:57 +01:00
f70200e5a9
Close #20814 : doc: Fix "Pretty top" example of tracemalloc
2014-03-03 11:57:57 +01:00
8be77910be
whatsnew: add some issue number annotations.
...
Add issue number to tick_counter, PyOS_ReadlineFunctionPointer, marshal
optimizations (add Antoine's contribution to the entry under the marshal
module), and absolute paths in __file__.
2014-03-02 17:14:33 -05:00
db8843f36e
whatsnew: memoryview is Sequence and supports Reversed.
2014-03-01 12:09:55 -05:00
9c0c101ee4
whatsnew: unittest discover works on namespace packages ( #17457 ).
...
I also added the docs that never got committed, editing the patch provided by
Claudiu.
I collapsed the now three versionchanged directives for discovery into one. I
tried several different styles for this. The most obvious is a bulleted list,
but currently the only way I could find to produce that is to have *something*
appear on the versionchanged line after the colon, which combined with the
blank space before the bulleted list just looks wrong. I also tried the
current single-line-three-sentences version with bullet characters before each
sentence, and I almost went with that as it made it clear that the three
sentences are independent. But I decided to just go with the sentences for
simplicity reasons.
2014-03-01 11:57:58 -05:00
8ab50214bd
whatsnew: give Serhiy credit for audioop 24-bit sample support.
2014-02-28 13:30:27 -05:00
0bec63e67d
whatsnew: compression libraries support 'x' mode.
2014-02-27 20:05:42 -05:00
4b1ea234a0
whatsnew: tarfile stat constants removal.
2014-02-27 18:55:34 -05:00
ecef6cd2f1
whatsnew: return types of re functions.
2014-02-27 18:32:32 -05:00
98f2bbf794
#16135 : remove mentions of OS/2 from the documentation
2014-03-01 07:53:28 -05:00
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
9251d59523
whatsnew: expand pbkdf2_hmac entry slightly.
2014-02-26 13:07:21 -05:00
Georg Brandl
Larry Hastings
Benjamin Peterson
Victor Stinner
Nick Coghlan
R David Murray
Antoine Pitrou
Brett Cannon
Éric Araujo
Ned Deily
Ethan Furman
Andrew Kuchling