Improve byte-compilation in packaging to be independent of -O or -B.

The code I fixed to comply with PEP 3147 still had one bug: When run
under python -O, some paths for pyc files would be pyo, because I called
imp.cache_from_source without explicit debug_override argument in some
places, and under -O that would return .pyo (this is well explained in
the imp docs).  Now all code (util.byte_compile, build_py, install_lib)
can create .pyo files according to options given by users,
without interference from the calling Python’s own optimize mode.

On a related topic, I also removed the code that prevented byte
compilation under python -B.  The rationale is that packaging gives
control over the creation of pyc files to the user with its own explicit
option, and the behavior should not be changed if the calling Python
happens to run with -B for whatever reason.  I will argue that this is a
bug fix and ask to be allowed to backport this change to distutils.

Finally, I moved one nugget of information about the --compile and
--optimize options from the source into the doc.  It clears up a
misunderstanding that I (and maybe other people) had.

Minor code reorganization in one packaging test file

Fix typo “seperate”

Fix typos in recent NEWS entries

Introduce PyObject* API for raising encode errors.

Issue #13312: skip the failing negative years for now.

Actually, there's more than one failing value. (changeset 9cb1b85237a9, issue #13312).

Issue #13312: skip the single failing value for now.

Replace Py_UNICODE_strchr with PyUnicode_FindChar.

Additional tests for negative years.

Merge 3.2: issue #2892

Closes #2892: preserve iterparse events in case of SyntaxError.

Merge test improvements from 3.2.

Make sure that the tolerant parser still parses valid HTML correctly.

Lowercase the test name, to run last.

Replace temporary tests with the real test case for issue #13309 on Gentoo.

'HTTPSHandler' and not the type.

Append HTTPSHandler to __all__ when it is available.

issue13287 - Define __all__ for urllib.request and urllib.error and expose only
the relevant module. Other cleanup improvements. Patch by flox.

Troubleshoot issue #13309 on Gentoo buildbot.

Add temporary tests to troubleshoot issue #13309 on Gentoo buildbot.

Test the year range supported by time.strftime() and time.asctime().

Merge test fixes from 3.2.

Avoid reusing the same collector in the tests.

#12008: merge with 3.2.

#12008: add a test.

#670664: Fix HTMLParser to correctly handle the content of ``<script>...</script>`` and ``<style>...</style>``.

correct signature for tzinfo.dst() in examples; thanks to Daniil Shved from docs@

Issue #13304: Skip test case if user site-packages disabled (-s or
PYTHONNOUSERSITE).  (Patch by Carl Meyer)

Fix issue 10817 - Fix urlretrieve function to raise ContentTooShortError
even when reporthook is None. Patch by Jyrki Pulliainen.

use diveintopython.net now that DIP.org returns 410; thanks to Josh Gachnang from docs@

remove confusing paragraph (as part of r87523); thanks to AJ Hill from docs@

Closes #13283: removal of two unused variable in locale.py

document turtle done() function; thanks to Csaba Szepesvari from docs@

Issue 13296: Fix IDLE to clear compile __future__ flags on shell restart.
(Patch by Roger Serwy)

caught is the right pp of catch; thanks to Don Bennett from docs@

Improve itertools docs with clearer examples of pure python equivalent code.

Issue 13274:  Make the pure python code for heapq more closely match the C implementation for an undefined corner case.

Merge heads

Issue #13293: Better error message when trying to marshal bytes using xmlrpc.client.

Cleanup xmlrpc: remove obsolete comments, unused imports. Add test for bytes marshalling.

Closes #13291: NameError in xmlrpc package.

Add Misc/NEWS entry for issue #10519

remove unused variable

Issue #10363: Deallocate global locks in Py_Finalize().

Fix the return value of set_discard (issue #10519)

Avoid unnecessary recursive function calls (closes #10519)

Add a button to the code examples in the doc to show/hide the prompts and output.

#13289: fix typo.

bring is_integer into tested existence

- Issue #13218: Fix test_ssl failures on Debian/Ubuntu.

- Issue #13218: Fix test_ssl failures on Debian/Ubuntu.

Documentation typo

I should be someone

Remove unused variable.

Closes #13258: Use callable() built-in in the standard library.

Improve HTMLParser example in the doc and fix a couple minor things.

#13273: fix a bug that prevented HTMLParser to properly detect some tags when strict=False.

Merge heads.

#13278: fix typo.

Fixes #13270: obsolete reference to old-style/new-style classes.

Added lost documentation cross-reference.

Issue #10860: Skip the new test if HTTPS is not available

Refactor a bit the codecs doc.

Fix typo.

merge heads

document __bytes__ special method (closes #13259)

merge heads

Issue #13018: Fix reference leaks in error paths in dictobject.c.
Patch by Suman Saha.

Issue #10332: multiprocessing: fix a race condition when a Pool is closed
before all tasks have completed.

note callable is back in 3.2

Issue #13255: wrong docstrings in array module.

Issue 13141: Demonstrate recommended style for socketserver examples.

Add the green "New reference" note to the doc of PyException_GetTraceback()

Issue 1294232: Fix errors in metaclass calculation affecting some cases of metaclass inheritance. Patch by Daniel Urban.

Issue #9168: now smtpd is able to bind privileged port.

#13233: fix typo.

#13219: clarify section about character sets in the re documentation.

News entry for Issue12529 and Issue12604

Issue 12668: Fix wording in Whatsnew3.2

Issue 11931: Minor punctuation/grammar/wording fixups to the regex docs

adjust braces a bit

urllib.request - syntax changes enhancing readability. By Éric Araujo

3.2 - Fix Issue 12604 - Use a proper no-op macro expansion for VTRACE macro in _sre.c

3.2 - Fix closes Issue6090 - Raise a ValueError, instead of failing with unrelated
exceptions, when a document with timestamp earlier than 1980 is provided to
zipfile. Patch contributed by  Petri Lehtinen.

3.2 - Fix closes Issue12529 - cgi.parse_header failure on double quotes and
semicolons. Patch by Ben Darnell and Petri Lehtinen.

Remove duplication.

Fixes #10860: Handle empty port after port delimiter in httplib

Issue #13188: When called without an explicit traceback argument,
generator.throw() now gets the traceback from the passed exception's
`__traceback__` attribute.  Patch by Petri Lehtinen.

#12448: smtplib now flushes stdout while running ``python -m smtplib``
  in order to display the prompt correctly.  Patch by Petri Lehtinen.

#12277: add missing comma.

Issue #13194: zlib.compressobj().copy() and zlib.decompressobj().copy() are now available on Windows.

plug possible refleak (closes #13199)

normalize whitespace in Lib/distutils/msvc9compiler.py

Issue #7833: Ext. modules built using distutils on Windows no longer get a manifest

Issue #10653: Fix time.strftime() on Windows, check for invalid format strings

Issue 13177: Make tracebacks more readable by avoiding chained exceptions in the lru_cache.

Update dead references from py.org/dev/faq to the devguide (#13176)

Branch merge

Replace {Get,Set,Has}AttrString with *AttrId.