Remove use of encoding and nencoding in the documentation.

Author: anthony-tuininga

doc/src/user_guide/appendix_c.rst

@@ -524,12 +524,13 @@ following steps:
 4. Review obsolete encoding parameters in calls to :func:`oracledb.connect()`,
    ``oracledb.Connection()``, and ``oracledb.SessionPool()``:
 
-   - ``encoding`` and ``nencoding`` are ignored by python-oracledb. The
-     python-oracledb driver uses UTF-8 exclusively.
+   - ``encoding`` and ``nencoding`` are desupported in python-oracledb and must
+     be removed. The python-oracledb driver uses UTF-8 exclusively.
 
-   - ``threaded`` is ignored in :func:`oracledb.connect()` and
-     ``oracledb.Connection()`` by python-oracledb. This parameter was already
-     ignored in ``oracledb.SessionPool()`` from cx_Oracle 8.2.
+   - ``threaded`` is desupported in :func:`oracledb.connect()` and
+     ``oracledb.Connection()`` by python-oracledb and must be removed. This
+     parameter was already ignored in ``oracledb.SessionPool()`` from cx_Oracle
+     8.2.
 
 5. Remove all references to :meth:`Cursor.fetchraw()` as this method was
    deprecated in cx_Oracle 8.2 and has been removed in python-oracledb.

doc/src/user_guide/globalization.rst

@@ -51,9 +51,10 @@ To find the database's national character set, execute the query:
 Setting the Client Character Set
 --------------------------------
 
-In python-oracledb, the encoding used for all character data is "UTF-8".  The
-``encoding`` and ``nencoding`` parameters of the :meth:`oracledb.connect`
-and :meth:`oracledb.create_pool` methods are deprecated and ignored.
+In python-oracledb, the encoding used for all character data is "UTF-8".  Older
+versions of the driver allowed ``encoding`` and ``nencoding`` parameters to be
+passed to the :meth:`oracledb.connect` and :meth:`oracledb.create_pool` methods
+but these parameters are now desupported.
 
 .. _timezonefiles:
 

doc/src/user_guide/startup.rst

@@ -29,7 +29,7 @@ of the database that should be started:
     connection.startup()
 
     # the following statements must be issued in normal SYSDBA mode
-    connection = oracledb.connect(mode=oracledb.SYSDBA, encoding="UTF-8")
+    connection = oracledb.connect(mode=oracledb.SYSDBA)
     cursor = connection.cursor()
     cursor.execute("alter database mount")
     cursor.execute("alter database open")