Use issue-macro to create issue links

Author: mrotteveel

build.gradle

@@ -100,7 +100,8 @@ dependencies {
         testRuntimeOnly project('chacha64-plugin')
     }
 
-    asciidoctorExt 'org.firebirdsql.asciidoctor:canonical-link:1.0'
+    asciidoctorExt libs.canonical.link
+    asciidoctorExt libs.issue.macro
 }
 
 sourceSets {

gradle/libs.versions.toml

@@ -7,12 +7,15 @@ bouncy-castle = "1.84"
 jspecify = "1.0.0"
 asciidoctor-jvm = "4.0.5"
 javaagent-gradle-plugin = "0.12.2"
+fb-asciidoc-ext = "1.1"
 
 [libraries]
 jna = { module = "net.java.dev.jna:jna-jpms", version.ref = "jna" }
 jakarta-servlet-api  = { module = "jakarta.servlet:jakarta.servlet-api", version.ref = "jakarta-servlet" }
 bcprov-jdk18on = { module = "org.bouncycastle:bcprov-jdk18on", version.ref = "bouncy-castle" }
 jspecify = { module = "org.jspecify:jspecify", version.ref = "jspecify" }
+canonical-link = { module = "org.firebirdsql.asciidoctor:canonical-link", version.ref = "fb-asciidoc-ext" }
+issue-macro = { module = "org.firebirdsql.asciidoctor:issue-macro", version.ref = "fb-asciidoc-ext" }
 
 [plugins]
 asciidoctor-jvm-convert = { id = "org.asciidoctor.jvm.convert", version.ref = "asciidoctor-jvm" }

src/docs/asciidoc/release_notes.adoc

@@ -15,6 +15,7 @@
 :issues: https://github.com/FirebirdSQL/jaybird/issues
 :jaybird-repo: https://github.com/FirebirdSQL/jaybird
 :fb-canonical-html: https://firebirdsql.org/docs/drivers/java/7.0.x/release_notes.html
+:fb-issue-repo: FirebirdSQL/jaybird
 
 ////
 SPDX-FileCopyrightText: Copyright 2021-2026 Firebird development team and individual contributors
@@ -675,22 +676,22 @@ For more information, refer to https://firebirdsql.org/file/documentation/html/e
 
 * Changed the documentation of `FirebirdDatabaseMetaData` methods `getProcedureSourceCode`, `getTriggerSourceCode` and `getViewSourceCode` that the object not being found is reported by a `null` value, not a `SQLException`.
 With this change, the documentation reflects the actual behaviour.
-* Fixed: race condition during cancellation (https://github.com/FirebirdSQL/jaybird/issues/903[#903])
+* Fixed: race condition during cancellation (issue:[903])
 +
 This change introduce an additional lock during transmit (sending to the server).
 Maintainers of Jaybird forks, or implementers of custom wire protocol implementations subclassing classes in `org.firebirdsql.gds.ng.wire` and related packages will need to take out this transmit lock when sending to the server.
 The change also lead to incompatible changes to protected methods in the various protocol implementation classes, like adding an `XdrOutputStream` parameter to various methods, and methods renamed for consistency.
 +
 See also https://github.com/FirebirdSQL/jaybird/blob/master/devdoc/jdp/jdp-2026-01-additional-locking-for-sending-in-wire-protocol.adoc[jdp-2026-01: Additional locking for sending in wire protocol].
 * Upgraded `org.firebirdsql.extern.decimal` to https://github.com/FirebirdSQL/decimal-java[decimal-java 2.0.1^]
-* Support `USING` clause in generated keys detection (https://github.com/FirebirdSQL/jaybird/issues/932[#932])
-* Add support for parenthesized queries to `StatementDetector` (https://github.com/FirebirdSQL/jaybird/issues/933[#933])
+* Support `USING` clause in generated keys detection (issue:[932])
+* Add support for parenthesized queries to `StatementDetector` (issue:[933])
 * Improvement: Clear warnings on connection close (https://github.com/FirebirdSQL/jaybird/pull/943[#943])
 +
 This change was contributed by https://github.com/FuriousFourier[FuriousFourier^]
-* Improvement: Add getters to `BackupManager` and allow "`use default`" to be set (https://github.com/FirebirdSQL/jaybird/issues/948[#948])
-* Improvement: Allow "`use default`" (`-1`) on `FBManager#setPageSize` (https://github.com/FirebirdSQL/jaybird/issues/949[#949])
-* Improvement: Add getters to `NBackupManager` (https://github.com/FirebirdSQL/jaybird/issues/950[#950])
+* Improvement: Add getters to `BackupManager` and allow "`use default`" to be set (issue:[948])
+* Improvement: Allow "`use default`" (`-1`) on `FBManager#setPageSize` (issue:[949])
+* Improvement: Add getters to `NBackupManager` (issue:[950])
 * ...
 
 [#compatibility-changes]