Documentation improvements.

Author: anthony-tuininga

doc/Makefile

@@ -1,4 +1,4 @@
-# Makefile to generate cx_Oracle documentation using Sphinx
+# Makefile to generate python-oracledb documentation using Sphinx
 
 SPHINXOPTS    =
 SPHINXBUILD   = sphinx-build
@@ -20,4 +20,3 @@ pdf:
 .PHONY: clean
 clean:
 	rm -rf $(BUILDDIR)/*
-

doc/src/api_manual/connection.rst

@@ -55,7 +55,7 @@ Connection Methods
 
 .. method:: Connection.cancel()
 
-    Breaks a long-running transaction.
+    Breaks a long-running statement.
 
     .. note::
 

doc/src/user_guide/appendix_a.rst

@@ -198,8 +198,8 @@ see :ref:`driverdiff` and :ref:`compatibility`.
       - Yes
       - Yes
       - Yes
-    * - Client character set support
-      - UTF-8 - see :ref:`globalization`
+    * - Client character set support (see :ref:`globalization`)
+      - UTF-8
       - UTF-8
       - Yes - can use Python encodings. Default in 8.0 is UTF-8
     * - Oracle Globalization support

doc/src/user_guide/connection_handling.rst

@@ -2518,6 +2518,13 @@ files:
        connection = oracledb.connect(user="admin", password=pw, dsn="mydb_low")
 
 
+In python-oracle Thick mode, to create mTLS connections in one Python process
+to two or more Oracle Autonomous Databases, move each ``cwallet.sso`` file to
+its own directory.  For each connection use different connection string
+``WALLET_LOCATION`` parameters to specify the directory of each ``cwallet.sso``
+file.  It is recommended to use Oracle Client libraries 19.17 (or later) when
+using multiple wallets.
+
 Access Through a Proxy
 +++++++++++++++++++++++