The usefulness of naming and defining a "tagged section" is waning; its only remaining use is to describe a shared syntax common to all sections.
I think it's probably likely we want to omit this section entirely, but here's our chance to discuss that. Signed-off-by: John Snow <[email protected]> --- docs/devel/qapi-code-gen.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/devel/qapi-code-gen.rst b/docs/devel/qapi-code-gen.rst index 90488da7ffd..1897cde39cf 100644 --- a/docs/devel/qapi-code-gen.rst +++ b/docs/devel/qapi-code-gen.rst @@ -1011,6 +1011,12 @@ line "Features:", like this:: # # @feature: Description text + +.. _doc-tagged: + +Tagged sections +^^^^^^^^^^^^^^^ + A tagged section begins with a paragraph that starts with one of the following words: "Since:", "Returns:", "Errors:", "TODO:". It ends with the start of a new section. -- 2.55.0
