docs: Update CPython differences and improve the look of table layouts.

Updated some of the CPython feature differences: - Updated status of some features. - Added CSS to fix table widths to 100% and word wrap. - Specified explicit table column ratios to improve layout appearance. - Added missing references to anchors. - Better consistency with use of formatting and case.

Author: mattytrentini

docs/conf.py

@@ -166,6 +166,10 @@
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ['static']
 
+# Add a custom CSS file for HTML generation
+html_css_files = [
+ 'custom.css',
+]
 # Add any extra paths that contain custom files (such as robots.txt or
 # .htaccess) here, relative to this directory. These files are copied
 # directly to the root of the documentation.

docs/differences/python_35.rst

@@ -5,53 +5,59 @@ Python 3.6
 
 Python 3.6 beta 1 was released on 12 Sep 2016, and a summary of the new features can be found here:
 
- +-----------------------------------------------------------------------------------------------------------+--------------+
- | **New Syntax Features:** | **Status** |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | `PEP 498 <https://www.python.org/dev/peps/pep-0498/>`_ | Literal String Formatting | |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | `PEP 515 <https://www.python.org/dev/peps/pep-0515/>`_ | Underscores in Numeric Literals | |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | `PEP 525 <https://www.python.org/dev/peps/pep-0525/>`_ | Asynchronous Generators | |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | `PEP 526 <https://www.python.org/dev/peps/pep-0526/>`_ | Syntax for Variable Annotations (provisional) | |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | `PEP 530 <https://www.python.org/dev/peps/pep-0530/>`_ | Asynchronous Comprehensions | |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | **New Built-in Features:** |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | `PEP 468 <https://www.python.org/dev/peps/pep-0468/>`_ | Preserving the order of *kwargs* in a function | |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | `PEP 487 <https://www.python.org/dev/peps/pep-0487/>`_ | Simpler customization of class creation | |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | `PEP 520 <https://www.python.org/dev/peps/pep-0520/>`_ | Preserving Class Attribute Definition Order | |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | **Standard Library Changes:** |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | `PEP 495 <https://www.python.org/dev/peps/pep-0495/>`_ | Local Time Disambiguation | |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | `PEP 506 <https://www.python.org/dev/peps/pep-0506/>`_ | Adding A Secrets Module To The Standard Library | |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | `PEP 519 <https://www.python.org/dev/peps/pep-0519/>`_ | Adding a file system path protocol | |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | **CPython internals:** |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | `PEP 509 <https://www.python.org/dev/peps/pep-0509/>`_ | Add a private version to dict | |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | `PEP 523 <https://www.python.org/dev/peps/pep-0523/>`_ | Adding a frame evaluation API to CPython | |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | **Linux/Window Changes** |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | `PEP 524 <https://www.python.org/dev/peps/pep-0524/>`_ | Make os.urandom() blocking on Linux | |
- | | (during system startup) | |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | `PEP 528 <https://www.python.org/dev/peps/pep-0528/>`_ | Change Windows console encoding to UTF-8 | |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
- | `PEP 529 <https://www.python.org/dev/peps/pep-0529/>`_ | Change Windows filesystem encoding to UTF-8 | |
- +--------------------------------------------------------+--------------------------------------------------+--------------+
+.. table::
+ :widths: 30 50 20
+
+ +-----------------------------------------------------------------------------------------------------------+-----------------+
+ | **New Syntax Features** | **Status** |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | `PEP 498 <https://www.python.org/dev/peps/pep-0498/>`_ | Literal String Formatting | Complete |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | `PEP 515 <https://www.python.org/dev/peps/pep-0515/>`_ | Underscores in Numeric Literals | Complete |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | `PEP 525 <https://www.python.org/dev/peps/pep-0525/>`_ | Asynchronous Generators | |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | `PEP 526 <https://www.python.org/dev/peps/pep-0526/>`_ | Syntax for Variable Annotations (provisional) | Complete |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | `PEP 530 <https://www.python.org/dev/peps/pep-0530/>`_ | Asynchronous Comprehensions | |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | **New Built-in Features** |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | `PEP 468 <https://www.python.org/dev/peps/pep-0468/>`_ | Preserving the order of *kwargs* in a function | |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | `PEP 487 <https://www.python.org/dev/peps/pep-0487/>`_ | Simpler customization of class creation | |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | `PEP 520 <https://www.python.org/dev/peps/pep-0520/>`_ | Preserving Class Attribute Definition Order | |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | **Standard Library Changes** |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | `PEP 495 <https://www.python.org/dev/peps/pep-0495/>`_ | Local Time Disambiguation | |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | `PEP 506 <https://www.python.org/dev/peps/pep-0506/>`_ | Adding A Secrets Module To The Standard Library | |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | `PEP 519 <https://www.python.org/dev/peps/pep-0519/>`_ | Adding a file system path protocol | |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | **CPython Internals** |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | `PEP 509 <https://www.python.org/dev/peps/pep-0509/>`_ | Add a private version to dict | Won't do |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | `PEP 523 <https://www.python.org/dev/peps/pep-0523/>`_ | Adding a frame evaluation API to CPython | |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | **Linux/Window Changes** |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | `PEP 524 <https://www.python.org/dev/peps/pep-0524/>`_ | Make ``os.urandom()`` blocking on Linux | |
+ | | (during system startup) | |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | `PEP 528 <https://www.python.org/dev/peps/pep-0528/>`_ | Change Windows console encoding to UTF-8 | |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
+ | `PEP 529 <https://www.python.org/dev/peps/pep-0529/>`_ | Change Windows filesystem encoding to UTF-8 | |
+ +--------------------------------------------------------+--------------------------------------------------+-----------------+
 
 Other Language Changes:
 
+.. table::
+ :widths: 90 10
+
  +-------------------------------------------------------------------------------------------------------------+---------------+
  | A *global* or *nonlocal* statement must now textually appear before the first use of the affected name in | |
  | the same scope. Previously this was a SyntaxWarning. | |
@@ -71,14 +77,17 @@ Other Language Changes:
 
 Changes to built-in modules:
 
+.. table::
+ :widths: 90 10
+
  +--------------------------------------------------------------------------------------------------------------+----------------+
  | `array <https://docs.python.org/3.6/whatsnew/3.6.html#array>`_ | |
  +--------------------------------------------------------------------------------------------------------------+----------------+
  | Exhausted iterators of *array.array* will now stay exhausted even if the iterated array is extended. | |
  +--------------------------------------------------------------------------------------------------------------+----------------+
  | `binascii <https://docs.python.org/3.6/whatsnew/3.6.html#binascii>`_ | |
  +--------------------------------------------------------------------------------------------------------------+----------------+
- | The b2a_base64() function now accepts an optional newline keyword argument to control whether the newline | Completed |
+ | The b2a_base64() function now accepts an optional newline keyword argument to control whether the newline | Complete  |
  | character is appended to the return value | |
  +--------------------------------------------------------------------------------------------------------------+----------------+
  | `cmath <https://docs.python.org/3.6/whatsnew/3.6.html#cmath>`_ | |
@@ -121,7 +130,7 @@ Changes to built-in modules:
  +--------------------------------------------------------------------------------------------------------------+----------------+
  | `math <https://docs.python.org/3.6/whatsnew/3.6.html#math>`_ |
  +--------------------------------------------------------------------------------------------------------------+----------------+
- | The new math.tau (τ) constant has been added | Completed |
+ | The new math.tau (τ) constant has been added | Complete  |
  +--------------------------------------------------------------------------------------------------------------+----------------+
  | `os <https://docs.python.org/3.6/whatsnew/3.6.html#os>`_ |
  +--------------------------------------------------------------------------------------------------------------+----------------+
@@ -136,7 +145,7 @@ Changes to built-in modules:
  | `re <https://docs.python.org/3.6/whatsnew/3.6.html#re>`_ |
  +--------------------------------------------------------------------------------------------------------------+----------------+
  | Added support of modifier spans in regular expressions. Examples: *'(?i:p)ython'* matches 'python' and | |
- | 'Python', but not 'PYTHON'; *'(?i)g(?-i:v)r'* matches *'GvR'* and *'gvr'*, but not *'GVR'* . | |
+ | 'Python', but not 'PYTHON'; *'(?i)g(?-i:v)r'* matches *'GvR'* and *'gvr'*, but not *'GVR'*.  | |
  +--------------------------------------------------------------------------------------------------------------+----------------+
  | Match object groups can be accessed by *__getitem__*, which is equivalent to *group()*. So *mo['name']* is | |
  | now equivalent to *mo.group('name')*. | |