diff -r 128fa5eea9b1 Doc/distributing/index.rst --- a/Doc/distributing/index.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/distributing/index.rst Sat Dec 19 14:07:10 2015 +0100 @@ -35,7 +35,7 @@ repository of open source licensed packages made available for use by other Python users * the `Python Packaging Authority - `__ are the group of + `__ are the group of developers and documentation authors responsible for the maintenance and evolution of the standard packaging tools and the associated metadata and file format standards. They maintain a variety of tools, documentation @@ -62,7 +62,7 @@ locally. .. _setuptools: https://setuptools.pypa.io/en/latest/setuptools.html -.. _wheel: http://wheel.readthedocs.org +.. _wheel: https://wheel.readthedocs.org Open source licensing and collaboration ======================================= @@ -111,7 +111,7 @@ The Python Packaging User Guide includes more details on the `currently recommended tools`_. -.. _currently recommended tools: https://packaging.python.org/en/latest/current.html#packaging-tool-recommendations +.. _currently recommended tools: https://packaging.python.org/en/latest/current/#packaging-tool-recommendations Reading the guide ================= @@ -124,11 +124,11 @@ * `Uploading the project to the Python Packaging Index`_ .. _Project structure: \ - https://packaging.python.org/en/latest/distributing.html#creating-your-own-project + https://packaging.python.org/en/latest/distributing/ .. _Building and packaging the project: \ - https://packaging.python.org/en/latest/distributing.html#packaging-your-project + https://packaging.python.org/en/latest/distributing/#packaging-your-project .. _Uploading the project to the Python Packaging Index: \ - https://packaging.python.org/en/latest/distributing.html#uploading-your-project-to-pypi + https://packaging.python.org/en/latest/distributing/#uploading-your-project-to-pypi How do I...? @@ -160,11 +160,11 @@ .. seealso:: `Python Packaging User Guide: Binary Extensions - `__ + `__ .. other topics: Once the Development & Deployment part of PPUG is fleshed out, some of those sections should be linked from new questions here (most notably, we should have a question about avoiding depending on PyPI that links to - https://packaging.python.org/en/latest/deployment.html#pypi-mirrors-and-caches) + https://packaging.python.org/en/latest/mirrors/) diff -r 128fa5eea9b1 Doc/distutils/apiref.rst --- a/Doc/distutils/apiref.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/distutils/apiref.rst Sat Dec 19 14:07:10 2015 +0100 @@ -1822,7 +1822,7 @@ Builds a `Windows Installer`_ (.msi) binary package. - .. _Windows Installer: http://msdn.microsoft.com/en-us/library/cc185688(VS.85).aspx + .. _Windows Installer: https://msdn.microsoft.com/en-us/library/cc185688(VS.85).aspx In most cases, the ``bdist_msi`` installer is a better choice than the ``bdist_wininst`` installer, because it provides better support for diff -r 128fa5eea9b1 Doc/extending/extending.rst --- a/Doc/extending/extending.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/extending/extending.rst Sat Dec 19 14:07:10 2015 +0100 @@ -27,7 +27,7 @@ avoid writing C extensions and preserve portability to other implementations. For example, if your use case is calling C library functions or system calls, you should consider using the :mod:`ctypes` module or the `cffi - `_ library rather than writing custom C code. + `_ library rather than writing custom C code. These modules let you write Python code to interface with C code and are more portable between implementations of Python than writing and compiling a C extension module. diff -r 128fa5eea9b1 Doc/extending/index.rst --- a/Doc/extending/index.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/extending/index.rst Sat Dec 19 14:07:10 2015 +0100 @@ -32,7 +32,7 @@ .. seealso:: - `Python Packaging User Guide: Binary Extensions `_ + `Python Packaging User Guide: Binary Extensions `_ The Python Packaging User Guide not only covers several available tools that simplify the creation of binary extensions, but also discusses the various reasons why creating an extension module may be diff -r 128fa5eea9b1 Doc/faq/design.rst --- a/Doc/faq/design.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/faq/design.rst Sat Dec 19 14:07:10 2015 +0100 @@ -370,7 +370,7 @@ `Cython `_ and `Pyrex `_ compile a modified version of Python with optional annotations into C -extensions. `Weave `_ makes it easy to +extensions. `Weave `_ makes it easy to intermingle Python and C code in various ways to increase performance. `Nuitka `_ is an up-and-coming compiler of Python into C++ code, aiming to support the full Python language. diff -r 128fa5eea9b1 Doc/faq/extending.rst --- a/Doc/faq/extending.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/faq/extending.rst Sat Dec 19 14:07:10 2015 +0100 @@ -50,10 +50,10 @@ If you need to interface to some C or C++ library for which no Python extension currently exists, you can try wrapping the library's data types and functions with a tool such as `SWIG `_. `SIP -`__, `CXX +`__, `CXX `_ `Boost `_, or `Weave -`_ are also +`_ are also alternatives for wrapping C++ libraries. diff -r 128fa5eea9b1 Doc/faq/general.rst --- a/Doc/faq/general.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/faq/general.rst Sat Dec 19 14:07:10 2015 +0100 @@ -159,7 +159,7 @@ -------------------------------------------- The latest Python source distribution is always available from python.org, at -https://www.python.org/download/. The latest development sources can be obtained +https://www.python.org/downloads/. The latest development sources can be obtained via anonymous Mercurial access at https://hg.python.org/cpython. The source distribution is a gzipped tar file containing the complete C source, @@ -218,7 +218,7 @@ How do I get a beta test version of Python? ------------------------------------------- -Alpha and beta releases are available from https://www.python.org/download/. All +Alpha and beta releases are available from https://www.python.org/downloads/. All releases are announced on the comp.lang.python and comp.lang.python.announce newsgroups and on the Python home page at https://www.python.org/; an RSS feed of news is available. @@ -273,7 +273,7 @@ `www.python.org `_ is graciously hosted by `Rackspace `_, with CDN caching provided by `Fastly `_. `Upfront Systems -`_ hosts `bugs.python.org +`_ hosts `bugs.python.org `_. Many other Python services like `the Wiki `_ are hosted by `Oregon State University Open Source Lab `_. @@ -284,7 +284,7 @@ When he began implementing Python, Guido van Rossum was also reading the published scripts from `"Monty Python's Flying Circus" -`__, a BBC comedy series from the 1970s. Van Rossum +`__, a BBC comedy series from the 1970s. Van Rossum thought he needed a name that was short, unique, and slightly mysterious, so he decided to call the language Python. @@ -313,7 +313,7 @@ releases. The latest stable releases can always be found on the `Python download page -`_. There are two recommended production-ready +`_. There are two recommended production-ready versions at this point in time, because at the moment there are two branches of stable releases: 2.x and 3.x. Python 3.x may be less useful than 2.x, since currently there is more third party software available for Python 2 than for @@ -345,7 +345,7 @@ High-profile Python projects include `the Mailman mailing list manager `_ and `the Zope application server `_. Several Linux distributions, most notably `Red Hat -`_, have written part or all of their installer and +`_, have written part or all of their installer and system administration software in Python. Companies that use Python internally include Google, Yahoo, and Lucasfilm Ltd. diff -r 128fa5eea9b1 Doc/faq/gui.rst --- a/Doc/faq/gui.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/faq/gui.rst Sat Dec 19 14:07:10 2015 +0100 @@ -29,7 +29,7 @@ Standard builds of Python include an object-oriented interface to the Tcl/Tk widget set, called :ref:`tkinter `. This is probably the easiest to install (since it comes included with most -`binary distributions `_ of Python) and use. +`binary distributions `_ of Python) and use. For more info about Tk, including pointers to the source, see the `Tcl/Tk home page `_. Tcl/Tk is fully portable to the Mac OS X, Windows, and Unix platforms. @@ -58,19 +58,19 @@ --- There are bindings available for the Qt toolkit (using either `PyQt -`_ or `PySide -`_) and for KDE (`PyKDE `__). +`_ or `PySide +`_) and for KDE (`PyKDE `__). PyQt is currently more mature than PySide, but you must buy a PyQt license from -`Riverbank Computing `_ +`Riverbank Computing `_ if you want to write proprietary applications. PySide is free for all applications. Qt 4.5 upwards is licensed under the LGPL license; also, commercial licenses -are available from `The Qt Company `_. +are available from `The Qt Company `_. Gtk+ ---- -The `GObject introspection bindings `_ +The `GObject introspection bindings `_ for Python allow you to write GTK+ 3 applications. There is also a `Python GTK+ 3 Tutorial `_. diff -r 128fa5eea9b1 Doc/faq/library.rst --- a/Doc/faq/library.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/faq/library.rst Sat Dec 19 14:07:10 2015 +0100 @@ -619,7 +619,7 @@ For Unix, see a Usenet post by Mitch Chapman: - http://groups.google.com/groups?selm=34A04430.CF9@ohioee.com + https://groups.google.com/groups?selm=34A04430.CF9@ohioee.com Why doesn't closing sys.stdout (stdin, stderr) really close it? diff -r 128fa5eea9b1 Doc/faq/programming.rst --- a/Doc/faq/programming.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/faq/programming.rst Sat Dec 19 14:07:10 2015 +0100 @@ -63,7 +63,7 @@ warns about code complexity and style. You can get PyChecker from http://pychecker.sourceforge.net/. -`Pylint `_ is another tool that checks +`Pylint `_ is another tool that checks if a module satisfies a coding standard, and also makes it possible to write plug-ins to add a custom feature. In addition to the bug checking that PyChecker performs, Pylint offers some additional features such as checking line diff -r 128fa5eea9b1 Doc/howto/curses.rst --- a/Doc/howto/curses.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/howto/curses.rst Sat Dec 19 14:07:10 2015 +0100 @@ -545,7 +545,7 @@ a lengthy tutorial for C programmers. * `The ncurses man page `_ * `The ncurses FAQ `_ -* `"Use curses... don't swear" `_: +* `"Use curses... don't swear" `_: video of a PyCon 2013 talk on controlling terminals using curses or Urwid. * `"Console Applications with Urwid" `_: video of a PyCon CA 2012 talk demonstrating some applications written using diff -r 128fa5eea9b1 Doc/howto/functional.rst --- a/Doc/howto/functional.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/howto/functional.rst Sat Dec 19 14:07:10 2015 +0100 @@ -332,7 +332,7 @@ List comprehensions and generator expressions (short form: "listcomps" and "genexps") are a concise notation for such operations, borrowed from the -functional programming language Haskell (http://www.haskell.org/). You can strip +functional programming language Haskell (https://www.haskell.org/). You can strip all the whitespace from a stream of strings with the following code:: line_list = [' line 1\n', 'line 2 \n', ...] @@ -716,7 +716,7 @@ It doesn't construct an in-memory list and exhaust all the input iterators before returning; instead tuples are constructed and returned only if they're requested. (The technical term for this behaviour is `lazy evaluation -`__.) +`__.) This iterator is intended to be used with iterables that are all of the same length. If the iterables are of different lengths, the resulting stream will be @@ -1199,7 +1199,7 @@ **Structure and Interpretation of Computer Programs**, by Harold Abelson and Gerald Jay Sussman with Julie Sussman. Full text at -http://mitpress.mit.edu/sicp/. In this classic textbook of computer science, +https://mitpress.mit.edu/sicp/. In this classic textbook of computer science, chapters 2 and 3 discuss the use of sequences and streams to organize the data flow inside a program. The book uses Scheme for its examples, but many of the design approaches described in these chapters are applicable to functional-style @@ -1208,12 +1208,12 @@ http://www.defmacro.org/ramblings/fp.html: A general introduction to functional programming that uses Java examples and has a lengthy historical introduction. -http://en.wikipedia.org/wiki/Functional_programming: General Wikipedia entry +https://en.wikipedia.org/wiki/Functional_programming: General Wikipedia entry describing functional programming. -http://en.wikipedia.org/wiki/Coroutine: Entry for coroutines. +https://en.wikipedia.org/wiki/Coroutine: Entry for coroutines. -http://en.wikipedia.org/wiki/Currying: Entry for the concept of currying. +https://en.wikipedia.org/wiki/Currying: Entry for the concept of currying. Python-specific --------------- diff -r 128fa5eea9b1 Doc/howto/logging-cookbook.rst --- a/Doc/howto/logging-cookbook.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/howto/logging-cookbook.rst Sat Dec 19 14:07:10 2015 +0100 @@ -1261,7 +1261,7 @@ ----------------------------------------- Below is an example of a logging configuration dictionary - it's taken from -the `documentation on the Django project `_. +the `documentation on the Django project `_. This dictionary is passed to :func:`~config.dictConfig` to put the configuration into effect:: LOGGING = { diff -r 128fa5eea9b1 Doc/howto/logging.rst --- a/Doc/howto/logging.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/howto/logging.rst Sat Dec 19 14:07:10 2015 +0100 @@ -310,7 +310,7 @@ If your logging needs are simple, then use the above examples to incorporate logging into your own scripts, and if you run into problems or don't understand something, please post a question on the comp.lang.python Usenet -group (available at http://groups.google.com/group/comp.lang.python) and you +group (available at https://groups.google.com/group/comp.lang.python) and you should receive help before too long. Still here? You can carry on reading the next few sections, which provide a diff -r 128fa5eea9b1 Doc/howto/sorting.rst --- a/Doc/howto/sorting.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/howto/sorting.rst Sat Dec 19 14:07:10 2015 +0100 @@ -127,7 +127,7 @@ ================================ Sorts are guaranteed to be `stable -`_\. That means that +`_\. That means that when multiple records have the same key, their original order is preserved. >>> data = [('red', 1), ('blue', 1), ('red', 2), ('blue', 2)] @@ -145,7 +145,7 @@ >>> sorted(s, key=attrgetter('grade'), reverse=True) # now sort on primary key, descending [('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)] -The `Timsort `_ algorithm used in Python +The `Timsort `_ algorithm used in Python does multiple sorts efficiently because it can take advantage of any ordering already present in a dataset. @@ -184,7 +184,7 @@ directly. Another name for this idiom is -`Schwartzian transform `_\, +`Schwartzian transform `_\, after Randal L. Schwartz, who popularized it among Perl programmers. Now that Python sorting provides key-functions, this technique is not often needed. diff -r 128fa5eea9b1 Doc/howto/unicode.rst --- a/Doc/howto/unicode.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/howto/unicode.rst Sat Dec 19 14:07:10 2015 +0100 @@ -73,7 +73,7 @@ precise historical details aren't necessary for understanding how to use Unicode effectively, but if you're curious, consult the Unicode consortium site listed in the References or -the `Wikipedia entry for Unicode `_ +the `Wikipedia entry for Unicode `_ for more information.) @@ -223,8 +223,8 @@ reading this alternate article before continuing. Wikipedia entries are often helpful; see the entries for "`character encoding -`_" and `UTF-8 -`_, for example. +`_" and `UTF-8 +`_, for example. Python's Unicode Support diff -r 128fa5eea9b1 Doc/howto/webservers.rst --- a/Doc/howto/webservers.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/howto/webservers.rst Sat Dec 19 14:07:10 2015 +0100 @@ -267,7 +267,7 @@ Each web server requires a specific module. * Apache has both `mod_fastcgi `_ and `mod_fcgid - `_. ``mod_fastcgi`` is the original one, but it + `_. ``mod_fastcgi`` is the original one, but it has some licensing issues, which is why it is sometimes considered non-free. ``mod_fcgid`` is a smaller, compatible alternative. One of these modules needs to be loaded by Apache. @@ -277,7 +277,7 @@ `SCGI module `_. * `nginx `_ also supports `FastCGI - `_. + `_. Once you have installed and configured the module, you can test it with the following WSGI-application:: @@ -307,8 +307,8 @@ .. seealso:: - There is some documentation on `setting up Django with FastCGI - `_, most of + There is some documentation on `setting up Django with WSGI + `_, most of which can be reused for other WSGI-compliant frameworks and libraries. Only the ``manage.py`` part has to be changed, the example used here can be used instead. Django does more or less the exact same thing. @@ -358,7 +358,7 @@ A really great WSGI feature is middleware. Middleware is a layer around your program which can add various functionality to it. There is quite a bit of -`middleware `_ already +`middleware `_ already available. For example, instead of writing your own session management (HTTP is a stateless protocol, so to associate multiple HTTP requests with a single user your application must create and manage such state via a session), you can @@ -379,7 +379,7 @@ The code that is used to connect to various low level gateways like CGI or mod_python is called a *WSGI server*. One of these servers is ``flup``, which supports FastCGI and SCGI, as well as `AJP -`_. Some of these servers +`_. Some of these servers are written in Python, as ``flup`` is, but there also exist others which are written in C and can be used as drop-in replacements. @@ -390,8 +390,8 @@ .. seealso:: A good overview of WSGI-related code can be found in the `WSGI homepage - `_, which contains an extensive list of `WSGI servers - `_ which can be used by *any* application + `_, which contains an extensive list of `WSGI servers + `_ which can be used by *any* application supporting WSGI. You might be interested in some WSGI-supporting modules already contained in @@ -408,7 +408,7 @@ Python without using WSGI. One of the most widely used wiki software packages is `MoinMoin -`_. It was created in 2000, so it predates WSGI by about +`_. It was created in 2000, so it predates WSGI by about three years. Older versions needed separate code to run on CGI, mod_python, FastCGI and standalone. @@ -460,7 +460,7 @@ .. seealso:: The English Wikipedia has an article about the `Model-View-Controller pattern - `_. It includes a long + `_. It includes a long list of web frameworks for various programming languages. @@ -543,10 +543,10 @@ smaller sites SQLite is just enough. Relational databases are *queried* using a language called `SQL -`_. Python programmers in general do not +`_. Python programmers in general do not like SQL too much, as they prefer to work with objects. It is possible to save Python objects into a database using a technology called `ORM -`_ (Object Relational +`_ (Object Relational Mapping). ORM translates all object-oriented access into SQL code under the hood, so the developer does not need to think about it. Most `frameworks`_ use ORMs, and it works quite well. @@ -579,13 +579,13 @@ helps with choosing a method for saving data * `SQLAlchemy `_, the most powerful OR-Mapper - for Python, and `Elixir `_, which makes + for Python, and `Elixir `_, which makes SQLAlchemy easier to use * `SQLObject `_, another popular OR-Mapper * `ZODB `_ and `Durus - `_, two object oriented + `_, two object oriented databases @@ -671,10 +671,10 @@ example the ORM and template engine can be changed to use packages different from those used by default. -The documentation can be found in the `TurboGears wiki -`_, where links to screencasts can be found. +The documentation can be found in the `TurboGears documentation +`_, where links to screencasts can be found. TurboGears has also an active user community which can respond to most related -questions. There is also a `TurboGears book `_ +questions. There is also a `TurboGears book `_ published, which is a good starting point. The newest version of TurboGears, version 2.0, moves even further in direction diff -r 128fa5eea9b1 Doc/installing/index.rst --- a/Doc/installing/index.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/installing/index.rst Sat Dec 19 14:07:10 2015 +0100 @@ -48,7 +48,7 @@ repository of open source licensed packages made available for use by other Python users * the `Python Packaging Authority - `__ are the group of + `__ are the group of developers and documentation authors responsible for the maintenance and evolution of the standard packaging tools and the associated metadata and file format standards. They maintain a variety of tools, documentation @@ -104,7 +104,7 @@ .. seealso:: `Python Packaging User Guide: Installing Python Distribution Packages - `__ + `__ How do I ...? @@ -121,8 +121,8 @@ .. seealso:: - `Python Packaging User Guide: Setup for Installing Distribution Packages - `__ + `Python Packaging User Guide: Requirements for Installing Packages + `__ .. installing-per-user-installation: @@ -141,13 +141,13 @@ aren't currently easy to install using ``pip`` directly. At this point in time, it will often be easier for users to install these packages by `other means -`__ +`__ rather than attempting to install them with ``pip``. .. seealso:: `Python Packaging User Guide: Installing Scientific Packages - `__ + `__ ... work with multiple versions of Python installed in parallel? @@ -177,7 +177,7 @@ Once the Development & Deployment part of PPUG is fleshed out, some of those sections should be linked from new questions here (most notably, we should have a question about avoiding depending on PyPI that links to - https://packaging.python.org/en/latest/deployment.html#pypi-mirrors-and-caches) + https://packaging.python.org/en/latest/mirrors/) Common installation issues @@ -210,11 +210,11 @@ than needing to build them themselves. Some of the solutions for installing `scientific software -`__ +`__ that is not yet available as pre-built ``wheel`` files may also help with obtaining other binary extensions without needing to build them locally. .. seealso:: `Python Packaging User Guide: Binary Extensions - `__ + `__ diff -r 128fa5eea9b1 Doc/library/asyncio-eventloops.rst --- a/Doc/library/asyncio-eventloops.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/asyncio-eventloops.rst Sat Dec 19 14:07:10 2015 +0100 @@ -41,7 +41,7 @@ On Windows, only sockets are supported (ex: pipes are not supported): see the `MSDN documentation of select - `_. + `_. .. class:: ProactorEventLoop @@ -53,7 +53,7 @@ .. seealso:: `MSDN documentation on I/O Completion Ports - `_. + `_. Example to use a :class:`ProactorEventLoop` on Windows:: @@ -107,7 +107,7 @@ The resolution of the monotonic clock on Windows is usually around 15.6 msec. The best resolution is 0.5 msec. The resolution depends on the hardware (availability of `HPET -`_) and on the Windows +`_) and on the Windows configuration. See :ref:`asyncio delayed calls `. .. versionchanged:: 3.5 diff -r 128fa5eea9b1 Doc/library/asyncio-subprocess.rst --- a/Doc/library/asyncio-subprocess.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/asyncio-subprocess.rst Sat Dec 19 14:07:10 2015 +0100 @@ -51,7 +51,7 @@ It is the application's responsibility to ensure that all whitespace and metacharacters are quoted appropriately to avoid `shell injection - `_ + `_ vulnerabilities. The :func:`shlex.quote` function can be used to properly escape whitespace and shell metacharacters in strings that are going to be used to construct shell commands. @@ -134,7 +134,7 @@ It is the application's responsibility to ensure that all whitespace and metacharacters are quoted appropriately to avoid `shell injection - `_ + `_ vulnerabilities. The :func:`shlex.quote` function can be used to properly escape whitespace and shell metacharacters in strings that are going to be used to construct shell commands. diff -r 128fa5eea9b1 Doc/library/collections.rst --- a/Doc/library/collections.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/collections.rst Sat Dec 19 14:07:10 2015 +0100 @@ -374,12 +374,12 @@ .. seealso:: - * `Bag class `_ + * `Bag class `_ in Smalltalk. - * Wikipedia entry for `Multisets `_. + * Wikipedia entry for `Multisets `_. - * `C++ multisets `_ + * `C++ multisets `_ tutorial with examples. * For mathematical operations on multisets and their use cases, see diff -r 128fa5eea9b1 Doc/library/dbm.rst --- a/Doc/library/dbm.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/dbm.rst Sat Dec 19 14:07:10 2015 +0100 @@ -7,7 +7,7 @@ :mod:`dbm` is a generic interface to variants of the DBM database --- :mod:`dbm.gnu` or :mod:`dbm.ndbm`. If none of these modules is installed, the slow-but-simple implementation in module :mod:`dbm.dumb` will be used. There -is a `third party interface `_ to +is a `third party interface `_ to the Oracle Berkeley DB. diff -r 128fa5eea9b1 Doc/library/decimal.rst --- a/Doc/library/decimal.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/decimal.rst Sat Dec 19 14:07:10 2015 +0100 @@ -109,9 +109,6 @@ * IBM's General Decimal Arithmetic Specification, `The General Decimal Arithmetic Specification `_. - * IEEE standard 854-1987, `Unofficial IEEE 854 Text - `_. - .. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% diff -r 128fa5eea9b1 Doc/library/email.generator.rst --- a/Doc/library/email.generator.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/email.generator.rst Sat Dec 19 14:07:10 2015 +0100 @@ -43,7 +43,7 @@ followed by a space at the beginning of the line. This is the only guaranteed portable way to avoid having such lines be mistaken for a Unix mailbox format envelope header separator (see `WHY THE CONTENT-LENGTH FORMAT IS BAD - `_ for details). *mangle_from_* + `_ for details). *mangle_from_* defaults to ``True``, but you might want to set this to ``False`` if you are not writing Unix mailbox format files. @@ -123,7 +123,7 @@ i.e. ``From`` followed by a space at the beginning of the line. This is the only guaranteed portable way to avoid having such lines be mistaken for a Unix mailbox format envelope header separator (see `WHY THE CONTENT-LENGTH - FORMAT IS BAD `_ for details). + FORMAT IS BAD `_ for details). *mangle_from_* defaults to ``True``, but you might want to set this to ``False`` if you are not writing Unix mailbox format files. diff -r 128fa5eea9b1 Doc/library/functions.rst --- a/Doc/library/functions.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/functions.rst Sat Dec 19 14:07:10 2015 +0100 @@ -1415,7 +1415,7 @@ For practical suggestions on how to design cooperative classes using :func:`super`, see `guide to using super() - `_. + `_. .. _func-tuple: diff -r 128fa5eea9b1 Doc/library/functools.rst --- a/Doc/library/functools.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/functools.rst Sat Dec 19 14:07:10 2015 +0100 @@ -73,7 +73,7 @@ bypassing the cache, or for rewrapping the function with a different cache. An `LRU (least recently used) cache - `_ works + `_ works best when the most recent calls are the best predictors of upcoming calls (for example, the most popular articles on a news server tend to change each day). The cache's size limit assures that the cache does not grow without bound on @@ -99,9 +99,9 @@ CacheInfo(hits=3, misses=8, maxsize=32, currsize=8) Example of efficiently computing - `Fibonacci numbers `_ + `Fibonacci numbers `_ using a cache to implement a - `dynamic programming `_ + `dynamic programming `_ technique:: @lru_cache(maxsize=None) diff -r 128fa5eea9b1 Doc/library/heapq.rst --- a/Doc/library/heapq.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/heapq.rst Sat Dec 19 14:07:10 2015 +0100 @@ -132,7 +132,7 @@ Basic Examples -------------- -A `heapsort `_ can be implemented by +A `heapsort `_ can be implemented by pushing all values onto a heap and then popping off the smallest values one at a time:: @@ -163,7 +163,7 @@ Priority Queue Implementation Notes ----------------------------------- -A `priority queue `_ is common use +A `priority queue `_ is common use for a heap, and it presents several implementation challenges: * Sort stability: how do you get two tasks with equal priorities to be returned diff -r 128fa5eea9b1 Doc/library/http.client.rst --- a/Doc/library/http.client.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/http.client.rst Sat Dec 19 14:07:10 2015 +0100 @@ -21,7 +21,7 @@ .. seealso:: - The `Requests package `_ + The `Requests package `_ is recommended for a higher-level http client interface. .. note:: diff -r 128fa5eea9b1 Doc/library/itertools.rst --- a/Doc/library/itertools.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/itertools.rst Sat Dec 19 14:07:10 2015 +0100 @@ -117,7 +117,7 @@ :func:`min` for a running minimum, :func:`max` for a running maximum, or :func:`operator.mul` for a running product. Amortization tables can be built by accumulating interest and applying payments. First-order - `recurrence relations `_ + `recurrence relations `_ can be modeled by supplying the initial value in the iterable and using only the accumulated total in *func* argument:: @@ -132,7 +132,7 @@ >>> list(accumulate(cashflows, lambda bal, pmt: bal*1.05 + pmt)) [1000, 960.0, 918.0, 873.9000000000001, 827.5950000000001] - # Chaotic recurrence relation http://en.wikipedia.org/wiki/Logistic_map + # Chaotic recurrence relation https://en.wikipedia.org/wiki/Logistic_map >>> logistic_map = lambda x, _: r * x * (1 - x) >>> r = 3.8 >>> x0 = 0.4 diff -r 128fa5eea9b1 Doc/library/json.rst --- a/Doc/library/json.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/json.rst Sat Dec 19 14:07:10 2015 +0100 @@ -10,7 +10,7 @@ :rfc:`7159` (which obsoletes :rfc:`4627`) and by `ECMA-404 `_, is a lightweight data interchange format inspired by -`JavaScript `_ object literal syntax +`JavaScript `_ object literal syntax (although it is not a strict subset of JavaScript [#rfc-errata]_ ). :mod:`json` exposes an API familiar to users of the standard library diff -r 128fa5eea9b1 Doc/library/logging.rst --- a/Doc/library/logging.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/logging.rst Sat Dec 19 14:07:10 2015 +0100 @@ -1246,7 +1246,7 @@ The proposal which described this feature for inclusion in the Python standard library. - `Original Python logging package `_ + `Original Python logging package `_ This is the original source for the :mod:`logging` package. The version of the package available from this site is suitable for use with Python 1.5.2, 2.1.x and 2.2.x, which do not include the :mod:`logging` package in the standard diff -r 128fa5eea9b1 Doc/library/mailbox.rst --- a/Doc/library/mailbox.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/mailbox.rst Sat Dec 19 14:07:10 2015 +0100 @@ -484,7 +484,7 @@ `mbox man page from tin `_ Another specification of the format, with details on locking. - `Configuring Netscape Mail on Unix: Why The Content-Length Format is Bad `_ + `Configuring Netscape Mail on Unix: Why The Content-Length Format is Bad `_ An argument for using the original mbox format rather than a variation. `"mbox" is a family of several mutually incompatible mailbox formats `_ @@ -744,7 +744,7 @@ `mmdf man page from tin `_ A specification of MMDF format from the documentation of tin, a newsreader. - `MMDF `_ + `MMDF `_ A Wikipedia article describing the Multichannel Memorandum Distribution Facility. diff -r 128fa5eea9b1 Doc/library/math.rst --- a/Doc/library/math.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/math.rst Sat Dec 19 14:07:10 2015 +0100 @@ -97,7 +97,7 @@ For further discussion and two alternative approaches, see the `ASPN cookbook recipes for accurate floating point summation - `_\. + `_\. .. function:: gcd(a, b) @@ -204,7 +204,7 @@ Return ``e**x - 1``. For small floats *x*, the subtraction in ``exp(x) - 1`` can result in a `significant loss of precision - `_\; the :func:`expm1` + `_\; the :func:`expm1` function provides a way to compute this quantity to full precision:: >>> from math import exp, expm1 @@ -332,7 +332,7 @@ Hyperbolic functions -------------------- -`Hyperbolic functions `_ +`Hyperbolic functions `_ are analogs of trigonometric functions that are based on hyperbolas instead of circles. @@ -371,12 +371,12 @@ .. function:: erf(x) - Return the `error function `_ at + Return the `error function `_ at *x*. The :func:`erf` function can be used to compute traditional statistical functions such as the `cumulative standard normal distribution - `_:: + `_:: def phi(x): 'Cumulative distribution function for the standard normal distribution' @@ -388,17 +388,17 @@ .. function:: erfc(x) Return the complementary error function at *x*. The `complementary error - function `_ is defined as + function `_ is defined as ``1.0 - erf(x)``. It is used for large values of *x* where a subtraction from one would cause a `loss of significance - `_\. + `_\. .. versionadded:: 3.2 .. function:: gamma(x) - Return the `Gamma function `_ at + Return the `Gamma function `_ at *x*. .. versionadded:: 3.2 diff -r 128fa5eea9b1 Doc/library/msilib.rst --- a/Doc/library/msilib.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/msilib.rst Sat Dec 19 14:07:10 2015 +0100 @@ -120,9 +120,9 @@ .. seealso:: - `FCICreateFile `_ - `UuidCreate `_ - `UuidToString `_ + `FCICreateFile `_ + `UuidCreate `_ + `UuidToString `_ .. _database-objects: @@ -151,9 +151,9 @@ .. seealso:: - `MSIDatabaseOpenView `_ - `MSIDatabaseCommit `_ - `MSIGetSummaryInformation `_ + `MSIDatabaseOpenView `_ + `MSIDatabaseCommit `_ + `MSIGetSummaryInformation `_ .. _view-objects: @@ -199,11 +199,11 @@ .. seealso:: - `MsiViewExecute `_ - `MSIViewGetColumnInfo `_ - `MsiViewFetch `_ - `MsiViewModify `_ - `MsiViewClose `_ + `MsiViewExecute `_ + `MSIViewGetColumnInfo `_ + `MsiViewFetch `_ + `MsiViewModify `_ + `MsiViewClose `_ .. _summary-objects: @@ -243,10 +243,10 @@ .. seealso:: - `MsiSummaryInfoGetProperty `_ - `MsiSummaryInfoGetPropertyCount `_ - `MsiSummaryInfoSetProperty `_ - `MsiSummaryInfoPersist `_ + `MsiSummaryInfoGetProperty `_ + `MsiSummaryInfoGetPropertyCount `_ + `MsiSummaryInfoSetProperty `_ + `MsiSummaryInfoPersist `_ .. _record-objects: @@ -297,11 +297,11 @@ .. seealso:: - `MsiRecordGetFieldCount `_ - `MsiRecordSetString `_ - `MsiRecordSetStream `_ - `MsiRecordSetInteger `_ - `MsiRecordClear `_ + `MsiRecordGetFieldCount `_ + `MsiRecordSetString `_ + `MsiRecordSetStream `_ + `MsiRecordSetInteger `_ + `MsiRecordClear `_ .. _msi-errors: @@ -393,10 +393,10 @@ .. seealso:: - `Directory Table `_ - `File Table `_ - `Component Table `_ - `FeatureComponents Table `_ + `Directory Table `_ + `File Table `_ + `Component Table `_ + `FeatureComponents Table `_ .. _features: @@ -421,7 +421,7 @@ .. seealso:: - `Feature Table `_ + `Feature Table `_ .. _msi-gui: @@ -516,13 +516,13 @@ .. seealso:: - `Dialog Table `_ - `Control Table `_ - `Control Types `_ - `ControlCondition Table `_ - `ControlEvent Table `_ - `EventMapping Table `_ - `RadioButton Table `_ + `Dialog Table `_ + `Control Table `_ + `Control Types `_ + `ControlCondition Table `_ + `ControlEvent Table `_ + `EventMapping Table `_ + `RadioButton Table `_ .. _msi-tables: diff -r 128fa5eea9b1 Doc/library/os.rst --- a/Doc/library/os.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/os.rst Sat Dec 19 14:07:10 2015 +0100 @@ -894,7 +894,7 @@ :func:`~os.open` function. They can be combined using the bitwise OR operator ``|``. Some of them are not available on all platforms. For descriptions of their availability and use, consult the :manpage:`open(2)` manual page on Unix -or `the MSDN `_ on Windows. +or `the MSDN `_ on Windows. .. data:: O_RDONLY @@ -1907,9 +1907,9 @@ and `readdir() `_ functions. On Windows, it uses the Win32 - `FindFirstFileW `_ + `FindFirstFileW `_ and - `FindNextFileW `_ + `FindNextFileW `_ functions. .. versionadded:: 3.5 diff -r 128fa5eea9b1 Doc/library/othergui.rst --- a/Doc/library/othergui.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/othergui.rst Sat Dec 19 14:07:10 2015 +0100 @@ -8,33 +8,33 @@ .. seealso:: - `PyGObject `_ + `PyGObject `_ provides introspection bindings for C libraries using `GObject `_. One of these libraries is the `GTK+ 3 `_ widget set. GTK+ comes with many more widgets than Tkinter provides. An online - `Python GTK+ 3 Tutorial `_ + `Python GTK+ 3 Tutorial `_ is available. `PyGTK `_ provides bindings for an older version of the library, GTK+ 2. It provides an object oriented interface that is slightly higher level than the C one. There are also bindings to - `GNOME `_. An online `tutorial + `GNOME `_. An online `tutorial `_ is available. - `PyQt `_ + `PyQt `_ PyQt is a :program:`sip`\ -wrapped binding to the Qt toolkit. Qt is an extensive C++ GUI application development framework that is available for Unix, Windows and Mac OS X. :program:`sip` is a tool for generating bindings for C++ libraries as Python classes, and is specifically designed for Python. The *PyQt3* bindings have a book, `GUI Programming with Python: QT Edition - `_ by Boudewijn + `_ by Boudewijn Rempt. The *PyQt4* bindings also have a book, `Rapid GUI Programming with Python and Qt `_, by Mark Summerfield. - `PySide `_ + `PySide `_ is a newer binding to the Qt toolkit, provided by Nokia. Compared to PyQt, its licensing scheme is friendlier to non-open source applications. @@ -50,7 +50,7 @@ low-level device context drawing, drag and drop, system clipboard access, an XML-based resource format and more, including an ever growing library of user-contributed modules. wxPython has a book, `wxPython in Action - `_, by Noel Rappin and + `_, by Noel Rappin and Robin Dunn. PyGTK, PyQt, and wxPython, all have a modern look and feel and more diff -r 128fa5eea9b1 Doc/library/random.rst --- a/Doc/library/random.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/random.rst Sat Dec 19 14:07:10 2015 +0100 @@ -267,7 +267,7 @@ `Complementary-Multiply-with-Carry recipe - `_ for a compatible alternative + `_ for a compatible alternative random number generator with a long period and comparatively simple update operations. diff -r 128fa5eea9b1 Doc/library/re.rst --- a/Doc/library/re.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/re.rst Sat Dec 19 14:07:10 2015 +0100 @@ -1389,7 +1389,7 @@ Writing a Tokenizer ^^^^^^^^^^^^^^^^^^^ -A `tokenizer or scanner `_ +A `tokenizer or scanner `_ analyzes a string to categorize groups of characters. This is a useful first step in writing a compiler or interpreter. diff -r 128fa5eea9b1 Doc/library/shelve.rst --- a/Doc/library/shelve.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/shelve.rst Sat Dec 19 14:07:10 2015 +0100 @@ -76,7 +76,7 @@ .. seealso:: - `Persistent dictionary recipe `_ + `Persistent dictionary recipe `_ with widely supported storage formats and having the speed of native dictionaries. @@ -137,7 +137,7 @@ A subclass of :class:`Shelf` which exposes :meth:`first`, :meth:`!next`, :meth:`previous`, :meth:`last` and :meth:`set_location` which are available in the third-party :mod:`bsddb` module from `pybsddb - `_ but not in other database + `_ but not in other database modules. The *dict* object passed to the constructor must support those methods. This is generally accomplished by calling one of :func:`bsddb.hashopen`, :func:`bsddb.btopen` or :func:`bsddb.rnopen`. The diff -r 128fa5eea9b1 Doc/library/socket.rst --- a/Doc/library/socket.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/socket.rst Sat Dec 19 14:07:10 2015 +0100 @@ -988,7 +988,7 @@ The :meth:`ioctl` method is a limited interface to the WSAIoctl system interface. Please refer to the `Win32 documentation - `_ for more + `_ for more information. On other platforms, the generic :func:`fcntl.fcntl` and :func:`fcntl.ioctl` diff -r 128fa5eea9b1 Doc/library/ssl.rst --- a/Doc/library/ssl.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/ssl.rst Sat Dec 19 14:07:10 2015 +0100 @@ -206,7 +206,7 @@ The *ciphers* parameter sets the available ciphers for this SSL object. It should be a string in the `OpenSSL cipher list format - `_. + `_. The parameter ``do_handshake_on_connect`` specifies whether to do the SSL handshake automatically after doing a :meth:`socket.connect`, or whether the @@ -296,7 +296,7 @@ Read the Wikipedia article, `Cryptographically secure pseudorandom number generator (CSPRNG) - `_, + `_, to get the requirements of a cryptographically generator. .. versionadded:: 3.3 @@ -721,7 +721,7 @@ Whether the OpenSSL library has built-in support for *Next Protocol Negotiation* as described in the `NPN draft specification - `_. When true, + `_. When true, you can use the :meth:`SSLContext.set_npn_protocols` method to advertise which protocols you want to support. @@ -1212,7 +1212,7 @@ Set the available ciphers for sockets created with this context. It should be a string in the `OpenSSL cipher list format - `_. + `_. If no cipher can be selected (because compile-time options or other configuration forbids use of all the specified ciphers), an :class:`SSLError` will be raised. @@ -1241,7 +1241,7 @@ handshake. It should be a list of strings, like ``['http/1.1', 'spdy/2']``, ordered by preference. The selection of a protocol will happen during the handshake, and will play out according to the `NPN draft specification - `_. After a + `_. After a successful handshake, the :meth:`SSLSocket.selected_npn_protocol` method will return the agreed-upon protocol. @@ -2019,7 +2019,7 @@ :meth:`SSLContext.set_ciphers` method. Starting from Python 3.2.3, the ssl module disables certain weak ciphers by default, but you may want to further restrict the cipher choice. Be sure to read OpenSSL's documentation -about the `cipher list format `_. +about the `cipher list format `_. If you want to check which ciphers are enabled by a given cipher list, use the ``openssl ciphers`` command on your system. @@ -2040,25 +2040,25 @@ Class :class:`socket.socket` Documentation of underlying :mod:`socket` class - `SSL/TLS Strong Encryption: An Introduction `_ + `SSL/TLS Strong Encryption: An Introduction `_ Intro from the Apache webserver documentation - `RFC 1422: Privacy Enhancement for Internet Electronic Mail: Part II: Certificate-Based Key Management `_ + `RFC 1422: Privacy Enhancement for Internet Electronic Mail: Part II: Certificate-Based Key Management `_ Steve Kent - `RFC 1750: Randomness Recommendations for Security `_ + `RFC 1750: Randomness Recommendations for Security `_ D. Eastlake et. al. - `RFC 3280: Internet X.509 Public Key Infrastructure Certificate and CRL Profile `_ + `RFC 3280: Internet X.509 Public Key Infrastructure Certificate and CRL Profile `_ Housley et. al. - `RFC 4366: Transport Layer Security (TLS) Extensions `_ + `RFC 4366: Transport Layer Security (TLS) Extensions `_ Blake-Wilson et. al. - `RFC 5246: The Transport Layer Security (TLS) Protocol Version 1.2 `_ + `RFC 5246: The Transport Layer Security (TLS) Protocol Version 1.2 `_ T. Dierks et. al. - `RFC 6066: Transport Layer Security (TLS) Extensions `_ + `RFC 6066: Transport Layer Security (TLS) Extensions `_ D. Eastlake `IANA TLS: Transport Layer Security (TLS) Parameters `_ diff -r 128fa5eea9b1 Doc/library/stat.rst --- a/Doc/library/stat.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/stat.rst Sat Dec 19 14:07:10 2015 +0100 @@ -403,7 +403,7 @@ On Windows, the following file attribute constants are available for use when testing bits in the ``st_file_attributes`` member returned by :func:`os.stat`. See the `Windows API documentation -`_ +`_ for more detail on the meaning of these constants. .. data:: FILE_ATTRIBUTE_ARCHIVE diff -r 128fa5eea9b1 Doc/library/subprocess.rst --- a/Doc/library/subprocess.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/subprocess.rst Sat Dec 19 14:07:10 2015 +0100 @@ -475,7 +475,7 @@ execute. On Windows, in order to run a `side-by-side assembly`_ the specified *env* **must** include a valid :envvar:`SystemRoot`. - .. _side-by-side assembly: http://en.wikipedia.org/wiki/Side-by-Side_Assembly + .. _side-by-side assembly: https://en.wikipedia.org/wiki/Side-by-Side_Assembly If *universal_newlines* is ``True``, the file objects *stdin*, *stdout* and *stderr* are opened as text streams in universal newlines mode, as @@ -536,7 +536,7 @@ If the shell is invoked explicitly, via ``shell=True``, it is the application's responsibility to ensure that all whitespace and metacharacters are quoted appropriately to avoid -`shell injection `_ +`shell injection `_ vulnerabilities. When using ``shell=True``, the :func:`shlex.quote` function can be @@ -721,7 +721,7 @@ .. class:: STARTUPINFO() Partial support of the Windows - `STARTUPINFO `__ + `STARTUPINFO `__ structure is used for :class:`Popen` creation. .. attribute:: dwFlags @@ -757,7 +757,7 @@ If :attr:`dwFlags` specifies :data:`STARTF_USESHOWWINDOW`, this attribute can be any of the values that can be specified in the ``nCmdShow`` parameter for the - `ShowWindow `__ + `ShowWindow `__ function, except for ``SW_SHOWDEFAULT``. Otherwise, this attribute is ignored. diff -r 128fa5eea9b1 Doc/library/test.rst --- a/Doc/library/test.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/test.rst Sat Dec 19 14:07:10 2015 +0100 @@ -661,7 +661,7 @@ are expected to crash a subprocess. On Windows, it disables Windows Error Reporting dialogs using - `SetErrorMode `_. + `SetErrorMode `_. On UNIX, :func:`resource.setrlimit` is used to set :attr:`resource.RLIMIT_CORE`'s soft limit to 0 to prevent coredump file diff -r 128fa5eea9b1 Doc/library/tkinter.rst --- a/Doc/library/tkinter.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/tkinter.rst Sat Dec 19 14:07:10 2015 +0100 @@ -31,13 +31,13 @@ `Tcl/Tk manual `_ Official manual for the latest tcl/tk version. - `Programming Python `_ + `Programming Python `_ Book by Mark Lutz, has excellent coverage of Tkinter. `Modern Tkinter for Busy Python Developers `_ Book by Mark Rozerman about building attractive and modern graphical user interfaces with Python and Tkinter. - `Python and Tkinter Programming `_ + `Python and Tkinter Programming `_ The book by John Grayson (ISBN 1-884777-81-3). diff -r 128fa5eea9b1 Doc/library/unittest.mock-examples.rst --- a/Doc/library/unittest.mock-examples.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/unittest.mock-examples.rst Sat Dec 19 14:07:10 2015 +0100 @@ -549,7 +549,7 @@ An alternative way of dealing with mocking dates, or other builtin classes, is discussed in `this blog entry -`_. +`_. Mocking a Generator Method @@ -1251,7 +1251,7 @@ :exc:`AssertionError` directly and provide a more useful failure message. As of version 1.5, the Python testing library `PyHamcrest -`_ provides similar functionality, +`_ provides similar functionality, that may be useful here, in the form of its equality matcher (`hamcrest.library.integration.match_equality -`_). +`_). diff -r 128fa5eea9b1 Doc/library/urllib.request.rst --- a/Doc/library/urllib.request.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/urllib.request.rst Sat Dec 19 14:07:10 2015 +0100 @@ -14,7 +14,7 @@ .. seealso:: - The `Requests package `_ + The `Requests package `_ is recommended for a higher-level http client interface. diff -r 128fa5eea9b1 Doc/library/winreg.rst --- a/Doc/library/winreg.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/winreg.rst Sat Dec 19 14:07:10 2015 +0100 @@ -134,7 +134,7 @@ The :func:`DeleteKeyEx` function is implemented with the RegDeleteKeyEx Windows API function, which is specific to 64-bit versions of Windows. See the `RegDeleteKeyEx documentation - `__. + `__. *key* is an already open key, or one of the predefined :ref:`HKEY_* constants `. @@ -268,7 +268,7 @@ A call to :func:`LoadKey` fails if the calling process does not have the :const:`SE_RESTORE_PRIVILEGE` privilege. Note that privileges are different from permissions -- see the `RegLoadKey documentation - `__ for + `__ for more details. If *key* is a handle returned by :func:`ConnectRegistry`, then the path @@ -383,7 +383,7 @@ possess the :const:`SeBackupPrivilege` security privilege. Note that privileges are different than permissions -- see the `Conflicts Between User Rights and Permissions documentation - `__ + `__ for more details. This function passes NULL for *security_attributes* to the API. @@ -547,7 +547,7 @@ +++++++++++++ For more information, see `Registry Key Security and Access -`__. +`__. .. data:: KEY_ALL_ACCESS @@ -602,7 +602,7 @@ *************** For more information, see `Accessing an Alternate Registry View -`__. +`__. .. data:: KEY_WOW64_64KEY @@ -621,7 +621,7 @@ +++++++++++ For more information, see `Registry Value Types -`__. +`__. .. data:: REG_BINARY diff -r 128fa5eea9b1 Doc/library/wsgiref.rst --- a/Doc/library/wsgiref.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/wsgiref.rst Sat Dec 19 14:07:10 2015 +0100 @@ -24,8 +24,8 @@ and a validation tool that checks WSGI servers and applications for conformance to the WSGI specification (:pep:`3333`). -See http://www.wsgi.org for more information about WSGI, and links to tutorials -and other resources. +See https://wsgi.readthedocs.org/ for more information about WSGI, and links to +tutorials and other resources. .. XXX If you're just trying to write a web application... diff -r 128fa5eea9b1 Doc/library/xml.rst --- a/Doc/library/xml.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/xml.rst Sat Dec 19 14:07:10 2015 +0100 @@ -62,7 +62,7 @@ billion laughs **Yes** **Yes** **Yes** **Yes** **Yes** quadratic blowup **Yes** **Yes** **Yes** **Yes** **Yes** external entity expansion **Yes** No (1) No (2) **Yes** No (3) -DTD retrieval **Yes** No No **Yes** No +`DTD`_ retrieval **Yes** No No **Yes** No decompression bomb No No No No **Yes** ========================= ======== ========= ========= ======== ========= @@ -92,7 +92,7 @@ also point to external resources or local files. The XML parser accesses the resource and embeds the content into the XML document. -DTD retrieval +`DTD`_ retrieval Some XML libraries like Python's :mod:`xml.dom.pulldom` retrieve document type definitions from remote or local locations. The feature has similar implications as the external entity expansion issue. @@ -128,6 +128,6 @@ .. _defusedxml: https://pypi.python.org/pypi/defusedxml/ .. _defusedexpat: https://pypi.python.org/pypi/defusedexpat/ -.. _Billion Laughs: http://en.wikipedia.org/wiki/Billion_laughs -.. _ZIP bomb: http://en.wikipedia.org/wiki/Zip_bomb -.. _DTD: http://en.wikipedia.org/wiki/Document_Type_Definition +.. _Billion Laughs: https://en.wikipedia.org/wiki/Billion_laughs +.. _ZIP bomb: https://en.wikipedia.org/wiki/Zip_bomb +.. _DTD: https://en.wikipedia.org/wiki/Document_type_definition diff -r 128fa5eea9b1 Doc/library/xmlrpc.client.rst --- a/Doc/library/xmlrpc.client.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/xmlrpc.client.rst Sat Dec 19 14:07:10 2015 +0100 @@ -142,7 +142,7 @@ `XML-RPC Introspection `_ Describes the XML-RPC protocol extension for introspection. - `XML-RPC Specification `_ + `XML-RPC Specification `_ The official specification. `Unofficial XML-RPC Errata `_ diff -r 128fa5eea9b1 Doc/library/zipfile.rst --- a/Doc/library/zipfile.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/zipfile.rst Sat Dec 19 14:07:10 2015 +0100 @@ -13,8 +13,7 @@ The ZIP file format is a common archive and compression standard. This module provides tools to create, read, write, append, and list a ZIP file. Any advanced use of this module will require an understanding of the format, as -defined in `PKZIP Application Note -`_. +defined in `PKZIP Application Note`_. This module does not currently handle multi-disk ZIP files. It can handle ZIP files that use the ZIP64 extensions @@ -115,7 +114,7 @@ .. seealso:: - `PKZIP Application Note `_ + `PKZIP Application Note`_ Documentation on the ZIP file format by Phil Katz, the creator of the format and algorithms used. @@ -511,8 +510,7 @@ .. attribute:: ZipInfo.extra - Expansion field data. The `PKZIP Application Note - `_ contains + Expansion field data. The `PKZIP Application Note`_ contains some comments on the internal structure of the data contained in this string. @@ -574,3 +572,5 @@ .. attribute:: ZipInfo.file_size Size of the uncompressed file. + +.. _PKZIP Application Note: https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT diff -r 128fa5eea9b1 Doc/library/zipimport.rst --- a/Doc/library/zipimport.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/library/zipimport.rst Sat Dec 19 14:07:10 2015 +0100 @@ -30,7 +30,7 @@ .. seealso:: - `PKZIP Application Note `_ + `PKZIP Application Note `_ Documentation on the ZIP file format by Phil Katz, the creator of the format and algorithms used. diff -r 128fa5eea9b1 Doc/using/mac.rst --- a/Doc/using/mac.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/using/mac.rst Sat Dec 19 14:07:10 2015 +0100 @@ -153,7 +153,7 @@ *PyQt* is another popular cross-platform GUI toolkit that runs natively on Mac OS X. More information can be found at -http://www.riverbankcomputing.co.uk/software/pyqt/intro. +https://riverbankcomputing.com/software/pyqt/intro. Distributing Python Applications on the Mac diff -r 128fa5eea9b1 Doc/using/unix.rst --- a/Doc/using/unix.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/using/unix.rst Sat Dec 19 14:07:10 2015 +0100 @@ -26,11 +26,11 @@ .. seealso:: - http://www.debian.org/doc/manuals/maint-guide/first.en.html + https://www.debian.org/doc/manuals/maint-guide/first.en.html for Debian users - http://en.opensuse.org/Portal:Packaging + https://en.opensuse.org/Portal:Packaging for OpenSuse users - http://docs.fedoraproject.org/en-US/Fedora_Draft_Documentation/0.1/html/RPM_Guide/ch-creating-rpms.html + https://docs.fedoraproject.org/en-US/Fedora_Draft_Documentation/0.1/html/RPM_Guide/ch-creating-rpms.html for Fedora users http://www.slackbook.org/html/package-management-making-packages.html for Slackware users @@ -65,7 +65,7 @@ =============== If you want to compile CPython yourself, first thing you should do is get the -`source `_. You can download either the +`source `_. You can download either the latest release's source or just grab a fresh `clone `_. (If you want to contribute patches, you will need a clone.) diff -r 128fa5eea9b1 Doc/using/venv-create.inc --- a/Doc/using/venv-create.inc Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/using/venv-create.inc Sat Dec 19 14:07:10 2015 +0100 @@ -14,7 +14,7 @@ .. seealso:: `Python Packaging User Guide: Creating and using virtual environments - `__ + `__ .. highlight:: none diff -r 128fa5eea9b1 Doc/using/windows.rst --- a/Doc/using/windows.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/using/windows.rst Sat Dec 19 14:07:10 2015 +0100 @@ -226,12 +226,12 @@ release/python>`_, `Maintainer releases `_) -See `Python for Windows `_ +See `Python for Windows `_ for detailed information about platforms with pre-compiled installers. .. seealso:: - `Python on XP `_ + `Python on XP `_ "7 Minutes to "Hello World!"" by Richard Dooling, 2006 @@ -254,10 +254,10 @@ additional functionality. The following is a list of popular versions and their key features: -`ActivePython `_ +`ActivePython `_ Installer with multi-platform compatibility, documentation, PyWin32 -`Anaconda `_ +`Anaconda `_ Popular scientific modules (such as numpy, scipy and pandas) and the ``conda`` package manager. @@ -327,16 +327,16 @@ .. seealso:: - http://support.microsoft.com/kb/100843 + https://support.microsoft.com/kb/100843 Environment variables in Windows NT - http://technet.microsoft.com/en-us/library/cc754250.aspx + https://technet.microsoft.com/en-us/library/cc754250.aspx The SET command, for temporarily modifying environment variables - http://technet.microsoft.com/en-us/library/cc755104.aspx + https://technet.microsoft.com/en-us/library/cc755104.aspx The SETX command, for permanently modifying environment variables - http://support.microsoft.com/kb/310519 + https://support.microsoft.com/kb/310519 How To Manage Environment Variables in Windows XP http://www.chem.gla.ac.uk/~louis/software/faq/q1.html @@ -756,18 +756,18 @@ PyWin32 ------- -The `PyWin32 `_ module by Mark Hammond +The `PyWin32 `_ module by Mark Hammond is a collection of modules for advanced Windows-specific support. This includes utilities for: -* `Component Object Model `_ (COM) +* `Component Object Model `_ (COM) * Win32 API calls * Registry * Event log -* `Microsoft Foundation Classes `_ (MFC) +* `Microsoft Foundation Classes `_ (MFC) user interfaces -`PythonWin `_ is a sample MFC application shipped with PyWin32. It is an embeddable IDE with a built-in debugger. @@ -806,7 +806,7 @@ =========================== If you want to compile CPython yourself, first thing you should do is get the -`source `_. You can download either the +`source `_. You can download either the latest release's source or just grab a fresh `checkout `_. @@ -849,7 +849,7 @@ .. note:: The embedded distribution does not include the `Microsoft C Runtime - `_ and it is + `_ and it is the responsibility of the application installer to provide this. The runtime may have already been installed on a user's system previously or automatically via Windows Update, and can be detected by finding diff -r 128fa5eea9b1 Doc/whatsnew/2.0.rst --- a/Doc/whatsnew/2.0.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/whatsnew/2.0.rst Sat Dec 19 14:07:10 2015 +0100 @@ -130,7 +130,7 @@ Read the rest of PEP 1 for the details of the PEP editorial process, style, and format. PEPs are kept in the Python CVS tree on SourceForge, though they're not part of the Python 2.0 distribution, and are also available in HTML form from -https://www.python.org/peps/. As of September 2000, there are 25 PEPS, ranging +https://www.python.org/dev/peps/. As of September 2000, there are 25 PEPS, ranging from PEP 201, "Lockstep Iteration", to PEP 225, "Elementwise/Objectwise Operators". @@ -337,7 +337,7 @@ [ (x,y) for x in seq1 for y in seq2] The idea of list comprehensions originally comes from the functional programming -language Haskell (http://www.haskell.org). Greg Ewing argued most effectively +language Haskell (https://www.haskell.org). Greg Ewing argued most effectively for adding them to Python and wrote the initial list comprehension patch, which was then discussed for a seemingly endless time on the python-dev mailing list and kept up-to-date by Skip Montanaro. diff -r 128fa5eea9b1 Doc/whatsnew/2.1.rst --- a/Doc/whatsnew/2.1.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/whatsnew/2.1.rst Sat Dec 19 14:07:10 2015 +0100 @@ -562,7 +562,7 @@ using Python 2.1, since a new release of the Distutils will be made for users of earlier Python versions. Version 1.0.2 of the Distutils includes the changes described in PEP 241, as well as various bugfixes and enhancements. It will be -available from the Distutils SIG at https://www.python.org/sigs/distutils-sig/. +available from the Distutils SIG at https://www.python.org/community/sigs/current/distutils-sig/. .. seealso:: diff -r 128fa5eea9b1 Doc/whatsnew/2.3.rst --- a/Doc/whatsnew/2.3.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/whatsnew/2.3.rst Sat Dec 19 14:07:10 2015 +0100 @@ -1080,9 +1080,9 @@ hierarchy. Classic classes are unaffected by this change. Python 2.2 originally used a topological sort of a class's ancestors, but 2.3 now uses the C3 algorithm as described in the paper `"A Monotonic Superclass Linearization - for Dylan" `_. To + for Dylan" `_. To understand the motivation for this change, read Michele Simionato's article - `"Python 2.3 Method Resolution Order" `_, or + `"Python 2.3 Method Resolution Order" `_, or read the thread on python-dev starting with the message at https://mail.python.org/pipermail/python-dev/2002-October/029035.html. Samuele Pedroni first pointed out the problem and also implemented the fix by coding the @@ -1306,7 +1306,7 @@ partially sorted order such that, for every index *k*, ``heap[k] <= heap[2*k+1]`` and ``heap[k] <= heap[2*k+2]``. This makes it quick to remove the smallest item, and inserting a new item while maintaining the heap property is - O(lg n). (See http://www.nist.gov/dads/HTML/priorityque.html for more + O(lg n). (See https://xlinux.nist.gov/dads//HTML/priorityque.html for more information about the priority queue data structure.) The :mod:`heapq` module provides :func:`heappush` and :func:`heappop` functions @@ -1949,7 +1949,7 @@ source distribution, were updated for 2.3. (Contributed by Sean Reifschneider.) Other new platforms now supported by Python include AtheOS -(http://www.atheos.cx/), GNU/Hurd, and OpenVMS. +(http://atheos.cx/), GNU/Hurd, and OpenVMS. .. ====================================================================== diff -r 128fa5eea9b1 Doc/whatsnew/2.4.rst --- a/Doc/whatsnew/2.4.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/whatsnew/2.4.rst Sat Dec 19 14:07:10 2015 +0100 @@ -337,7 +337,7 @@ wrote patches implementing function decorators, but the one that was actually checked in was patch #979728, written by Mark Russell. - https://www.python.org/moin/PythonDecoratorLibrary + https://wiki.python.org/moin/PythonDecoratorLibrary This Wiki page contains several examples of decorators. .. ====================================================================== @@ -687,7 +687,7 @@ The article uses Fortran code to illustrate many of the problems that floating- point inaccuracy can cause. - http://www2.hursley.ibm.com/decimal/ + http://speleotrove.com/decimal/ A description of a decimal-based representation. This representation is being proposed as a standard, and underlies the new Python decimal type. Much of this material was written by Mike Cowlishaw, designer of the Rexx language. @@ -756,7 +756,7 @@ :c:type:`double` to an ASCII string. The code for these functions came from the GLib library -(http://library.gnome.org/devel/glib/stable/), whose developers kindly +(https://developer.gnome.org/glib/stable/), whose developers kindly relicensed the relevant functions and donated them to the Python Software Foundation. The :mod:`locale` module can now change the numeric locale, letting extensions such as GTK+ produce the correct results. diff -r 128fa5eea9b1 Doc/whatsnew/2.5.rst --- a/Doc/whatsnew/2.5.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/whatsnew/2.5.rst Sat Dec 19 14:07:10 2015 +0100 @@ -330,7 +330,7 @@ :pep:`328` - Imports: Multi-Line and Absolute/Relative PEP written by Aahz; implemented by Thomas Wouters. - http://codespeak.net/py/current/doc/index.html + https://pylib.readthedocs.org/ The py library by Holger Krekel, which contains the :mod:`py.std` package. .. ====================================================================== @@ -547,7 +547,7 @@ Earlier versions of these features were proposed in :pep:`288` by Raymond Hettinger and :pep:`325` by Samuele Pedroni. - http://en.wikipedia.org/wiki/Coroutine + https://en.wikipedia.org/wiki/Coroutine The Wikipedia entry for coroutines. http://www.sidhe.org/~dan/blog/archives/000178.html @@ -2088,7 +2088,7 @@ provided the results of their examination of the Python source code. The analysis found about 60 bugs that were quickly fixed. Many of the bugs were refcounting problems, often occurring in error-handling code. See - http://scan.coverity.com for the statistics. + https://scan.coverity.com for the statistics. * The largest change to the C API came from :pep:`353`, which modifies the interpreter to use a :c:type:`Py_ssize_t` type definition instead of diff -r 128fa5eea9b1 Doc/whatsnew/2.6.rst --- a/Doc/whatsnew/2.6.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/whatsnew/2.6.rst Sat Dec 19 14:07:10 2015 +0100 @@ -153,8 +153,8 @@ therefore posted a call for issue trackers, asking volunteers to set up different products and import some of the bugs and patches from SourceForge. Four different trackers were examined: `Jira -`__, -`Launchpad `__, +`__, +`Launchpad `__, `Roundup `__, and `Trac `__. The committee eventually settled on Jira @@ -217,7 +217,7 @@ During the 2.6 development cycle, Georg Brandl put a lot of effort into building a new toolchain for processing the documentation. The resulting package is called Sphinx, and is available from -http://sphinx.pocoo.org/. +http://sphinx-doc.org/. Sphinx concentrates on HTML output, producing attractively styled and modern HTML; printed output is still supported through conversion to @@ -1796,7 +1796,7 @@ * The :mod:`bsddb` module also has a new maintainer, Jesús Cea Avión, and the package is now available as a standalone package. The web page for the package is `www.jcea.es/programacion/pybsddb.htm - `__. + `__. The plan is to remove the package from the standard library in Python 3.0, because its pace of releases is much more frequent than Python's. @@ -1926,7 +1926,7 @@ the left to six places. (Contributed by Skip Montanaro; :issue:`1158`.) * The :mod:`decimal` module was updated to version 1.66 of - `the General Decimal Specification `__. New features + `the General Decimal Specification `__. New features include some methods for some basic mathematical functions such as :meth:`exp` and :meth:`log10`:: diff -r 128fa5eea9b1 Doc/whatsnew/2.7.rst --- a/Doc/whatsnew/2.7.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/whatsnew/2.7.rst Sat Dec 19 14:07:10 2015 +0100 @@ -1029,7 +1029,7 @@ * Updated module: the :mod:`bsddb` module has been updated from 4.7.2devel9 to version 4.8.4 of - `the pybsddb package `__. + `the pybsddb package `__. The new version features better Python 3.x compatibility, various bug fixes, and adds several new BerkeleyDB flags and methods. (Updated by Jesús Cea Avión; :issue:`8156`. The pybsddb @@ -1513,7 +1513,7 @@ (Contributed by Kristján Valur Jónsson; :issue:`6192` and :issue:`6267`.) * Updated module: the :mod:`sqlite3` module has been updated to - version 2.6.0 of the `pysqlite package `__. Version 2.6.0 includes a number of bugfixes, and adds + version 2.6.0 of the `pysqlite package `__. Version 2.6.0 includes a number of bugfixes, and adds the ability to load SQLite extensions from shared libraries. Call the ``enable_load_extension(True)`` method to enable extensions, and then call :meth:`~sqlite3.Connection.load_extension` to load a particular shared library. diff -r 128fa5eea9b1 Doc/whatsnew/3.0.rst --- a/Doc/whatsnew/3.0.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/whatsnew/3.0.rst Sat Dec 19 14:07:10 2015 +0100 @@ -565,7 +565,7 @@ core standard library has proved over time to be a particular burden for the core developers due to testing instability and Berkeley DB's release schedule. However, the package is alive and well, - externally maintained at http://www.jcea.es/programacion/pybsddb.htm. + externally maintained at https://www.jcea.es/programacion/pybsddb.htm. * Some modules were renamed because their old name disobeyed :pep:`0008`, or for various other reasons. Here's the list: diff -r 128fa5eea9b1 Doc/whatsnew/3.2.rst --- a/Doc/whatsnew/3.2.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/whatsnew/3.2.rst Sat Dec 19 14:07:10 2015 +0100 @@ -845,9 +845,9 @@ * The :class:`collections.Counter` class now has two forms of in-place subtraction, the existing *-=* operator for `saturating subtraction - `_ and the new + `_ and the new :meth:`~collections.Counter.subtract` method for regular subtraction. The - former is suitable for `multisets `_ + former is suitable for `multisets `_ which only have positive counts, and the latter is more suitable for use cases that allow negative counts: @@ -906,7 +906,7 @@ complete. Barriers can work with an arbitrary number of threads. This is a generalization -of a `Rendezvous `_ which +of a `Rendezvous `_ which is defined for only two threads. Implemented as a two-phase cyclic barrier, :class:`~threading.Barrier` objects @@ -1043,7 +1043,7 @@ 0.013765762467652909 The :func:`~math.erf` function computes a probability integral or `Gaussian -error function `_. The +error function `_. The complementary error function, :func:`~math.erfc`, is ``1 - erf(x)``: >>> erf(1.0/sqrt(2.0)) # portion of normal distribution within 1 standard deviation @@ -1054,7 +1054,7 @@ 1.0 The :func:`~math.gamma` function is a continuous extension of the factorial -function. See http://en.wikipedia.org/wiki/Gamma_function for details. Because +function. See https://en.wikipedia.org/wiki/Gamma_function for details. Because the function is related to factorials, it grows large even for small values of *x*, so there is also a :func:`~math.lgamma` function for computing the natural logarithm of the gamma function: @@ -2180,7 +2180,7 @@ A number of usability improvements were made for the :mod:`urllib.parse` module. The :func:`~urllib.parse.urlparse` function now supports `IPv6 -`_ addresses as described in :rfc:`2732`: +`_ addresses as described in :rfc:`2732`: >>> import urllib.parse >>> urllib.parse.urlparse('http://[dead:beef:cafe:5417:affe:8FA3:deaf:feed]/foo/') @@ -2328,7 +2328,7 @@ (Contributed by Alexandre Vassalotti, Antoine Pitrou and the Unladen Swallow team in :issue:`9410` and :issue:`3873`.) -* The `Timsort algorithm `_ used in +* The `Timsort algorithm `_ used in :meth:`list.sort` and :func:`sorted` now runs faster and uses less memory when called with a :term:`key function`. Previously, every element of a list was wrapped with a temporary object that remembered the key value @@ -2380,7 +2380,7 @@ Python has been updated to `Unicode 6.0.0 `_. The update to the standard adds -over 2,000 new characters including `emoji `_ +over 2,000 new characters including `emoji `_ symbols which are important for mobile phones. In addition, the updated standard has altered the character properties for two @@ -2432,7 +2432,7 @@ **Source code** :source:`Lib/functools.py`. (Contributed by Raymond Hettinger; see - `rationale `_.) + `rationale `_.) * The docs now contain more examples and recipes. In particular, :mod:`re` module has an extensive section, :ref:`re-examples`. Likewise, the @@ -2468,7 +2468,7 @@ =============== In addition to the existing Subversion code repository at http://svn.python.org -there is now a `Mercurial `_ repository at +there is now a `Mercurial `_ repository at https://hg.python.org/\ . After the 3.2 release, there are plans to switch to Mercurial as the primary @@ -2478,7 +2478,7 @@ To learn to use the new version control system, see the `tutorial by Joel Spolsky `_ or the `Guide to Mercurial Workflows -`_. +`_. Build and C API Changes diff -r 128fa5eea9b1 Doc/whatsnew/3.3.rst --- a/Doc/whatsnew/3.3.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/whatsnew/3.3.rst Sat Dec 19 14:07:10 2015 +0100 @@ -1884,13 +1884,13 @@ Heiko Wundram) * The :class:`~socket.socket` class now supports the PF_CAN protocol family - (http://en.wikipedia.org/wiki/Socketcan), on Linux - (http://lwn.net/Articles/253425). + (https://en.wikipedia.org/wiki/Socketcan), on Linux + (https://lwn.net/Articles/253425). (Contributed by Matthias Fuchs, updated by Tiago Gonçalves in :issue:`10141`.) * The :class:`~socket.socket` class now supports the PF_RDS protocol family - (http://en.wikipedia.org/wiki/Reliable_Datagram_Sockets and + (https://en.wikipedia.org/wiki/Reliable_Datagram_Sockets and https://oss.oracle.com/projects/rds/). * The :class:`~socket.socket` class now supports the ``PF_SYSTEM`` protocol diff -r 128fa5eea9b1 Doc/whatsnew/3.4.rst --- a/Doc/whatsnew/3.4.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/whatsnew/3.4.rst Sat Dec 19 14:07:10 2015 +0100 @@ -144,7 +144,7 @@ all of the parent's inheritable handles, only the necessary ones. * A new :func:`hashlib.pbkdf2_hmac` function provides the `PKCS#5 password-based key derivation function 2 - `_. + `_. * :ref:`TLSv1.1 and TLSv1.2 support ` for :mod:`ssl`. * :ref:`Retrieving certificates from the Windows system cert store support ` for :mod:`ssl`. @@ -902,7 +902,7 @@ A new :func:`hashlib.pbkdf2_hmac` function provides the `PKCS#5 password-based key derivation function 2 -`_. (Contributed by Christian +`_. (Contributed by Christian Heimes in :issue:`18582`.) The :attr:`~hashlib.hash.name` attribute of :mod:`hashlib` hash objects is now @@ -1917,8 +1917,8 @@ :issue:`18596`.) * The Windows build now uses `Address Space Layout Randomization - `_ and `Data Execution Prevention - `_. (Contributed by + `_ and `Data Execution Prevention + `_. (Contributed by Christian Heimes in :issue:`16632`.) * New function :c:func:`PyObject_LengthHint` is the C API equivalent diff -r 128fa5eea9b1 Doc/whatsnew/3.5.rst --- a/Doc/whatsnew/3.5.rst Fri Dec 18 15:47:28 2015 -0500 +++ b/Doc/whatsnew/3.5.rst Sat Dec 19 14:07:10 2015 +0100 @@ -2169,7 +2169,7 @@ The :c:member:`PyTypeObject.tp_finalize` slot is now part of the stable ABI. Windows builds now require Microsoft Visual C++ 14.0, which -is available as part of `Visual Studio 2015 `_. +is available as part of `Visual Studio 2015 `_. Extension modules now include a platform information tag in their filename on some platforms (the tag is optional, and CPython will import extensions without diff -r 128fa5eea9b1 Misc/NEWS --- a/Misc/NEWS Fri Dec 18 15:47:28 2015 -0500 +++ b/Misc/NEWS Sat Dec 19 14:07:10 2015 +0100 @@ -7622,7 +7622,7 @@ - Issue #16245: Fix the value of a few entities in html.entities.html5. -- Issue #16301: Fix the localhost verification in urllib/request.py for file:// +- Issue #16301: Fix the localhost verification in urllib/request.py for ``file://`` urls. - Issue #16250: Fix the invocations of URLError which had misplaced filename