Merge from 3.2: Issue #12531: add index entries to documentation of * and ** in function calls

Issue #12531: add index entries to documentation of * and ** in function calls

merge 3.2

remove duplicated type ready

merge heads

plug refleak

fixing the smtplib.rst whitespaces.

merge heads.

Fix closes Issue11281 - smtplib.STMP gets source_address parameter, which adds the ability to bind to specific source address on a machine with multiple interfaces. Patch by Paulo Scardine.

also make NotImplementedType callable

merge heads

make the types of None and Ellipsis callable

Issue #12626: In regrtest, allow to filter tests using a glob filter
with the `-m` (or `--match`) option.  This works with all test cases
using the unittest module.  This is useful with long test suites
such as test_io or test_subprocess.

Issue #12626: In regrtest, allow to filter tests using a glob filter
with the `-m` (or `--match`) option.  This works with all test cases
using the unittest module.  This is useful with long test suites
such as test_io or test_subprocess.

bytes -> bytearray

bytes should be verboten in sum() (fixes #12654)

Issue #12464: tempfile.TemporaryDirectory.cleanup() should not follow symlinks:
fix it. Patch by Petri Lehtinen.

Issue #12464: tempfile.TemporaryDirectory.cleanup() should not follow symlinks:
fix it. Patch by Petri Lehtinen.

Merge from 3.2 (#9254, #8982, #9788)

Document that atexit execution order is undefined (#9788)

Add a link target for argparse.Namespace (#8982)

Let the doc of __import__ link to importlib (#9254).

importlib.import_module eschews a number of issues that __import__ has.
Reviewed by Brett Cannon.  (The docstring of __import__ was already
updated in 3d490c3a019e, for #7397.)

Merge fix for #8887 from 3.2

Make “pydoc somebuiltin.somemethod” work (#8887)

Merge fix for reindent.py

Issue #10639: spec_newline wasn't defined globally unless main() was called; now spec_newline is set at module import/execution

Expand shlex.quote example (#9723)

Merge 3.2

Branch merge

Branch merge

Issue 12514: Use try/finally to assure that timeit restores GC when done.

Issue 12514: Use try/finally to assure that timeit restores GC when done.

Merge from 3.2: Issue #12644: document the '%a' conversion in the old string formatting operations. Patch prepared together with Ezio Melotti

Issue #12644: document the '%a' conversion in the old string formatting operations. Patch prepared together with Ezio Melotti

Issue #12380: PyArg_ParseTuple now accepts a bytearray for the 'c' format.
As a side effect, this now allows the rjust, ljust and center methods of
bytes and bytearray to accept a bytearray argument.

Patch by Petri Lehtinen

Change one line I missed in 7527f3f9829

Minor packaging cleanup.

- Use shortcut dist.version instead of going through metadata;
- Use %r throughout to display project names and paths.

Make TypeError message from Command.__init__ more useful

Let all pysetup actions return a meaningful 0 or 1 exit code (#12222).

This will help scripts calling pysetup know if a command failed.
Printing/logging was also made more consistent, and a few things were
cleaned up.  In particular, the error/Ctrl-C handling was moved from the
_run function up to the main function.

The run action is not fixed yet; it returns the dist.Distribution
instance, which is needed by test_uninstall and not trivial to fix.

Let pysetup list exit with a non-zero code when no result is found (#11409).

“pysetup list” or “pysetup list --all” will continue to return 0 if no
distribution is found (it’s not an error), but “pysetup list
some.project” will now exit with 1 if no matching installed distribution
is found.  Based on a patch by Kelsey Hightower.

Merge from 3.2 (#10318, #12255, #12043, #12417 and other fixes)

Modernize modulefinder module and tests a bit.

The tests don’t use an internal distutils function anymore, and use
regular assertEqual with sorted lists instead of a convoluted manual
diff.

Fix reST role and missing word

Branch merge

Merge profile docs followup (#12417) from 3.1

Remove mentions of previous license in profile module docs (#12417 followup).

Also remove an extra docstring.

Turn raw URI into real link

Update documentation for shutil.move (#12043) and fix a few typos.

Adding Sandro Tosi to Doc/ACKS for this patch and all his work on the
docs mailing list and on the bug tracker.

Stop ignoring Mercurial merge conflits files (#12255).

R. David Murray and I think that it’s more useful to have these files
show up in the output of “hg status”, to let the user know that some
merged file have to be checked before commit.  If you want to ignore
these files in your clones, it’s possible to do so from another ignore
file; see the bug report for directions.

I’m leaving the .gitignore file alone, as I don’t know how git users
work with merges and conflicts.

Make VCSes ignore the compiled shared library file (#12255)

Issue 12647: Add __bool__() method to the None object.

merge from 3.2 - Fix closes Issue11439 Remove the SVN keywords from the code as it is no longer applicable in hg. Patch Contributed by Neil Muller.

Fix closes Issue11439 Remove the SVN keywords from the code as it is no longer applicable in hg. Patch Contributed by Neil Muller.

Remove indirection in threading (issue #10968).

The public names (Thread, Condition, etc.) used to be factory functions
returning instances of hidden classes (_Thread, _Condition, etc.),
because (if Guido recalls correctly) this code pre-dates the ability to
subclass extension types.

It is now possible to inherit from Thread and other classes, without
having to import the private underscored names like multiprocessing did.

A doc update will follow: a patch is under discussion on the issue.

Issue #11871: In test_threading.BarrierTests, bump the default barrier timeout
to avoid timing-dependent failures.

Issue #11871: In test_threading.BarrierTests, bump the default barrier timeout
to avoid timing-dependent failures.

Issue #12603: Fix pydoc.synopsis() on files with non-negative st_mtime.

Issue #12603: Fix pydoc.synopsis() on files with non-negative st_mtime.

fix doc typo for library/test.rst

Issue #11049: added test_support to regrtest.STDTESTS list

Add shlex.quote function, to escape filenames and command lines (#9723).

This function used to live as pipes.quote, where it was undocumented but
used anyway.  (An alias still exists for backward compatibility.)  The
tests have been moved as is, but the code of the function was changed to
use a regex instead of a loop with string comparisons (at Ian Bicking’s
suggestion).  I’m terrible at regexes, so any feedback is welcome.

merge from 3.2 - Fix closes Issue12621 - Fix docstrings of find and rfind methods of bytes/bytearry/unicodeobject.

Fix closes Issue12621 - Fix docstrings of find and rfind methods of bytes/bytearry/unicodeobject.

Issue #12607: Merge with 3.2.

Issue #12607: In subprocess, fix issue where if stdin, stdout or stderr is
given as a low fd, it gets overwritten.

merge from 3.2 - Correcting issue 12576 fix, which resulted in buildbot failures.

Correcting issue 12576 fix, which resulted in buildbot failures.

Issue #12590: IDLE editor window now always displays the first line
when opening a long file.  With Tk 8.5, the first line was hidden.

Issue #12590: IDLE editor window now always displays the first line
when opening a long file.  With Tk 8.5, the first line was hidden.

merge from 3.2 - Fix closes Issue12576 - fix urlopen behavior on sites which do not send (or obsfuscates) Connection: Close header.

Fix closes Issue12576 - fix urlopen behavior on sites which do not send (or obsfuscates) Connection: Close header.

Actually port ecfe9bf0117b to default
(I had the wrong impression that the problem didn't exist here)

Null merge

When testing for an hg repo, use a file that always exists, even with the "shared" extension

Null merge

Backport 0398f07d4827 (fix for weird buildbot failures)

Try to fix weird buildbot failures

Issue #8746: Use tempfile module to get tempdir and randomize the
link file name.

Issue #8746: Use tempfile module to get tempdir and randomize the
link file name.

Branch merge.

I moved the NEWS entry for the reindent fix to the right release section.

Fix missing or wrong shebangs and missing executable bits for scripts (#10318)

Issue #10639: reindent.py tool now accepts a --newline option to specify the newline to be used in the output of converted files.

Merge with 3.2 Issue #10639: reindent.py should not convert newlines.
reindent.py now will use the newline detected in the original file and will report an error if mixed newlines are encountered.

Fix string exception and a few style issues in mailerdaemon script

Fix sorting or wording of some NEWS entries.

I would have put io and ctypes fixes into Extension Modules, but I
respected the choice of Antoine or Victor and left them in Library.

Fix style in code added by edba722f3b02

Fixes #10639: reindent.py should not convert newlines
reindent.py now will use the newline detected in the original file and will report an error if mixed newlines are encountered.

Make indentation comply with our style guide and the rest of the file

Fix “anyways” (following R. David Murray in 4d5a546b6186)

Fix reST references

Remove duplicates of cmp_to_key (#12542, reviewed by Raymond Hettinger)

Add debug output for failing buildbot

#12547: Fix example in nntplib doc. Patch by July Tikhonov.

Fixes #12637: Merged fix from 3.2 and added test.

Fixes #12637: Last resort messages now correctly handled. Thanks to Xavier de Gaye for the patch."

Issue #11784: Improve multiprocessing.Process.join() documentation. Patch by
Patrick Sabin.

Issue #12102: Merge with 3.2.

Issue #12102: Document that buffered files must be flushed before being used
with mmap. Patch by Steffen Daode Nurpmeso.

Issue #12560: Build libpython.so on OpenBSD. Patch by Stefan Sperling.

Issue #12560: Build libpython.so on OpenBSD. Patch by Stefan Sperling.