<appendix id="release">
 <title>Release Notes</title>

  <sect1 id="release-26-1-1">
  <title>ora2pgpro 26.1.1</title>
  <formalpara>
    <title>Release date:</title>
    <para>2026-05-29</para>
  </formalpara>

    <para>
      This release provides optimizations and bug fixes. Major changes are
      as follows.
    </para>

  <itemizedlist>
    <listitem>
    <!-- ORA-38 -->
    <para>
     Fixed parsing of associative array method chains to handle calls correctly.
     Previously, failures could occur when processing stopped on unknown node
     types.
    </para>
    </listitem>
    <listitem>
    <!-- ORA-49 -->
    <para>
     Fixed an issue with package export when no default output directory was
     specified, which occurred due to the <option>-b</option> command-line
     option being effectively required even though it is optional.
    </para>
    </listitem>
    <listitem>
    <!-- ORA-55 -->
    <para>
      Fixed an issue with conversion of date or time literal input
      to preserve correct date semantics during migration.
    </para>
    </listitem>
    <listitem>
    <!-- ORA-54 -->
    <para>
      Fixed various issues with package migration for previously unsupported
      <application>PL/SQL</application> constructs. Now these constructs are
      parsed and either converted where supported or ignored with a warning
      in the output instead of failing the package export.
    </para>
    </listitem>
    <listitem>
    <para>
      Added support for ALT 11, Debian 13, Ubuntu 26.04, RHEL 10,
      SLES 16, and MosOS 15.
    </para>
    </listitem>
    <listitem>
    <para>
      Ended support for ALT 9, Debian 10, and Ubuntu 20.04.
    </para>
    </listitem>
  </itemizedlist>
 </sect1>

 <sect1 id="release-24-2-1">
  <title>ora2pgpro 24.2.1</title>
  <formalpara>
    <title>Release date:</title>
    <para>2024-06-20</para>
  </formalpara>

    <para>
      This release provides optimizations and bug fixes. Major changes are
      as follows.
    </para>

  <itemizedlist>
    <listitem>
    <!-- ORA-32 -->
    <para>
      Implemented a mechanism that converts package procedure calls into
      function calls and vice versa. It is necessary for the
      <application>orafce</application> package support, namely
      the <literal>dbms_output</literal> package.
    </para>
    </listitem>
    <listitem>
    <!-- ORA-5 -->
    <para>
      Implemented conversion of private variables, procedures,
      and functions using the <literal>#export</literal>,
      <literal>#private</literal>, and <literal>#export off</literal>
      modifiers when
      <link linkend="ora2pgpro-exporting-packages">exporting or importing packages</link>.
    </para>
    </listitem>
    <listitem>
    <!-- ORA-37 -->
    <para>
      Fixed an issue that resulted in errors like
      <quote>FATAL: Can't open XXX: No such file or directory</quote>
      when using the <literal>SHOW_REPORT</literal> type
      without <option>--basedir</option>.
    </para>
    </listitem>
    <listitem>
    <!-- ORA-36 -->
    <para>
      Fixed an issue with searching for
      the <filename>ora2pgpro.conf</filename> file.
      Now the path to this file is generated correctly.
    </para>
    </listitem>
    <listitem>
    <!-- ORA-27 -->
    <para>
      Added support for Ubuntu 24/04, Astra Linux 1.8
      and ended support for Astra Linux Orel 2.12 and Astra Linux 1.6.
    </para>
    </listitem>
 </itemizedlist>
 </sect1>

 <sect1 id="release-24-1-1">
  <title>ora2pgpro 24.1.1</title>
  <formalpara>
    <title>Release date:</title>
    <para>2024-03-25</para>
  </formalpara>

 <para>
  This release provides optimizations and bug fixes. Major changes are
  as follows.
 </para>

 <itemizedlist>
  <listitem>
  <!-- ORA-7 -->
    <para>
      Fully redesigned implementation of
      <link linkend="ora2pgpro-exporting-packages">package export and
      import</link>. Now Oracle packages are converted to Postgres Pro
      packages automatically as correctly as possible, with messages in
      code parts that require programmer's attention.
    </para>
  </listitem>
  <listitem>
  <!-- ORA-7 -->
    <para>
      Implemented the ability to export <type>VARRAY</type> as Postgres Pro
      arrays.
    </para>
  </listitem>
  <listitem>
  <!-- ORA-1 -->
    <para>
      Implemented the ability to export Oracle collections of
      <link linkend="ora2pgpro-exporting-associative-arrays">associative arrays</link>
      as collections from
      <ulink url="https://postgrespro.com/docs/enterprise/16/pg-variables"><application>pg_variables</application></ulink>.
    </para>
  </listitem>
  <listitem>
  <!-- ORA-1 -->
    <para>
      Added the <option>--offline</option> option that allows converting
      exported data without the connection to the Oracle database.
    </para>
  </listitem>
 </itemizedlist>

 <note>
  <para>
   <application>ora2pgpro</application> processes functions and procedures
   not defined in a package in the same way as previous versions. No support
   for <type>VARRAY</type> or Oracle collections of associative arrays was
   added. The new functionality is available in package conversion only.
  </para>
 </note>
 </sect1>

 <sect1 id="release-23-2">
  <title>ora2pgpro 23.2.1</title>
  <formalpara>
    <title>Release date:</title>
    <para>2023-09-22</para>
  </formalpara>

 <para>
  This is the first public release of <productname>ora2pgpro</productname>.
  It is shipped as a package compatible with
  <productname>Postgres Pro Enterprise</productname>.
 </para>

 <para>
  Major features are as follows:
  <itemizedlist spacing="compact">
      <listitem><simpara>
        Export full database schema (tables, views, sequences, indexes), with
        unique, primary, foreign key, and check constraints.
      </simpara></listitem>
      <listitem><simpara>
        Export grants/privileges for users and groups.
      </simpara></listitem>
      <listitem><simpara>
        Export range/list partitions and subpartitions.
      </simpara></listitem>
      <listitem><simpara>
        Export a table selection (by specifying the table names).
      </simpara></listitem>
      <listitem><simpara>
        Export Oracle schema to
        a Postgres Pro schema.
      </simpara></listitem>
      <listitem><simpara>
        Export predefined functions, triggers, procedures, packages, and
        package bodies.
      </simpara></listitem>
      <listitem><simpara>
        Export full data or following a <literal>WHERE</literal> clause.
      </simpara></listitem>
      <listitem><simpara>
        Full support of Oracle BLOB objects as
        Postgres Pro <type>bytea</type>.
      </simpara></listitem>
      <listitem><simpara>
        Export Oracle views as Postgres Pro tables.
      </simpara></listitem>
      <listitem><simpara>
        Export Oracle user-defined types.
      </simpara></listitem>
      <listitem><simpara>
        Provide some basic automatic conversion of
        <application>PL/SQL</application> code to <application>PL/pgSQL</application>.
      </simpara></listitem>
      <listitem><simpara>
        Works on any platform.
      </simpara></listitem>
      <listitem><simpara>
        Export Oracle tables as foreign data wrapper tables.
      </simpara></listitem>
      <listitem><simpara>
        Export materialized views.
      </simpara></listitem>
      <listitem><simpara>
        Show a report of an Oracle database content.
      </simpara></listitem>
      <listitem><simpara>
        Assistance in migration cost assessment of an Oracle database.
      </simpara></listitem>
      <listitem><simpara>
        Assistance in migration difficulty level assessment of an Oracle database.
      </simpara></listitem>
      <listitem><simpara>
        Assistance in migration cost assessment of <application>PL/SQL</application> code from a file.
      </simpara></listitem>
      <listitem><simpara>
        Assistance in migration cost assessment of Oracle
        SQL queries stored in a file.
      </simpara></listitem>
      <listitem><simpara>
        Export Oracle locator and spatial
        geometries into <application>PostGIS</application>.
      </simpara></listitem>
      <listitem><simpara>
        Export <literal>DBLINK</literal> as Oracle FDW.
      </simpara></listitem>
      <listitem><simpara>
        Export <literal>SYNONYM</literal>s as views.
      </simpara></listitem>
      <listitem><simpara>
        Export <literal>DIRECTORY</literal> as external table or directory
        for <literal>external_file</literal> extension.
      </simpara></listitem>
      <listitem><simpara>
        Dispatch a list of SQL orders over multiple
        Postgres Pro connections.
      </simpara></listitem>
      <listitem><simpara>
        Perform a diff between Oracle
        and Postgres Pro database for test purposes.
      </simpara></listitem>
    </itemizedlist>
 </para>
 </sect1>
</appendix>
