Add more doc redirects.

anthony-tuininga · anthony-tuininga · commit a05b9a523384 · 2023-06-03T09:37:29.000-06:00
diff --git a/doc/src/api_manual/aq.rst b/doc/src/api_manual/aq.rst
@@ -4,6 +4,13 @@
 Advanced Queuing (AQ)
 *********************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 See :ref:`aqusermanual` for more information about using AQ in cx_Oracle.
 
 .. note::
diff --git a/doc/src/api_manual/connection.rst b/doc/src/api_manual/connection.rst
@@ -4,6 +4,13 @@
 Connection Object
 *****************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 .. note::
 
     Any outstanding changes will be rolled back when the connection object
diff --git a/doc/src/api_manual/cursor.rst b/doc/src/api_manual/cursor.rst
@@ -5,6 +5,13 @@ Cursor Object
 *************
 
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 .. method:: Cursor.__enter__()
 
     The entry point for the cursor as a context manager. It returns itself.
diff --git a/doc/src/api_manual/deprecations.rst b/doc/src/api_manual/deprecations.rst
@@ -4,6 +4,13 @@
 Deprecations
 ************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 The following tables contains all of the deprecations in the cx_Oracle API,
 when they were first deprecated and a comment on what should be used instead,
 if applicable. The most recent deprecations are listed first.
diff --git a/doc/src/api_manual/lob.rst b/doc/src/api_manual/lob.rst
@@ -4,6 +4,13 @@
 LOB Objects
 ***********
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 See :ref:`lobdata` for more information about using LOBs.
 
 .. note::
diff --git a/doc/src/api_manual/object_type.rst b/doc/src/api_manual/object_type.rst
@@ -4,6 +4,13 @@
 Object Type Objects
 *******************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 .. note::
 
     This object is an extension to the DB API. It is returned by the
diff --git a/doc/src/api_manual/session_pool.rst b/doc/src/api_manual/session_pool.rst
@@ -4,6 +4,13 @@
 SessionPool Object
 ******************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 .. note::
 
     This object is an extension to the DB API.
diff --git a/doc/src/api_manual/soda.rst b/doc/src/api_manual/soda.rst
@@ -4,6 +4,13 @@
 SODA
 ****
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 `Oracle Database Simple Oracle Document Access (SODA)
 <https://docs.oracle.com/en/database/oracle/simple-oracle-document-access>`__
 allows documents to be inserted, queried, and retrieved from Oracle Database
diff --git a/doc/src/api_manual/subscription.rst b/doc/src/api_manual/subscription.rst
@@ -4,6 +4,13 @@
 Subscription Object
 *******************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 .. note::
 
     This object is an extension the DB API.
diff --git a/doc/src/api_manual/variable.rst b/doc/src/api_manual/variable.rst
@@ -4,6 +4,13 @@
 Variable Objects
 ****************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 .. note::
 
     The DB API definition does not define this object.
diff --git a/doc/src/index.rst b/doc/src/index.rst
@@ -1,6 +1,13 @@
 Welcome to cx_Oracle's documentation!
 =====================================
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 **cx_Oracle** is a module that enables access to Oracle Database and conforms
 to the Python database API specification. This module is currently tested
 against Oracle Client 21c, 19c, 18c, 12c, and 11.2, and Python 3.6, 3.7, 3.8,
@@ -11,13 +18,6 @@ releases.
 (the BSD license). A detailed description of cx_Oracle changes can be found in
 the :ref:`release notes <releasenotes>`.
 
-.. note::
-
-    **cx_Oracle has a major new release under a new name and homepage**
-    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
-
-    **New projects should install python-oracledb instead of cx_Oracle.**
-
 Contents:
 
 User Guide
diff --git a/doc/src/release_notes.rst b/doc/src/release_notes.rst
@@ -5,6 +5,13 @@
 cx_Oracle Release Notes
 =======================
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 For any deprecations, see :ref:`Deprecations <deprecations>`.
 
 Version 8.3 (November 2021)
diff --git a/doc/src/user_guide/aq.rst b/doc/src/user_guide/aq.rst
@@ -4,6 +4,13 @@
 Oracle Advanced Queuing (AQ)
 ****************************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 `Oracle Advanced Queuing
 <https://www.oracle.com/pls/topic/lookup?ctx=dblatest&id=ADQUE>`__ is a highly
 configurable and scalable messaging feature of Oracle Database.  It has
diff --git a/doc/src/user_guide/batch_statement.rst b/doc/src/user_guide/batch_statement.rst
@@ -4,6 +4,13 @@
 Batch Statement Execution and Bulk Loading
 ******************************************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 Inserting or updating multiple rows can be performed efficiently with
 :meth:`Cursor.executemany()`, making it easy to work with large data sets with
 cx_Oracle.  This method can significantly outperform repeated calls to
diff --git a/doc/src/user_guide/bind.rst b/doc/src/user_guide/bind.rst
@@ -4,6 +4,13 @@
 Using Bind Variables
 ********************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 SQL and PL/SQL statements that pass data to and from Oracle Database should use
 placeholders in SQL and PL/SQL statements that mark where data is supplied or
 returned.  These placeholders are referred to as bind variables or bind
diff --git a/doc/src/user_guide/connection_handling.rst b/doc/src/user_guide/connection_handling.rst
@@ -4,6 +4,13 @@
 Connecting to Oracle Database
 *****************************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 Connections between cx_Oracle and Oracle Database are used for executing
 :ref:`SQL <sqlexecution>`, :ref:`PL/SQL <plsqlexecution>`, and :ref:`SODA
 <sodausermanual>`.
diff --git a/doc/src/user_guide/cqn.rst b/doc/src/user_guide/cqn.rst
@@ -4,6 +4,13 @@
 Continuous Query Notification (CQN)
 ***********************************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 `Continuous Query Notification (CQN)
 <https://www.oracle.com/pls/topic/lookup?ctx=dblatest&
 id=GUID-373BAF72-3E63-42FE-8BEA-8A2AEFBF1C35>`__ allows applications to receive
diff --git a/doc/src/user_guide/exception_handling.rst b/doc/src/user_guide/exception_handling.rst
@@ -4,6 +4,13 @@
 Exception Handling
 ******************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 All exceptions raised by cx_Oracle are inherited from :attr:`cx_Oracle.Error`.
 See :ref:`Exceptions <exceptions>` for more details on the various exceptions
 defined by cx_Oracle. See the exception handling section in the
diff --git a/doc/src/user_guide/globalization.rst b/doc/src/user_guide/globalization.rst
@@ -4,6 +4,13 @@
 Character Sets and Globalization
 ********************************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 Data fetched from, and sent to, Oracle Database will be mapped between the
 database character set and the "Oracle client" character set of the Oracle
 Client libraries used by cx_Oracle.  If data cannot be correctly mapped between
diff --git a/doc/src/user_guide/ha.rst b/doc/src/user_guide/ha.rst
@@ -4,6 +4,13 @@
 High Availability with cx_Oracle
 ********************************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 Applications can utilize many features for high availability (HA) during planned and
 unplanned outages in order to:
 
diff --git a/doc/src/user_guide/initialization.rst b/doc/src/user_guide/initialization.rst
@@ -4,6 +4,13 @@
 cx_Oracle 8 Initialization
 **************************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 The cx_Oracle module loads Oracle Client libraries which communicate over
 Oracle Net to an existing database.  The Oracle Client libraries need to be
 installed separately.  See :ref:`installation`.  Oracle Net is not a separate
diff --git a/doc/src/user_guide/json_data_type.rst b/doc/src/user_guide/json_data_type.rst
@@ -4,6 +4,13 @@
 Working with the JSON Data Type
 *******************************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 Native support for JSON data was introduced in Oracle Database 12c.  You can
 use JSON with relational database features, including transactions, indexing,
 declarative querying, and views.  You can project JSON data relationally,
diff --git a/doc/src/user_guide/lob_data.rst b/doc/src/user_guide/lob_data.rst
@@ -4,6 +4,13 @@
 Using CLOB and BLOB Data
 ************************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 Oracle Database uses :ref:`lobobj` to store large data such as text, images,
 videos and other multimedia formats.  The maximum size of a LOB is limited to
 the size of the tablespace storing it.
diff --git a/doc/src/user_guide/plsql_execution.rst b/doc/src/user_guide/plsql_execution.rst
@@ -4,6 +4,13 @@
 PL/SQL Execution
 ****************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 PL/SQL stored procedures, functions and anonymous blocks can be called from
 cx_Oracle.
 
diff --git a/doc/src/user_guide/soda.rst b/doc/src/user_guide/soda.rst
@@ -4,6 +4,13 @@
 Simple Oracle Document Access (SODA)
 ************************************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 Overview
 ========
 
diff --git a/doc/src/user_guide/sql_execution.rst b/doc/src/user_guide/sql_execution.rst
@@ -4,6 +4,13 @@
 SQL Execution
 *************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 Executing SQL statements is the primary way in which a Python application
 communicates with Oracle Database.  Statements are executed using the methods
 :meth:`Cursor.execute()` or :meth:`Cursor.executemany()`.  Statements include
diff --git a/doc/src/user_guide/startup.rst b/doc/src/user_guide/startup.rst
@@ -4,6 +4,13 @@
 Starting and Stopping Oracle Database
 *************************************
 
+.. note::
+
+    **cx_Oracle has a major new release under a new name and homepage**
+    `python-oracledb <https://oracle.github.io/python-oracledb/>`__.
+
+    **New projects should install python-oracledb instead of cx_Oracle.**
+
 This chapter covers how to start up and shutdown Oracle Database using
 cx_Oracle.
 
diff --git a/doc/src/user_guide/tracing_sql.rst b/doc/src/user_guide/tracing_sql.rst
diff --git a/doc/src/user_guide/tuning.rst b/doc/src/user_guide/tuning.rst
diff --git a/doc/src/user_guide/txn_management.rst b/doc/src/user_guide/txn_management.rst
diff --git a/doc/src/user_guide/xml_data_type.rst b/doc/src/user_guide/xml_data_type.rst
