Issue #16206: Improve the documentation of the dict constructor.

This change includes replacing the single-line signature documentation
with a more complete multiple-line signature.

skip if __doc__ is gone

fix to work if __doc__ is removed

Fix links to the __next__ method.

Make doctests pass in the functional howto.

Improve markup in functional.rst, and fix a couple of errors.

Fix link to str.format() in docs.

Issue #16199: Fix typo in 2to3 docs. Thanks to Mark Lawrence for the report.

Fix #16176. Properly identify Windows 8 via platform.platform()

Add handling of the 6.2 release line, aka Windows 8 and Windows 2012 Server.

Fix placement of shell=True warning in subprocess.Popen() docs.

Issue #16115: Make further improvements to subprocess.Popen() documentation.

merge 3.2 heads

Issue #12947: revert earlier workaround and use a monkey-patch to enable showing doctest directives only in the doctest docs.

Fixes Issue #16114: The subprocess module no longer provides a
misleading error message stating that args[0] did not exist when
either the cwd or executable keyword arguments specified a path that
did not exist.

It now keeps track of if the child got as far as preexec and reports it if
not back to the parent via a special "noexec" error message value in
the error pipe so that the cwd can be blamed for a failed chdir
instead of the exec of the executable being blamed instead.

The executable is also always reported accurately when exec fails.

Unittests enhanced to cover these cases.

Issue #16174: Fix suggested usage of dummy_threading module.

Patch by Berker Peksag.

Fix Issue 15922: make howto/urllib2.rst doctests pass.
Patch by Chris Jerdonek. Address Ezio's review comment.

Issue #16168: Use specified socket type for domain sockets in SysLogHandler.

Issue #16115: Improve subprocess.Popen() documentation around args, shell, and executable arguments.

#13498: Clarify docs of os.makedirs()'s exist_ok argument.

Done with great native-speaker help from R. David Murray.

Issue #14783: Improve int() docstring and also str(), range(), and slice().

This commit rewrites the docstring for int() to incorporate the documentation
changes made in issue #16036.  It also switches the docstrings for int(),
str(), range(), and slice() to use multi-line signatures.

Issue #14900: Add aliases for sorting params for pstat to follow column names from pstat output.

Patch by Arne Babenhauserheide.

Issue #14900: Distuguish call count and primitive call count in pstat output.

Patch by Arne Babenhauserheide.

#9957: document that SpooledTemporaryFile.truncate does not take size arg

Closes #16149: remove now-false statement about the inability to compare Decimal and float objects.

revert accidental inclusion of subprocess tests

Issue #16025: Minor corrections to the zipfile documentation.

Patch by Serhiy Storchaka.

The file obj passed to ftp.storbinary/storlines must be opened in binary mode.

Issue #16138: fix typo.

#16112: platform.architecture does not correctly escape argument to /usr/bin/file. Fix original patch

#16112: platform.architecture does not correctly escape argument to /usr/bin/file. Use 'communicate()' and decode the bytes

Issue #14997: disable <F5> in idle shell window.

Thanks to Roger Serwy for patch.

Closes #16112: platform.architecture does not correctly escape argument to /usr/bin/file

Closes #15897: zipimport.c doesn't check return value of fseek(). Typo

Fix Misc/ACKS alphabetic order

Closes #15897: zipimport.c doesn't check return value of fseek()

Close open bracket, thanks to Josh Helzer from docs@

#15979: improve timeit documentation.

Fix sqlite3 class markup.

#15923: fix a mistake in asdl_c.py that resulted in a TypeError after 2801bf875a24 (see #15801).

Issue #15533: Skip test_cwd_with_relative_*() tests on Windows pending resolution of issue.

Issue #15533: Clarify docs and add tests for subprocess.Popen()'s cwd argument.

Speed up test_httpservers by avoiding a one-second cleanup wait after each test case.

merge heads

Fixes issue #15756: subprocess.poll() now properly handles errno.ECHILD
to return a returncode of 0 when the child has already exited or cannot
be waited on.

#16085: Don't promote shadowing builtins in the configparser example.

#16071: fix more email.message links in mailbox docs.

#16071: fix links to email.message.Message in mailbox docs.

Closes #15953: Incorrect some fields declaration in the PyTypeObject documentation

Close issue #16073: fix map() example in list comprehension documentation.

Thanks for the e-mail report to docs@.

Closes issue #12376 : Pass on parameters in unittest.TextTestResult.__init__ super call

Issue #16036: Improve documentation of built-in int()'s signature and arguments.

#15222: Insert blank line after each message in mbox mailboxes

#15222: test_mailbox: End message template in a newline

switch assertion to an explicit ValueError

fix test_compileall when run with -O[O]

use modern conditional syntax

- Issue #15935: Clarification of argparse docs, re: add_argument() type and
  default arguments.  Patch contributed by Chris Jerdonek.

Issue #16015: Make welcome message more realistic in tutorial example.

Issue #16013: Fix CSV Reader parsing issue with ending quote characters. Patch by Serhiy Storchaka.

Issue #16015: Fix NameError doctest example in tutorial introduction.

Issue #14167: restore statement about breaks in finally clauses.

#16019, #16020: fix syntax highlight.

#16017: capitalize URLs.

#16014: fix broken link.

Issue #16012: Fix a regression in pyexpat. The parser's UseForeignDTD()
method doesn't require an argument again.

Issue #15379: Fix passing of non-BMP characters as integers for the charmap decoder (already working as unicode strings).
Patch by Serhiy Storchaka.

#15949, #15899: use \ufffd instead of ?.

#15949, 15899: avoid using non-latin1 chars in the doc (they break `make all-pdf`).

#15421: fix an OverflowError in Calendar.itermonthdates() after datetime.MAXYEAR.  Patch by Cédric Krier.

#15304: fix wrong warning message in test.support.temp_cwd().

#15980: properly escape newlines in docstrings.  Patch by Serhiy Storchaka.

- Issue #11715: Fix multiarch detection without having Debian development
  tools (dpkg-dev) installed.

remove gdb noise about linux-vdso

Issue #15973: fixed 3.2 backport.

merge

Issue #15973: Fixed segmentation fault on timezone comparison to other types.

Issue 15959: Fix type mismatch for quick{_neg}_int_allocs.  Thanks Serhiy Storchaka.

Issue 15985: fix round argument names in documentation.  Thanks Chris Jerdonek.

Fix a few quotes/backslashes.

Fix markup in smtpd.rst.

Fix rst markup in timeit docs.

#15970: xml.etree.ElementTree now serializes correctly the empty HTML elements "meta" and "param".

Silence compiler warnings on Solaris 10 via explicit (void *) casts.

(Compiler: Solaris Studio 12.3)

#15796: Fix \n in readline docstring.  Patch by Serhiy Storchaka.

#11643: fix rst markup error in site.rst.

#15920: fix doctests in Doc/howto/regex.rst.  Patch by Chris Jerdonek.

Issue #15526: try to fix test_startfile's inability to clean up after itself in time.
Patch by Jeremy Kloth.

#15789: mention shell-like parts of the stdlib in the subprocess docs.  Patch by Chris Rebert.

#15932: use with statement in csv doc examples.  Patch by Dario Bertini.

Issue #15842: the SocketIO.{readable,writable,seekable} methods now raise ValueError when the file-like object is closed.
Patch by Alessandro Moura.

#15831: document multiple signatures on different lines.  Patch by Chris Jerdonek.

#15437, #15439: merge Doc/ACKS.txt with Misc/ACKS and modify Doc/about.rst accordingly.

Update merge from 2.7: s/basetring/str

A follow up for issue #15906: change the test for calling the type conversion
on the action's default, reverting it back to previous behavior.  Conversion
is only done on string defaults.

Add a test for this and another test that ensures such type conversions are
only called once.

Cleanup 'k' when the creation of PySTEntryObject fails. ad3824a90261 used to decref 'k' in too many error cases.

Partly revert ad3824a90261 and add comment about reference ownership

Fix out of bounds read in long_new() for empty bytes with an explicit base. int(b'', somebase) calls PyLong_FromString() with char* of length 1 but the function accesses the first argument at offset 1. CID 715359

- Issue #15906: Fix a regression in argparse caused by the preceding change,
  when action='append', type='str' and default=[].

#14617: clarify discussion of interrelationship of __eq__ and __hash__.

Fix null pointer dereferencing in structmember.c PyMember_SetOne() for T_CHAR. _PyUnicode_AsStringAndSize() can return NULL without touching the len argument. Also remove unnecessary PyUnicode_Check(), _PyUnicode_AsStringAndSize() performance the test again. CID 486815