]> git.ipfire.org Git - thirdparty/bind9.git/commit
Deduplicate link anchors in the ARM
authorPetr Špaček <pspacek@isc.org>
Fri, 30 Sep 2022 11:57:17 +0000 (13:57 +0200)
committerPetr Špaček <pspacek@isc.org>
Wed, 5 Oct 2022 09:36:19 +0000 (11:36 +0200)
commit9a7c2b370e7df11beefe709a47efb79ce8e11a31
treec7e901881277a10001d9b7fe52fd96eb273dfb8e
parent952e1cb454ab7034a57139130794980ee8297a43
Deduplicate link anchors in the ARM

Some statement names like "allow-query" had manually defined link anchor
_allow-query and also implicit anchor created by
.. namedconf:statement:: syntax. This causes warnings if a ambiguous
reference is made using :any:`allow-query` syntax.

Remove (hopefully all) manually defined anchors which pointed to
identical place as the implicit anchor. This allows :any: to work.

In rare cases where manual anchor points to descriptive text separated
from statement definition the reference was disamguated by replacing
:any:`notify` with :ref:`notify` (for manual anchor)
vs. :namedconf:ref:`notify` (for statement definition).

Please note that `options` statement is a trap: It is ambiguous even
without manual anchor because rndc.conf has its own `options`. Use
:namedconf:ref:`options` vs. :rndcconf:ref:`options` to select
appropriate target.
doc/arm/config-auth.inc.rst
doc/arm/config-intro.inc.rst
doc/arm/config-resolve.inc.rst
doc/arm/dnssec.inc.rst
doc/arm/reference.rst
doc/arm/requirements.inc.rst