From: Michał Kępień <michal@isc.org>
Date: Wed, 16 Jul 2025 05:06:09 +0000 (+0200)
Subject: Fix broken markup in doc/arm/dlz.inc.rst
X-Git-Tag: v9.21.11~42^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=7f8a88043f12e7e15b471282ee683f6518fbcf78;p=thirdparty%2Fbind9.git

Fix broken markup in doc/arm/dlz.inc.rst

Commit a6cce753e2b1096c4db64555d2aee096ba8236ae erroneously used
Markdown syntax in doc/arm/dlz.inc.rst.  Replace it with proper
reStructuredText so that the relevant section of the ARM is rendered
correctly.
---

diff --git a/doc/arm/dlz.inc.rst b/doc/arm/dlz.inc.rst
index 53756fa35d0..4365831cd88 100644
--- a/doc/arm/dlz.inc.rst
+++ b/doc/arm/dlz.inc.rst
@@ -87,8 +87,7 @@ backend storage of redirection rules:
 Sample DLZ Module
 ~~~~~~~~~~~~~~~~~
 
-For guidance in the implementation of DLZ modules, the ``example``
-directory in the [gitlab.isc.org/isc-projects/dlz-modules](https://gitlab.isc.org/isc-projects/dlz-modules/-/tree/main/example?ref_type=heads)
+For guidance in the implementation of DLZ modules, the |example directory|_
 contains a basic dynamically linkable DLZ module - i.e., one which can be loaded
 at runtime by the "dlopen" DLZ driver. The example sets up a single zone, whose
 name is passed to the module as an argument in the :any:`dlz` statement:
@@ -124,9 +123,16 @@ responses in some other fashion, e.g., by providing different address
 records for a particular name depending on the network from which the
 query arrived.
 
-Documentation of the DLZ module API can be found in
-[README](https://gitlab.isc.org/isc-projects/dlz-modules/-/raw/main/example/README). This
-repository also contains the header file
-[dlz_minimal.h](https://gitlab.isc.org/isc-projects/dlz-modules/-/raw/main/modules/include/dlz_minimal.h),
+Documentation of the DLZ module API can be found in |README|_. This
+repository also contains |dlz_minimal.h|_,
 which defines the API and should be included by any dynamically linkable DLZ
 module.
+
+.. |example directory| replace:: ``example`` directory in the DLZ repository
+.. _example directory: https://gitlab.isc.org/isc-projects/dlz-modules/-/tree/main/example
+
+.. |README| replace:: the ``README`` file
+.. _README: https://gitlab.isc.org/isc-projects/dlz-modules/-/raw/main/example/README
+
+.. |dlz_minimal.h| replace:: the header file ``dlz_minimal.h``
+.. _dlz_minimal.h: https://gitlab.isc.org/isc-projects/dlz-modules/-/raw/main/modules/include/dlz_minimal.h