beeware · freakboy3742 · Feb 4, 2023 · Jan 31, 2023 · Jan 31, 2023 · Feb 1, 2023
diff --git a/changes/1762.doc.rst b/changes/1762.doc.rst
@@ -0,0 +1 @@
+API support tables now distinguish partial vs full support on each platform.
diff --git a/docs/_static/custom.css b/docs/_static/custom.css
@@ -1,14 +1,18 @@
-div.body table.widget-descriptions td p
-{
-    text-align: center;
+/* Draw lines around table edges. */
+table.docutils {
+    border: 1px solid var(--color-background-border);
 }
-div.body table.widget-support th p,
-div.body table.widget-support td p {
+
+.widget-descriptions td p,
+.widget-support td p {
     text-align: center;
 }
 
-div.body table.widget-descriptions td:first-of-type p,
-div.body table.widget-descriptions th:first-of-type p
-{
+.widget-descriptions th:first-of-type p {
     text-align: left;
 }
+
+.widget-support caption {
+    font-size: var(--font-size--normal);
+    font-weight: bold;
+}
diff --git a/docs/_static/yes.png b/docs/_static/yes.png
diff --git a/docs/conf.py b/docs/conf.py
@@ -100,6 +100,12 @@
 # A list of ignored prefixes for module index sorting.
 # modindex_common_prefix = []
 
+# API status indicators.
+rst_prolog = """
+.. |y| replace:: ●
+.. |b| replace:: ○
+"""
+
 
 # -- Options for HTML output ---------------------------------------------------
 

diff --git a/docs/reference/api/app.rst b/docs/reference/api/app.rst
@@ -2,15 +2,12 @@ Application
 ===========
 
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!(App|Component))'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 The app is the main entry point and container for the Toga GUI.
 
 Usage

diff --git a/docs/reference/api/containers/box.rst b/docs/reference/api/containers/box.rst
@@ -2,15 +2,12 @@ Box
 ===
 
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!(Box|Component))'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 The box is a generic container for widgets, allowing you to construct layouts.
 
 Usage

diff --git a/docs/reference/api/containers/optioncontainer.rst b/docs/reference/api/containers/optioncontainer.rst
@@ -2,15 +2,12 @@ Option Container
 ================
 
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!(OptionContainer|Component))'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 The Option Container widget is a user-selection control for choosing from a pre-configured list of controls, like a tab view.
 
 .. figure:: /reference/images/OptionContainer.jpeg

diff --git a/docs/reference/api/containers/scrollcontainer.rst b/docs/reference/api/containers/scrollcontainer.rst
@@ -2,15 +2,12 @@ Scroll Container
 ================
 
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!(ScrollContainer|Component))'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 The Scroll Container is similar to the iframe or scrollable div element in HTML, it contains an object with
 its own scrollable selection.
 

diff --git a/docs/reference/api/containers/splitcontainer.rst b/docs/reference/api/containers/splitcontainer.rst
@@ -2,15 +2,12 @@ Split Container
 ===============
 
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!(SplitContainer|Component))'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 The split container is a container with a movable split and the option for 2 or 3 elements.
 
 .. figure:: /reference/images/SplitContainer.jpeg

diff --git a/docs/reference/api/index.rst b/docs/reference/api/index.rst
@@ -67,9 +67,6 @@ Resources
  :doc:`Image </reference/api/resources/images>`      An image
 =================================================== =================================
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 .. toctree::
    :hidden:
 

diff --git a/docs/reference/api/mainwindow.rst b/docs/reference/api/mainwindow.rst
@@ -2,15 +2,12 @@ MainWindow
 ==========
 
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!(MainWindow|Component))'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 A window for displaying components to the user
 
 Usage

diff --git a/docs/reference/api/resources/command.rst b/docs/reference/api/resources/command.rst
@@ -2,15 +2,12 @@ Command
 =======
 
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!(Command|Component))'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 
 Usage
 -----

diff --git a/docs/reference/api/resources/fonts.rst b/docs/reference/api/resources/fonts.rst
@@ -2,15 +2,12 @@ Font
 ====
 
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!(Font|Component))'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 The font class is used for abstracting the platforms implementation of fonts.
 
 Reference

diff --git a/docs/reference/api/resources/group.rst b/docs/reference/api/resources/group.rst
@@ -2,15 +2,12 @@ Group
 =====
 
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!(Group|Component))'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 
 
 Usage

diff --git a/docs/reference/api/resources/icons.rst b/docs/reference/api/resources/icons.rst
@@ -2,15 +2,12 @@ Icon
 ====
 
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!(Icon|Component))'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 
 Usage
 -----

diff --git a/docs/reference/api/resources/images.rst b/docs/reference/api/resources/images.rst
@@ -2,15 +2,12 @@ Image
 =====
 
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!(Image|Component)$)'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 
 An image is graphical content of arbitrary size.
 

diff --git a/docs/reference/api/widgets/activityindicator.rst b/docs/reference/api/widgets/activityindicator.rst
@@ -2,15 +2,12 @@ Activity Indicator
 ==================
 
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!^(ActivityIndicator|Component)$)'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 The activity indicator is a (spinning) animation for showing progress in an indeterminate task.
 
 Usage

diff --git a/docs/reference/api/widgets/button.rst b/docs/reference/api/widgets/button.rst
@@ -8,19 +8,13 @@ A widget that can be pressed or clicked to cause an action in an application.
     :align: center
     :width: 300
 
-Availability
-------------
-
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!(Button|Component))'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 Usage
 -----
 

diff --git a/docs/reference/api/widgets/canvas.rst b/docs/reference/api/widgets/canvas.rst
@@ -2,15 +2,12 @@ Canvas
 ======
 
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!(Canvas|Component))'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 The canvas is used for creating a blank widget that you can draw on.
 
 Usage

diff --git a/docs/reference/api/widgets/detailedlist.rst b/docs/reference/api/widgets/detailedlist.rst
@@ -2,15 +2,12 @@ DetailedList
 ============
 
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!(DetailedList|Component))'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 
 
 Usage

diff --git a/docs/reference/api/widgets/divider.rst b/docs/reference/api/widgets/divider.rst
@@ -2,15 +2,12 @@ Divider
 =======
 
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!(Divider|Component))'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 The divider is used to visually separate sections of a user layout with a line.
 
 Usage

diff --git a/docs/reference/api/widgets/imageview.rst b/docs/reference/api/widgets/imageview.rst
@@ -2,15 +2,12 @@ Image View
 ==========
 
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!^(ImageView|Component)$)'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 The Image View is a container for an image to be rendered on the display
 
 Usage

diff --git a/docs/reference/api/widgets/label.rst b/docs/reference/api/widgets/label.rst
@@ -6,18 +6,13 @@ A text label for annotating forms or interfaces.
 .. figure:: /reference/images/Label.jpeg
     :align: center
 
-Availability
-------------
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!^(Label|Component)$)'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 Usage
 -----
 

diff --git a/docs/reference/api/widgets/multilinetextinput.rst b/docs/reference/api/widgets/multilinetextinput.rst
@@ -2,15 +2,12 @@ Multi-line text input
 =====================
 
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!^(MultilineTextInput|Component)$)'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 The Multi-line text input is similar to the text input but designed for larger inputs, similar to the textarea field of HTML.
 
 Usage

diff --git a/docs/reference/api/widgets/numberinput.rst b/docs/reference/api/widgets/numberinput.rst
@@ -2,15 +2,12 @@ Number Input
 ============
 
 .. rst-class:: widget-support
-.. csv-filter::
+.. csv-filter:: Availability (:ref:`Key <api-status-key>`)
    :header-rows: 1
    :file: ../../data/widgets_by_platform.csv
    :included_cols: 4,5,6,7,8,9
    :exclude: {0: '(?!^(NumberInput|Component)$)'}
 
-.. |y| image:: /_static/yes.png
-    :width: 16
-
 The Number input is a text input box that is limited to numeric input.
 
 .. figure:: /reference/images/NumberInput.jpeg
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		API support tables now distinguish partial vs full support on each platform.