summaryrefslogtreecommitdiff
path: root/Doc/library
diff options
context:
space:
mode:
Diffstat (limited to 'Doc/library')
-rw-r--r--Doc/library/codecs.rst10
-rw-r--r--Doc/library/collections.abc.rst4
-rw-r--r--Doc/library/concurrent.futures.rst2
-rw-r--r--Doc/library/email.policy.rst2
-rw-r--r--Doc/library/functions.rst2
-rw-r--r--Doc/library/inspect.rst2
-rw-r--r--Doc/library/io.rst2
-rw-r--r--Doc/library/locale.rst2
-rw-r--r--Doc/library/logging.rst2
-rw-r--r--Doc/library/subprocess.rst2
-rw-r--r--Doc/library/sys.rst6
-rw-r--r--Doc/library/tkinter.ttk.rst56
-rw-r--r--Doc/library/turtle.rst4
-rw-r--r--Doc/library/warnings.rst2
-rw-r--r--Doc/library/xml.etree.elementtree.rst2
-rw-r--r--Doc/library/xmlrpc.client.rst2
16 files changed, 82 insertions, 20 deletions
diff --git a/Doc/library/codecs.rst b/Doc/library/codecs.rst
index 28ea89dfd2..9e1a9c744a 100644
--- a/Doc/library/codecs.rst
+++ b/Doc/library/codecs.rst
@@ -315,6 +315,8 @@ To simplify and standardize error handling, the :meth:`encode` and
providing the *errors* string argument. The following string values are defined
and implemented by all standard Python codecs:
+.. tabularcolumns:: |l|L|
+
+-------------------------+-----------------------------------------------+
| Value | Meaning |
+=========================+===============================================+
@@ -926,6 +928,8 @@ particular, the following variants typically exist:
* an IBM PC code page, which is ASCII compatible
+.. tabularcolumns:: |l|p{0.3\linewidth}|p{0.3\linewidth}|
+
+-----------------+--------------------------------+--------------------------------+
| Codec | Aliases | Languages |
+=================+================================+================================+
@@ -1140,6 +1144,8 @@ particular, the following variants typically exist:
.. XXX fix here, should be in above table
+.. tabularcolumns:: |l|p{0.3\linewidth}|p{0.3\linewidth}|
+
+--------------------+---------+---------------------------+
| Codec | Aliases | Purpose |
+====================+=========+===========================+
@@ -1182,6 +1188,8 @@ particular, the following variants typically exist:
The following codecs provide bytes-to-bytes mappings.
+.. tabularcolumns:: |l|p{0.3\linewidth}|p{0.3\linewidth}|
+
+--------------------+---------------------------+---------------------------+
| Codec | Aliases | Purpose |
+====================+===========================+===========================+
@@ -1208,6 +1216,8 @@ The following codecs provide bytes-to-bytes mappings.
The following codecs provide string-to-string mappings.
+.. tabularcolumns:: |l|p{0.3\linewidth}|p{0.3\linewidth}|
+
+--------------------+---------------------------+---------------------------+
| Codec | Aliases | Purpose |
+====================+===========================+===========================+
diff --git a/Doc/library/collections.abc.rst b/Doc/library/collections.abc.rst
index 5eea0df2fb..115ce101b0 100644
--- a/Doc/library/collections.abc.rst
+++ b/Doc/library/collections.abc.rst
@@ -31,6 +31,8 @@ Collections Abstract Base Classes
The collections module offers the following :term:`ABCs <abstract base class>`:
+.. tabularcolumns:: |l|L|L|L|
+
========================= ===================== ====================== ====================================================
ABC Inherits from Abstract Methods Mixin Methods
========================= ===================== ====================== ====================================================
@@ -134,7 +136,7 @@ classes supporting container APIs. For example, to write a class supporting
the full :class:`Set` API, it only necessary to supply the three underlying
abstract methods: :meth:`__contains__`, :meth:`__iter__`, and :meth:`__len__`.
The ABC supplies the remaining methods such as :meth:`__and__` and
-:meth:`isdisjoint` ::
+:meth:`isdisjoint`::
class ListBasedSet(collections.Set):
''' Alternate set implementation favoring space over speed
diff --git a/Doc/library/concurrent.futures.rst b/Doc/library/concurrent.futures.rst
index 7ed99d5619..51584efcb3 100644
--- a/Doc/library/concurrent.futures.rst
+++ b/Doc/library/concurrent.futures.rst
@@ -346,6 +346,8 @@ Module Functions
*return_when* indicates when this function should return. It must be one of
the following constants:
+ .. tabularcolumns:: |l|L|
+
+-----------------------------+----------------------------------------+
| Constant | Description |
+=============================+========================================+
diff --git a/Doc/library/email.policy.rst b/Doc/library/email.policy.rst
index 51ac5c0738..06d98214ca 100644
--- a/Doc/library/email.policy.rst
+++ b/Doc/library/email.policy.rst
@@ -139,6 +139,8 @@ added matters. To illustrate::
Controls the type of Content Transfer Encodings that may be or are
required to be used. The possible values are:
+ .. tabularcolumns:: |l|L|
+
======== ===============================================================
``7bit`` all data must be "7 bit clean" (ASCII-only). This means that
where necessary data will be encoded using either
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 91d0aaf317..c82e03f072 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -843,7 +843,7 @@ are always available. They are listed here in alphabetical order.
========= ===============================================================
Character Meaning
- --------- ---------------------------------------------------------------
+ ========= ===============================================================
``'r'`` open for reading (default)
``'w'`` open for writing, truncating the file first
``'x'`` open for exclusive creation, failing if the file already exists
diff --git a/Doc/library/inspect.rst b/Doc/library/inspect.rst
index 01bbce8f50..40f482b614 100644
--- a/Doc/library/inspect.rst
+++ b/Doc/library/inspect.rst
@@ -520,6 +520,8 @@ function.
Describes how argument values are bound to the parameter. Possible values
(accessible via :class:`Parameter`, like ``Parameter.KEYWORD_ONLY``):
+ .. tabularcolumns:: |l|L|
+
+------------------------+----------------------------------------------+
| Name | Meaning |
+========================+==============================================+
diff --git a/Doc/library/io.rst b/Doc/library/io.rst
index d30c5fde70..a8d5fe3667 100644
--- a/Doc/library/io.rst
+++ b/Doc/library/io.rst
@@ -187,6 +187,8 @@ Argument names are not part of the specification, and only the arguments of
The following table summarizes the ABCs provided by the :mod:`io` module:
+.. tabularcolumns:: |l|l|L|L|
+
========================= ================== ======================== ==================================================
ABC Inherits Stub Methods Mixin Methods and Properties
========================= ================== ======================== ==================================================
diff --git a/Doc/library/locale.rst b/Doc/library/locale.rst
index d46f1cfd9d..9600193547 100644
--- a/Doc/library/locale.rst
+++ b/Doc/library/locale.rst
@@ -55,6 +55,8 @@ The :mod:`locale` module defines the following exception and functions:
Returns the database of the local conventions as a dictionary. This dictionary
has the following strings as keys:
+ .. tabularcolumns:: |l|l|L|
+
+----------------------+-------------------------------------+--------------------------------+
| Category | Key | Meaning |
+======================+=====================================+================================+
diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 11863a9457..8203733409 100644
--- a/Doc/library/logging.rst
+++ b/Doc/library/logging.rst
@@ -1037,6 +1037,8 @@ functions.
The following keyword arguments are supported.
+ .. tabularcolumns:: |l|L|
+
+--------------+---------------------------------------------+
| Format | Description |
+==============+=============================================+
diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
index a72ca44022..4212e0250a 100644
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -169,6 +169,8 @@ use cases, the underlying :class:`Popen` interface can be used directly.
.. versionadded:: 3.1
+ ..
+
.. warning::
Invoking the system shell with ``shell=True`` can be a security hazard
diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
index 7745559def..e7e853dd8e 100644
--- a/Doc/library/sys.rst
+++ b/Doc/library/sys.rst
@@ -307,6 +307,8 @@ always available.
programming language; see section 5.2.4.2.2 of the 1999 ISO/IEC C standard
[C99]_, 'Characteristics of floating types', for details.
+ .. tabularcolumns:: |l|l|L|
+
+---------------------+----------------+--------------------------------------------------+
| attribute | float.h macro | explanation |
+=====================+================+==================================================+
@@ -646,6 +648,8 @@ always available.
A :term:`struct sequence` that holds information about Python's internal
representation of integers. The attributes are read only.
+ .. tabularcolumns:: |l|L|
+
+-------------------------+----------------------------------------------+
| Attribute | Explanation |
+=========================+==============================================+
@@ -1079,6 +1083,8 @@ always available.
A :term:`struct sequence` holding information about the thread
implementation.
+ .. tabularcolumns:: |l|p{0.7\linewidth}|
+
+------------------+---------------------------------------------------------+
| Attribute | Explanation |
+==================+=========================================================+
diff --git a/Doc/library/tkinter.ttk.rst b/Doc/library/tkinter.ttk.rst
index ed351f5a3c..9860c86338 100644
--- a/Doc/library/tkinter.ttk.rst
+++ b/Doc/library/tkinter.ttk.rst
@@ -102,6 +102,8 @@ Standard Options
All the :mod:`ttk` Widgets accepts the following options:
+ .. tabularcolumns:: |l|L|
+
+-----------+--------------------------------------------------------------+
| Option | Description |
+===========+==============================================================+
@@ -134,8 +136,10 @@ Scrollable Widget Options
The following options are supported by widgets that are controlled by a
scrollbar.
+ .. tabularcolumns:: |l|L|
+
+----------------+---------------------------------------------------------+
- | option | description |
+ | Option | Description |
+================+=========================================================+
| xscrollcommand | Used to communicate with horizontal scrollbars. |
| | |
@@ -158,11 +162,10 @@ Label Options
The following options are supported by labels, buttons and other button-like
widgets.
-.. tabularcolumns:: |p{0.2\textwidth}|p{0.7\textwidth}|
-..
+ .. tabularcolumns:: |l|p{0.7\linewidth}|
+--------------+-----------------------------------------------------------+
- | option | description |
+ | Option | Description |
+==============+===========================================================+
| text | Specifies a text string to be displayed inside the widget.|
+--------------+-----------------------------------------------------------+
@@ -202,8 +205,10 @@ widgets.
Compatibility Options
^^^^^^^^^^^^^^^^^^^^^
+ .. tabularcolumns:: |l|L|
+
+--------+----------------------------------------------------------------+
- | option | description |
+ | Option | Description |
+========+================================================================+
| state | May be set to "normal" or "disabled" to control the "disabled" |
| | state bit. This is a write-only option: setting it changes the |
@@ -216,8 +221,10 @@ Widget States
The widget state is a bitmap of independent state flags.
+ .. tabularcolumns:: |l|L|
+
+------------+-------------------------------------------------------------+
- | flag | description |
+ | Flag | Description |
+============+=============================================================+
| active | The mouse cursor is over the widget and pressing a mouse |
| | button will cause some action to occur |
@@ -301,8 +308,10 @@ Options
This widget accepts the following specific options:
+ .. tabularcolumns:: |l|L|
+
+-----------------+--------------------------------------------------------+
- | option | description |
+ | Option | Description |
+=================+========================================================+
| exportselection | Boolean value. If set, the widget selection is linked |
| | to the Window Manager selection (which can be returned |
@@ -380,8 +389,10 @@ Options
This widget accepts the following specific options:
+ .. tabularcolumns:: |l|L|
+
+---------+----------------------------------------------------------------+
- | option | description |
+ | Option | Description |
+=========+================================================================+
| height | If present and greater than zero, specifies the desired height |
| | of the pane area (not including internal padding or tabs). |
@@ -404,8 +415,10 @@ Tab Options
There are also specific options for tabs:
+ .. tabularcolumns:: |l|L|
+
+-----------+--------------------------------------------------------------+
- | option | description |
+ | Option | Description |
+===========+==============================================================+
| state | Either "normal", "disabled" or "hidden". If "disabled", then |
| | the tab is not selectable. If "hidden", then the tab is not |
@@ -566,8 +579,10 @@ Options
This widget accepts the following specific options:
+ .. tabularcolumns:: |l|L|
+
+----------+---------------------------------------------------------------+
- | option | description |
+ | Option | Description |
+==========+===============================================================+
| orient | One of "horizontal" or "vertical". Specifies the orientation |
| | of the progress bar. |
@@ -635,8 +650,10 @@ Options
This widget accepts the following specific option:
+ .. tabularcolumns:: |l|L|
+
+--------+----------------------------------------------------------------+
- | option | description |
+ | Option | Description |
+========+================================================================+
| orient | One of "horizontal" or "vertical". Specifies the orientation of|
| | the separator. |
@@ -701,11 +718,10 @@ Options
This widget accepts the following specific options:
-.. tabularcolumns:: |p{0.2\textwidth}|p{0.7\textwidth}|
-..
+ .. tabularcolumns:: |l|p{0.7\linewidth}|
+----------------+--------------------------------------------------------+
- | option | description |
+ | Option | Description |
+================+========================================================+
| columns | A list of column identifiers, specifying the number of |
| | columns and their names. |
@@ -753,8 +769,10 @@ Item Options
The following item options may be specified for items in the insert and item
widget commands.
+ .. tabularcolumns:: |l|L|
+
+--------+---------------------------------------------------------------+
- | option | description |
+ | Option | Description |
+========+===============================================================+
| text | The textual label to display for the item. |
+--------+---------------------------------------------------------------+
@@ -779,8 +797,10 @@ Tag Options
The following options may be specified on tags:
+ .. tabularcolumns:: |l|L|
+
+------------+-----------------------------------------------------------+
- | option | description |
+ | Option | Description |
+============+===========================================================+
| foreground | Specifies the text foreground color. |
+------------+-----------------------------------------------------------+
@@ -822,8 +842,10 @@ Virtual Events
The Treeview widget generates the following virtual events.
+ .. tabularcolumns:: |l|L|
+
+--------------------+--------------------------------------------------+
- | event | description |
+ | Event | Description |
+====================+==================================================+
| <<TreeviewSelect>> | Generated whenever the selection changes. |
+--------------------+--------------------------------------------------+
diff --git a/Doc/library/turtle.rst b/Doc/library/turtle.rst
index 4373f78d70..aea9450bec 100644
--- a/Doc/library/turtle.rst
+++ b/Doc/library/turtle.rst
@@ -2301,9 +2301,11 @@ The :mod:`turtledemo` package directory contains:
The demo scripts are:
+.. tabularcolumns:: |l|L|L|
+
+----------------+------------------------------+-----------------------+
| Name | Description | Features |
-+----------------+------------------------------+-----------------------+
++================+==============================+=======================+
| bytedesign | complex classical | :func:`tracer`, delay,|
| | turtle graphics pattern | :func:`update` |
+----------------+------------------------------+-----------------------+
diff --git a/Doc/library/warnings.rst b/Doc/library/warnings.rst
index 8387f5a15f..ce69f7bd46 100644
--- a/Doc/library/warnings.rst
+++ b/Doc/library/warnings.rst
@@ -54,6 +54,8 @@ There are a number of built-in exceptions that represent warning categories.
This categorization is useful to be able to filter out groups of warnings. The
following warnings category classes are currently defined:
+.. tabularcolumns:: |l|p{0.6\linewidth}|
+
+----------------------------------+-----------------------------------------------+
| Class | Description |
+==================================+===============================================+
diff --git a/Doc/library/xml.etree.elementtree.rst b/Doc/library/xml.etree.elementtree.rst
index e429f04d72..45a0e7b308 100644
--- a/Doc/library/xml.etree.elementtree.rst
+++ b/Doc/library/xml.etree.elementtree.rst
@@ -278,6 +278,8 @@ module. We'll be using the ``countrydata`` XML document from the
Supported XPath syntax
^^^^^^^^^^^^^^^^^^^^^^
+.. tabularcolumns:: |l|L|
+
+-----------------------+------------------------------------------------------+
| Syntax | Meaning |
+=======================+======================================================+
diff --git a/Doc/library/xmlrpc.client.rst b/Doc/library/xmlrpc.client.rst
index 3a536559f7..bc4d4aa064 100644
--- a/Doc/library/xmlrpc.client.rst
+++ b/Doc/library/xmlrpc.client.rst
@@ -72,6 +72,8 @@ between conformable Python objects and XML on the wire.
(e.g. that can be marshalled through XML), include the following (and except
where noted, they are unmarshalled as the same Python type):
+ .. tabularcolumns:: |l|L|
+
+---------------------------------+---------------------------------------------+
| Name | Meaning |
+=================================+=============================================+
View Lorry Controller Status