Revision tags: v9.1.0 |
|
#
d95f260a |
| 12-Dec-2023 |
Peter Maydell <peter.maydell@linaro.org> |
docs/devel/docs: Document .hx file syntax
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 th
docs/devel/docs: Document .hx file syntax
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.maydell@linaro.org> Reviewed-by: Luc Michel <luc.michel@amd.com> Reviewed-by: David Woodhouse <dwmw@amazon.co.uk> Message-id: 20231212162313.1742462-1-peter.maydell@linaro.org
show more ...
|
Revision tags: v8.0.0, v7.2.0 |
|
#
a5ebaaf9 |
| 21-Oct-2022 |
Ani Sinha <ani@anisinha.ca> |
acpi/tests/avocado/bits/doc: add a doc file to describe the acpi bits test
A doc file is added under docs/devel that describes the purpose of the various test files and gives guidance to developers
acpi/tests/avocado/bits/doc: add a doc file to describe the acpi bits test
A doc file is added under docs/devel that describes the purpose of the various test files and gives guidance to developers on where and how to make changes.
Cc: Daniel P. Berrange" <berrange@redhat.com> Cc: Paolo Bonzini <pbonzini@redhat.com> Cc: Maydell Peter <peter.maydell@linaro.org> Cc: John Snow <jsnow@redhat.com> Cc: Thomas Huth <thuth@redhat.com> Cc: Alex Bennée <alex.bennee@linaro.org> Cc: Igor Mammedov <imammedo@redhat.com> Cc: Michael Tsirkin <mst@redhat.com> Signed-off-by: Ani Sinha <ani@anisinha.ca> Message-Id: <20221021095108.104843-7-ani@anisinha.ca> Reviewed-by: Michael S. Tsirkin <mst@redhat.com> Signed-off-by: Michael S. Tsirkin <mst@redhat.com>
show more ...
|
Revision tags: v7.0.0 |
|
#
ab20edf5 |
| 19-Apr-2022 |
Alex Bennée <alex.bennee@linaro.org> |
docs/devel: drop :hidden: and :includehidden: tags
This was confusing and in the case of qtest was hiding the details of the qgraph sub-document in the qtest pages.
Signed-off-by: Alex Bennée <alex
docs/devel: drop :hidden: and :includehidden: tags
This was confusing and in the case of qtest was hiding the details of the qgraph sub-document in the qtest pages.
Signed-off-by: Alex Bennée <alex.bennee@linaro.org> Acked-by: Richard Henderson <richard.henderson@linaro.org> Message-Id: <20220419091020.3008144-4-alex.bennee@linaro.org>
show more ...
|
#
c6afd2bd |
| 09-Mar-2022 |
Alex Bennée <alex.bennee@linaro.org> |
docs/devel: try and impose some organisation
We have a growing set of developer docs but the index is currently in order of when stuff was added. Try and make things a bit easier to find my adding s
docs/devel: try and impose some organisation
We have a growing set of developer docs but the index is currently in order of when stuff was added. Try and make things a bit easier to find my adding sub indexes and organising into themes.
Signed-off-by: Alex Bennée <alex.bennee@linaro.org> Reviewed-by: Kashyap Chamarthy <kchamart@redhat.com> Message-Id: <20220315121251.2280317-7-alex.bennee@linaro.org>
show more ...
|