On Tue, 12 Dec 2023 at 16:23, Peter Maydell <peter.mayd...@linaro.org> wrote: > > We don't currently document the syntax of .hx files anywhere > except in a few comments at the top of individual .hx files. > We don't even have somewhere in the developer docs where we > could do this. > > Add a new files docs/devel/docs.rst which can be a place to > document how our docs build process works. For the moment, > put in only a brief introductory paragraph and the documentation > of the .hx files. We could later add to this file by for > example describing how the QAPI-schema-to-docs process works, > or anything else that developers might need to know about > how to add documentation. > > Make the .hx files refer to this doc file, and clean > up their header comments to be more accurate for the > usage in each file and less cut-n-pasted. > > Signed-off-by: Peter Maydell <peter.mayd...@linaro.org> > --- > My motivation here is that we're about to add support for > extending the SRST directive to specify a label so we > can hyperlink to a documentation fragment; this gives us > somewhere we can document the syntax for that. > ---
I'll take this via the target-arm tree. thanks -- PMM