Documentation improvements.

Author: anthony-tuininga

doc/src/api_manual/async_connection.rst

@@ -556,12 +556,50 @@ AsyncConnection Attributes
     requested python-oracledb size and the maximum size allowed by the database
     network configuration.
 
+.. attribute:: AsyncConnection.serial_num
+
+    This read-only attribute specifies the session serial number associated with
+    the connection. It is the same value returned by the SQL
+    ``SELECT SERIAL# FROM V$SESSION``. It is available only in python-oracledb
+    Thin mode.
+
+    .. versionadded:: 2.5.0
+
+    .. note::
+
+        This attribute is an extension to the DB API definition.
+
+        For applications using :ref:`drcp`, the ``serial_num`` attribute may
+        not contain the current session state until a round-trip is made to the
+        database after acquiring a session.  It is recommended to not use this
+        attribute if your application uses DRCP but may not perform a
+        round-trip.
+
 .. attribute:: AsyncConnection.service_name
 
     This read-only attribute specifies the Oracle Database service name
     associated with the connection.  This is the same value returned by the SQL
     ``SELECT SYS_CONTEXT('USERENV', 'SERVICE_NAME') FROM DUAL``.
 
+.. attribute:: AsyncConnection.session_id
+
+    This read-only attribute specifies the session identifier associated with
+    the connection. It is the same value returned by the SQL
+    ``SELECT SID FROM V$SESSION``. It is available only in python-oracledb
+    Thin mode.
+
+    .. versionadded:: 2.5.0
+
+    .. note::
+
+        This attribute is an extension to the DB API definition.
+
+        For applications using :ref:`drcp`, the ``session_id`` attribute may
+        not contain the current session state until a round-trip is made to the
+        database after acquiring a session.  It is recommended to not use this
+        attribute if your application uses DRCP but may not perform a
+        round-trip.
+
 .. attribute:: AsyncConnection.stmtcachesize
 
     This read-write attribute specifies the size of the statement cache. This

doc/src/api_manual/async_connection_pool.rst

@@ -32,7 +32,7 @@ AsyncConnectionPool Methods
     be raised.
 
     The ``cclass`` parameter, if specified, should be a string corresponding to
-    the connection class for Database Resident Connection Pooling (DRCP).
+    the connection class for :ref:`drcp`.
 
     The ``purity`` parameter is expected to be one of
     :data:`~oracledb.PURITY_NEW`, :data:`~oracledb.PURITY_SELF`, or

doc/src/api_manual/connect_params.rst

@@ -105,7 +105,7 @@ ConnectParams Attributes
 .. attribute:: ConnectParams.cclass
 
     This read-only attribute is a string that specifies the connection class
-    to use for Database Resident Connection Pooling (DRCP).
+    to use for :ref:`drcp`.
 
     This attribute is supported in both python-oracledb Thin and Thick modes.
 
@@ -270,14 +270,14 @@ ConnectParams Attributes
 
 .. attribute:: ConnectParams.pool_boundary
 
-    This read-only attribute is one of the strings "statement" or
-    "transaction" which indicates when pooled DRCP or PRCP connections can be
-    returned to the pool. If the value is "statement", then pooled DRCP or
-    PRCP connections are implicitly released back to the DRCP or PRCP pool
-    when the connection is stateless (that is, there are no active cursors,
-    active transactions, temporary tables, or temporary LOBs). If the value is
-    "transaction", then pooled DRCP or PRCP connections are implicitly
-    released back to the DRCP or PRCP pool when either one of the methods
+    This read-only attribute is one of the strings "statement" or "transaction"
+    which indicates when pooled :ref:`DRCP <drcp>` or PRCP connections can be
+    returned to the pool. If the value is "statement", then pooled DRCP or PRCP
+    connections are implicitly released back to the DRCP or PRCP pool when the
+    connection is stateless (that is, there are no active cursors, active
+    transactions, temporary tables, or temporary LOBs). If the value is
+    "transaction", then pooled DRCP or PRCP connections are implicitly released
+    back to the DRCP or PRCP pool when either one of the methods
     :meth:`Connection.commit()` or :meth:`Connection.rollback()` are called.
     This attribute requires the use of DRCP or PRCP with Oracle Database 23ai
     (or later). See :ref:`implicitconnpool` for more information.
@@ -325,10 +325,11 @@ ConnectParams Attributes
 .. attribute:: ConnectParams.purity
 
     This read-only attribute is an integer that returns the purity used for
-    DRCP.  When the value of this attribute is :attr:`oracledb.PURITY_DEFAULT`,
-    then any standalone connection will use :attr:`oracledb.PURITY_NEW` and any
-    pooled connection will use :attr:`oracledb.PURITY_SELF`. The default value
-    is :data:`~oracledb.PURITY_DEFAULT`.
+    :ref:`drcp`.  When the value of this attribute is
+    :attr:`oracledb.PURITY_DEFAULT`, then any standalone connection will use
+    :attr:`oracledb.PURITY_NEW` and any pooled connection will use
+    :attr:`oracledb.PURITY_SELF`. The default value is
+    :data:`~oracledb.PURITY_DEFAULT`.
 
     This attribute is supported in both python-oracledb Thin and Thick modes.
 

doc/src/api_manual/connection.rst

@@ -838,11 +838,11 @@ Connection Attributes
 
         This attribute is an extension to the DB API definition.
 
-        For applications using Database Resident Connection Pooling (DRCP),
-        the ``serial_num`` attribute may not contain the current session state
-        until a round-trip is made to the database after acquiring a session.
-        It is recommended to not use this attribute if your application uses
-        DRCP but may not perform a round-trip.
+        For applications using :ref:`drcp`, the ``serial_num`` attribute may
+        not contain the current session state until a round-trip is made to the
+        database after acquiring a session.  It is recommended to not use this
+        attribute if your application uses DRCP but may not perform a
+        round-trip.
 
 .. attribute:: Connection.service_name
 
@@ -869,11 +869,11 @@ Connection Attributes
 
         This attribute is an extension to the DB API definition.
 
-        For applications using Database Resident Connection Pooling (DRCP),
-        the ``session_id`` attribute may not contain the current session state
-        until a round-trip is made to the database after acquiring a session.
-        It is recommended to not use this attribute if your application uses
-        DRCP but may not perform a round-trip.
+        For applications using :ref:`drcp`, the ``session_id`` attribute may
+        not contain the current session state until a round-trip is made to the
+        database after acquiring a session.  It is recommended to not use this
+        attribute if your application uses DRCP but may not perform a
+        round-trip.
 
 .. attribute:: Connection.stmtcachesize
 

doc/src/api_manual/connection_pool.rst

@@ -56,7 +56,7 @@ ConnectionPool Methods
     be raised.
 
     The ``cclass`` parameter, if specified, should be a string corresponding to
-    the connection class for Database Resident Connection Pooling (DRCP).
+    the connection class for :ref:`drcp`.
 
     The ``purity`` parameter is expected to be one of
     :data:`~oracledb.PURITY_NEW`, :data:`~oracledb.PURITY_SELF`, or