GitLab

Render grammar snippets in the ARM [v9_18]

See merge request !6507

We cannot simply do URL because it would make our lives more complicated
with -S edition.

(cherry picked from commit 908acd5d)

Technically this is fixup for
33931c97
but that commit is already merged.

(cherry picked from commit f5faddd0)

This is super confusing because statement "keys" exists in context
controls and server blocks where it refers to symmetric TSIG key, and it
_also_ exists in dnssec-policy block where it specifies public-private
key pair parameters.

In an (unsuccessful) attempt to disambiguate these two I added bunch of
hyperlinks and a warning.

(cherry picked from commit d88fefbb)

We need to split the description to silence warnings about undescribed
statements.

(cherry picked from commit 82e2f0b3)

(cherry picked from commit 10f88bff)

Statements ipv4only-contact, ipv4only-enable, ipv4only-server did not
have their own section in the ARM. Now they have.

(cherry picked from commit 1687b408)

(cherry picked from commit 40b3ce72)

It is not really a zone type, so let's not generate "type in-view"
anchor for it.

(cherry picked from commit 261bdc73)

(cherry picked from commit 1af157eb)

A new syntax
.. namedconf:statementlist::
   :filter_blocks: type secondary
allows to generate tables with statements allowed within specified
blocks.

(cherry picked from commit 08a8acff)

It would be too easy if we could just call sorted(). Thanks to zone
grammar the most important key "type" gets sorted near end, so we pull
it up to the top using a hack.

(cherry picked from commit 5c04e3c5)

It turns out the tree of dictionaries is not the best structure to
represent our grammar, unfortunatelly. The problem is that "zone" has
several context-dependent variants which change meaning of "zone" based
on inner field "type".

Redesigning the whole structure does not seem to be worth, so I settled
on this terrible hack.

(cherry picked from commit 0392144e)

I cannot see a reasonable way to achieve this without the hack in this
commit.

(cherry picked from commit 435cbb61)

A new flag
.. namedconf:statement::
   :suppress_grammar:
suppresses pretty-printing grammar.

It is useful mostly for zones because each zone has it's own grammar, so
printing all of them at once usually does not make sense.

(cherry picked from commit 1f5bc4fe)

(cherry picked from commit 0bbbdc62)

(cherry picked from commit 7b4ad8a3)

This is replacement for auto-generated *.rst files stored in the repo.

(cherry picked from commit c6fe8970)

(cherry picked from commit eba3b1ad)

(cherry picked from commit d61d998e)

(cherry picked from commit ebe6ede2)

Skip over obsolete options.

(cherry picked from commit cbad1803)

(cherry picked from commit 1c6f2c5a)

A helper is needed to combine cfg_test output for generic options and
all the type-dependent zone block variants.

(cherry picked from commit a691ebd0)

It produces the same format as cfg_test --grammar. The advantage is that
it allows to print any node in configuration the tree, not just whole
blocks.

(cherry picked from commit 190004e4)

The utility detects statements which use the same name (e.g.
max-zone-ttl) but use different grammar in different contexts. These
typically need special case in docs.

(cherry picked from commit 8960d51a)

It transforms named.conf/rndc.conf grammar from text format into Python
dictionary. This allows granular access to grammar elements.

Beware: It heavity depens on cfg_test output format!
(cherry picked from commit df089829)

It uses the same mechanism as all other grammars, but the file is named
differently to distinguish it from named.conf grammars.

(cherry picked from commit fb474de3)

The next commit is going to add parser for ISC configuration format.
To simplify the parser the grammar files in doc/misc are no longer
line-wrapped as handling it would make the grammar parser unnecessairly
complicated.

This affects visible output in the ARM, but in the end we are going to
replace the auto-generated .rst files with grammar pretty printed, so
formatting of these files does not matter in practical terms.

(cherry picked from commit 699570cd)

These files can be consumed by scripts, so obviously missing comment
markers wreak havoc.

(cherry picked from commit af3683f4)

Add tags and short descriptions for query and transfer statements [v9_18]

See merge request !6504

Nested rst syntax is now parsed and rendered. E.g.:

.. namedconf:statement:: example
   :short: Use ``this`` **cool** syntax!

(cherry picked from commit 563eb8e1)

Let's keep just the :term: produced by grammar glossary.

(cherry picked from commit 0e7ca5b5)

Suzanne Goldlust authored Jun 24, 2022 and Petr Špaček committed Jun 30, 2022

(cherry picked from commit 3cf976bd)

Suzanne Goldlust authored Jun 24, 2022 and Petr Špaček committed Jun 30, 2022

(cherry picked from commit 7187a5cf)

It was accidentally removed in the heat of
25eb91d2.

(cherry picked from commit 2630cf8e)

[v9_18] Add stress testing with RPZ

See merge request !6497

(cherry picked from commit d2725746)

Drop support for Debian 9 (Stretch) [v9_18]

See merge request !6495

(cherry picked from commit 4ce1f252)