Correct tables in documentation.

anthony-tuininga · anthony-tuininga · commit b50631bf9eab · 2022-06-22T15:35:03.000-06:00
diff --git a/doc/src/.static/custom.css b/doc/src/.static/custom.css
@@ -0,0 +1,4 @@
+/* Added code to display tables without horizontal scrollbars */
+.wy-table-responsive table td, .wy-table-responsive table th {
+    white-space: normal;
+}
diff --git a/doc/src/api_manual/cursor.rst b/doc/src/api_manual/cursor.rst
@@ -385,8 +385,10 @@ Cursor Methods
     types:
 
     .. list-table-with-summary::
-        :summary: The first column is the Python Type. The second column is the corresponding Database Type.
         :header-rows: 1
+        :class: wy-table-responsive
+        :align: center
+        :summary: The first column is the Python Type. The second column is the corresponding Database Type.
 
         * - Python Type
           - Database Type
diff --git a/doc/src/api_manual/deprecations.rst b/doc/src/api_manual/deprecations.rst
@@ -11,8 +11,7 @@ if applicable. The most recent deprecations are listed first.
 
 .. list-table-with-summary:: Deprecated in python-oracledb 1.0
     :header-rows: 1
-    :widths: 25 75
-    :width: 100%
+    :class: wy-table-responsive
     :summary: The first column, Name, displays the deprecated API name. The second column, Comments, includes information about when the API was deprecated and what API to use, if applicable.
     :name: _deprecations_1
 
@@ -110,8 +109,7 @@ python-oracledb are listed below:
 
 .. list-table-with-summary:: Deprecated in cx_Oracle 8.2
     :header-rows: 1
-    :widths: 25 75
-    :width: 100%
+    :class: wy-table-responsive
     :summary: The first column, Name, displays the deprecated API name. The second column,
      Comments, includes information about when the API was deprecated and what API to use,
      if applicable.
@@ -209,8 +207,7 @@ python-oracledb are listed below:
 
 .. list-table-with-summary:: Deprecated in cx_Oracle 8.0
     :header-rows: 1
-    :widths: 25 75
-    :width: 100%
+    :class: wy-table-responsive
     :summary: The first column, Name, displays the deprecated API name. The second column, Comments, includes information about when the API was deprecated and what API to use, if applicable.
     :name: _deprecations_8_0
 
@@ -252,8 +249,7 @@ python-oracledb are listed below:
 
 .. list-table-with-summary:: Deprecated in cx_Oracle 7.2
     :header-rows: 1
-    :widths: 25 75
-    :width: 100%
+    :class: wy-table-responsive
     :summary: The first column, Name, displays the deprecated API name. The second column, Comments, includes information about when the API was deprecated and what API to use, if applicable.
     :name: _deprecations_7_2
 
@@ -271,8 +267,7 @@ python-oracledb are listed below:
 
 .. list-table-with-summary:: Deprecated in cx_Oracle 6.4
     :header-rows: 1
-    :widths: 25 75
-    :width: 100%
+    :class: wy-table-responsive
     :summary: The first column, Name, displays the deprecated API name. The second column, Comments, includes information about when the API was deprecated and what API to use, if applicable.
     :name: _deprecations_6_4
 
diff --git a/doc/src/conf.py b/doc/src/conf.py
@@ -89,7 +89,7 @@
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-#html_static_path = ['.static']
+html_static_path = ['.static']
 
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
 # using the given strftime format.
@@ -120,6 +120,10 @@
 
 numfig = True
 
+# Display tables with no horizontal scrollbar
+def setup(app):
+    app.add_css_file('custom.css')
+
 # Options for LaTeX output
 # ------------------------
 
diff --git a/doc/src/user_guide/appendix_a.rst b/doc/src/user_guide/appendix_a.rst
@@ -18,6 +18,7 @@ see :ref:`driverdiff` and :ref:`compatibility`.
 
 .. list-table-with-summary::  Features Supported by python-oracledb and cx_Oracle 8.3
     :header-rows: 1
+    :class: wy-table-responsive
     :align: center
     :summary: The first column displays the Oracle feature. The second column indicates whether the feature is supported in the python-oracledb Thin mode. The third column indicates whether the feature is supported in the python-oracledb Thick mode. The fourth column indicates if the feature is supported in cx_Oracle 8.3.
 
@@ -387,6 +388,7 @@ values.
 
 .. list-table-with-summary::  Oracle Database Data Types Supported
     :header-rows: 1
+    :class: wy-table-responsive
     :align: center
     :summary: The first column displays the database data type. The second column displays the python-oracledb constant Name. The third column indicates if the type is supported in python-oracledb.
 
diff --git a/doc/src/user_guide/appendix_b.rst b/doc/src/user_guide/appendix_b.rst
@@ -91,6 +91,7 @@ used in :meth:`oracledb.connect()`, :meth:`oracledb.create_pool()`,
 
 .. list-table-with-summary::  Oracle Net Keywords Supported in the python-oracledb Thin Mode
     :header-rows: 1
+    :class: wy-table-responsive
     :align: center
     :summary: The first column displays the keyword. The second column displays the equivalent oracledb.connect(), oracledb.create_pool(), oracledb.ConnectParams(), or oracledb.PoolParams() parameters. The third column displays the notes.
 
diff --git a/doc/src/user_guide/initialization.rst b/doc/src/user_guide/initialization.rst
@@ -429,6 +429,7 @@ first connection is established.  System environment variables like
 
 .. list-table-with-summary:: Common Oracle environment variables
     :header-rows: 1
+    :class: wy-table-responsive
     :widths: 1 2
     :summary: The first column displays the Oracle Environment Variable. The second column, Purpose, describes what the environment variableis used for.
     :align: left
diff --git a/doc/src/user_guide/json_data_type.rst b/doc/src/user_guide/json_data_type.rst
@@ -173,6 +173,7 @@ needed but there is no direct mapping from Python.
 
 .. list-table-with-summary::
     :header-rows: 1
+    :class: wy-table-responsive
     :widths: 1 1 1
     :summary: The first column is the Python Type or Value. The second column is the equivalent JSON Attribute Type or Value. The third column is the SQL Equivalent syntax.
     :align: left
@@ -263,6 +264,7 @@ attribute mapping occurs:
 
 .. list-table-with-summary::
     :header-rows: 1
+    :class: wy-table-responsive
     :widths: 1 1
     :align: left
     :summary: The first column is the Database JSON Attribute Type or Value. The second column is the corresponding Python Type or Value mapped.
diff --git a/doc/src/user_guide/sql_execution.rst b/doc/src/user_guide/sql_execution.rst
@@ -164,6 +164,7 @@ Python object that is returned by default. Python types can be changed with
 
 .. list-table-with-summary::
     :header-rows: 1
+    :class: wy-table-responsive
     :widths: 1 1 1
     :align: left
     :summary: The first column is the Oracle Database Type. The second column is the oracledb Database Type that is returned in the query metadata. The third column is the type of Python object that is returned by default.
diff --git a/doc/src/user_guide/tracing.rst b/doc/src/user_guide/tracing.rst
@@ -287,6 +287,7 @@ columns:
 
 .. list-table-with-summary:: Sample V$SESSION_CONNECT_INFO column values
     :header-rows: 1
+    :class: wy-table-responsive
     :widths: 15 10 10
     :name: V$SESSION_CONNECT_INFO
     :summary: The first column is the name of V$SESSION_CONNECT_INFO view's column. The second column lists a sample python-oracledb Thick mode value. The third column list a sample python-oracledb Thin mode value.
@@ -314,6 +315,7 @@ The following table list sample values for columns with differences in
 
 .. list-table-with-summary:: Sample V$SESSION column values
     :header-rows: 1
+    :class: wy-table-responsive
     :widths: 15 10 10
     :name: V$SESSION_COLUMN_VALUES
     :summary: The first column is the name of the column. The second column lists a sample python-oracledb Thick mode value. The third column lists a sample python-oracledb Thin mode value.
