Update JDBC support + misc copy editing

Author: mrotteveel

src/docs/asciidoc/release_notes.adoc

@@ -38,13 +38,13 @@ For known issues, consult <<known-issues>>.
 Future maintenance releases of Jaybird 5 may stop expanding Java support to include newly released Java versions.
 If you use Java 17 or higher, we recommend upgrading to Jaybird 6.
 
-The following has been changed or fixed since Jaybird 5.0.10:
+The following has been changed or fixed since Jaybird 5.0.11:
 
 * JDBC 4.5 support: `JaybirdTypeCodes.DECFLOAT` and `JaybirdType.DECFLOAT` now use value `2015` instead of `-6001` (https://github.com/FirebirdSQL/jaybird/issues/917[#917])
 +
 Applications referencing this constant may need to be recompiled to function correctly with Jaybird 5.0.12 and higher.
 If you use Java 26 or higher, we recommend using `java.sql.Type.DECFLOAT` and `java.sql.JDBCType.DECFLOAT` instead.
-* JDBC 4.5 support: implemented methods `enquoteIdentifier`, `enquoteLiteral`, `enquoteNCharLiteral`, and `isSimpleIdentifier` on `FBConnection`, and added them to interface `FirebirdConnection` so for older Java versions (https://github.com/FirebirdSQL/jaybird/issues/918[#918])
+* JDBC 4.5 support: implemented methods `enquoteIdentifier`, `enquoteLiteral`, `enquoteNCharLiteral`, and `isSimpleIdentifier` on `FBConnection`, and added them to interface `FirebirdConnection` for access in older Java versions (https://github.com/FirebirdSQL/jaybird/issues/918[#918])
 +
 The methods of the same name in the `java.sql.Statement` implementations now call the methods on the connection.
 This results in two minor breaking changes:
@@ -58,13 +58,13 @@ See also <<jdbc-escape-disable-proc>>.
 * Fixed: `IndexOutOfBoundsException` in `FBCachedBlob.getBytes(long, int)` for position or length beyond end of data (https://github.com/FirebirdSQL/jaybird/issues/924[#924])
 * Fixed: Using native client, password is limited to 255 bytes (https://github.com/FirebirdSQL/jaybird/issues/926[#926])
 * Fixed: Infinite loop in `FBPooledConnection#fireConnectionError(SQLException)` if the exception has a chained exception and neither is fatal (https://github.com/FirebirdSQL/jaybird/issues/928[#928])
-* JDBC 4.5 support: `FBDatabaseMetaData.getJDBCMinorVersion()` should report 5 (for JDBC 4.5) on Java 25 and higher (https://github.com/FirebirdSQL/jaybird/issues/929[#929])
+* JDBC 4.5 support: `FBDatabaseMetaData.getJDBCMinorVersion()` should report 5 (for JDBC 4.5) on Java 26 and higher (https://github.com/FirebirdSQL/jaybird/issues/929[#929])
 
 [#jaybird-5-0-11-changelog]
 === Jaybird 5.0.11
 
-This release is not fully compatible with the upcoming JDBC 4.5 Specification to be introduced with Java 26.
-See <<jdbc45-compat>> for more information.
+This release is not fully compatible with the JDBC 4.5 Specification.
+For JDBC 4.5 support, upgrade to Jaybird 5.0.12 or higher, or Jaybird 6.0.5 or higher.
 
 The following has been changed or fixed since Jaybird 5.0.10:
 
@@ -421,6 +421,9 @@ Jaybird 5 supports the following specifications:
 |===
 |Specification |Notes
 
+|JDBC 4.5
+|All JDBC 4.5 methods for features supported by Firebird.
+
 |JDBC 4.4
 |If a security manager is available, the driver still performs `SQLPermission` checks.
 
@@ -436,32 +439,10 @@ Java 9 and higher supported using the Java 8 or Java 11 driver.
 |===
 
 [discrete#jdbc45-compat]
-==== Incompatibilities with upcoming JDBC 4.5 Specification
-
-// TODO Revise/rename with state for Jaybird 6.0.5 once https://github.com/FirebirdSQL/jaybird/issues/907 is complete
-
-This section applies to Jaybird 6.0.4 and earlier.
-
-Java 26 (expected in March 2026) will introduce https://jcp.org/aboutJava/communityprocess/maintenance/jsr221/index5.html[JDBC 4.5^] (link to draft).
-Jaybird is not yet compatible with some of the specified changes.
-
-Specifically affected are:
-
-* Introduction of `java.sql.JDBCType.DECFLOAT` and `java.sql.Types.DECFLOAT` (value `2015`).
-+
-At this time, Jaybird still uses its own constants in `JaybirdType.DECFLOAT` and `JaybirdTypeCodes.DECFLOAT` with value `-6001`.
-This value will be changed to match the JDBC specified value, and the constants deprecated, in a future maintenance release of Jaybird.
-+
-Addressed in Jaybird 5.0.12.
-* Introduction of new methods on `java.sql.Connection` -- `enquoteIdentifier`, `enquoteLiteral`, `enquoteNCharLiteral`, and `isSimpleIdentifier`
-+
-The default implementation provided is not sufficient for Firebird, especially not when connecting to a dialect 1 database.
-For the time being, we recommend using the equivalent JDBC 4.3 methods (with the same name) on a `java.sql.Statement` instance of the connection.
-+
-Addressed in Jaybird 5.0.12
-* The JDBC escape to selectively disable escape processing ([.nowrap]`++{\ ... \}++`) is not yet implemented.
+==== Compatibility with the JDBC 4.5 Specification
 
-We plan to address these issues in Jaybird 5 and Jaybird 6 maintenance releases _after_ the release of Java 26 (tracked by https://github.com/FirebirdSQL/jaybird/issues/907[#907]).
+Java 26 (March 2026) introduced https://jcp.org/aboutJava/communityprocess/maintenance/jsr221/index5.html[JDBC 4.5^] (link to draft).
+Since Jaybird 6.0.5 (and Jaybird 5.0.12), Jaybird is compatible with the specified changes.
 
 [#support]
 == Support
@@ -1171,7 +1152,7 @@ This contradiction has been removed, and the implementations will now send array
 
 JDBC 4.5 (Java 26) introduces a new JDBC escape to disable escape processing and parameter parsing within part of a statement text.
 This JDBC escape has been implemented in Jaybird 5.0.12 (backported from Jaybird 6.0.5).
-The escape is always parsed if escape processing is enabled (the default), no matter the Java version and the JDBC minor version reported by `DatabaseMetaData#getJDBCMinorVersion()`.
+This escape is always parsed if escape processing is enabled (the default), no matter the Java version and the JDBC minor version reported by `DatabaseMetaData#getJDBCMinorVersion()`.
 
 The "`disable escape processing`" escape starts with `++{\++` and ends with `++\}++`.
 Within the escape, *all* occurrences of a backslash (`\`) *must* be escaped by doubling.