mirror of
https://gitlab.isc.org/isc-projects/bind9
synced 2025-08-22 10:10:06 +00:00
5c9b4f3163
The meson build switched to generating the file grammars and using meson to build the manpages/ARM. This is because meson doesn't work well when writing files outside the build directory. However, this has been suboptimal when someone only wants to build the documentation (like RTD). Sphinx can now be used outside meson like it was with autoconf. Grammars are now updated by the developer with CI checking if one is needed or not, like clang-format.
42 lines
1.2 KiB
Python
42 lines
1.2 KiB
Python
############################################################################
|
|
# Copyright (C) Internet Systems Consortium, Inc. ("ISC")
|
|
#
|
|
# SPDX-License-Identifier: MPL-2.0
|
|
#
|
|
# This Source Code Form is subject to the terms of the Mozilla Public
|
|
# License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
# file, you can obtain one at https://mozilla.org/MPL/2.0/.
|
|
#
|
|
# See the COPYRIGHT file distributed with this work for additional
|
|
# information regarding copyright ownership.
|
|
############################################################################
|
|
|
|
"""
|
|
Sphinx domain "rndcconf". See iscconf.py for details.
|
|
"""
|
|
|
|
from pathlib import Path
|
|
|
|
from docutils import nodes
|
|
|
|
import iscconf
|
|
import parsegrammar
|
|
|
|
grammar_path = Path(__file__).resolve().parent.parent.parent / "misc" / "rndc.grammar"
|
|
|
|
|
|
class ToBeReplacedStatementList(nodes.General, nodes.Element):
|
|
"""
|
|
Placeholder, does nothing, but must be picklable
|
|
(= cannot be in a generated class).
|
|
"""
|
|
|
|
|
|
def setup(app):
|
|
with open(grammar_path, encoding="utf-8") as filein:
|
|
grammar = parsegrammar.parse_mapbody(filein)
|
|
|
|
return iscconf.setup(
|
|
app, "rndcconf", "rndc.conf", ToBeReplacedStatementList, grammar
|
|
)
|