bind9/bin/plugins
Petr Špaček d13066ca5b
Introduce new Sphinx role iscman for ISC manual pages
The new directive and role "iscman" allow to tag & reference man pages in
our source tree. Essentially it is just namespacing for ISC man pages,
but it comes with couple benefits.

Differences from .. _man_program label we formerly used:
- Does not expand :ref:`man_program` into full text of the page header.
- Generates index entry with category "manual page".
- Rendering style is closer to ubiquitous to the one produced
  by ``named`` syntax.

Differences from Sphinx built-in :manpage: role:
- Supports all builders with support for cross-references.
- Generates internal links (unlike :manpage: which generates external
  URLs).
- Checks that target exists withing our source tree.

(cherry picked from commit 7e7a946d44)
2022-03-14 10:57:29 +01:00
..
filter-a.c Make isc_ht_init() and isc_ht_iter_create() return void 2022-03-08 20:47:06 +01:00
filter-a.rst Introduce new Sphinx role iscman for ISC manual pages 2022-03-14 10:57:29 +01:00
filter-aaaa.c Make isc_ht_init() and isc_ht_iter_create() return void 2022-03-08 20:47:06 +01:00
filter-aaaa.rst Introduce new Sphinx role iscman for ISC manual pages 2022-03-14 10:57:29 +01:00
Makefile.am Add filter-a plugin for IPv6-dominant environments 2021-03-19 08:06:55 +01:00