diff options
| author | Paolo Bonzini <pbonzini@redhat.com> | 2021-09-07 16:01:28 +0200 |
|---|---|---|
| committer | Paolo Bonzini <pbonzini@redhat.com> | 2021-09-13 13:56:26 +0200 |
| commit | 06905f640242c927f07e8c4b45fd4061ffa235ef (patch) | |
| tree | cf592817e57952f6bd910b8d54937f58bcc3acea /docs/tools/index.rst | |
| parent | 8a1f7d299c75468af0f761ae9382b129be9d5774 (diff) | |
docs: standardize directory index to --- with overline
Use a standard heading format for the index.rst file in a directory.
Using overlines makes it clear that individual documents can use e.g.
=== for chapter titles and --- for section titles, as suggested in the
Linux kernel guidelines[1]. They could do it anyway, because documents
included in a toctree are parsed separately and therefore are not tied
to the same conventions for headings. However, keeping some consistency is
useful since sometimes files are included from multiple places.
[1] https://www.kernel.org/doc/html/latest/doc-guide/sphinx.html
Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
Diffstat (limited to 'docs/tools/index.rst')
| -rw-r--r-- | docs/tools/index.rst | 3 |
1 files changed, 2 insertions, 1 deletions
diff --git a/docs/tools/index.rst b/docs/tools/index.rst index ef6041a490..1edd5a8054 100644 --- a/docs/tools/index.rst +++ b/docs/tools/index.rst @@ -1,5 +1,6 @@ +----- Tools -===== +----- This section of the manual documents QEMU's "tools": its command line utilities and other standalone programs. |