bind9/doc
Petr Špaček a23fa7edc9 Add Sphinx extension to help with ARM maintenance and cross-linking
The extension provides a "Sphinx domain factory". Each new Sphinx domain
defines a namespace for configuration statements so named.conf and
rndc.conf do not clash. Currently the Sphinx domains are instantiated
twice and resuling domains are named "namedconf" and "rndcconf".

This commit adds a single new directive:

.. statement:: max-cache-size

It is namespaced like this:

.. namedconf:statement:: max-cache-size

This directive generates a new anchor for configuration statement and it
can be referenced like :any:`max-cache-size` (if the identifier is
unique), or more specific :namedconf:ref:`max-cache-size`.

It is based on Sphinx "tutorial" extension "recipe".
Beware, some details in Sphinx docs are not up-to-date, it's better
to read Sphinx and docutil sources.
2022-06-09 14:44:29 +02:00
..
arm Add Sphinx extension to help with ARM maintenance and cross-linking 2022-06-09 14:44:29 +02:00
design Remove obsolete notes on name compression 2022-06-01 13:00:40 +01:00
dev Enforce Python codestyle with black 2022-06-08 10:27:46 +02:00
dnssec-guide Minor DNSSEC guide tweaks 2022-05-11 10:51:26 +02:00
doxygen Update the copyright information in all files in the repository 2022-01-11 09:05:02 +01:00
man Auto-format Python files with black 2022-06-08 10:28:08 +02:00
misc Rename "hostname" to "remote-hostname" within "tls" 2022-05-03 17:15:43 +03:00
notes Add CHANGES and release note for [GL #2506] 2022-06-09 10:46:35 +00:00
Makefile.am Install man pages when sphinx-build tool is missing 2021-05-25 11:21:32 +02:00