docs: standardize book titles to === with overline

Documents within a Sphinx manual are separate files and therefore can use
different conventions for headings.  However, keeping some consistency is
useful so that included files are easy to get right.

This patch uses a standard heading format for book titles, so that it is
obvious when a file sits at the top level toctree of a book or man page.
The heading is irrelevant for man pages, but keep it consistent as well.

Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
This commit is contained in:
Paolo Bonzini 2021-09-07 15:58:12 +02:00
parent 52fb8ad37a
commit 8a1f7d299c
9 changed files with 11 additions and 2 deletions

View File

@ -3,6 +3,7 @@
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
================================
Welcome to QEMU's documentation!
================================

View File

@ -1,5 +1,6 @@
:orphan:
============================
QEMU block drivers reference
============================

View File

@ -1,5 +1,6 @@
:orphan:
==================================
QEMU / KVM CPU model configuration
==================================

View File

@ -6,8 +6,9 @@
parts of the documentation that go in the manpage as well as the
HTML manual.
Title
=====
=======================
QEMU User Documentation
=======================
Synopsis
--------

View File

@ -1,3 +1,4 @@
=======================
QEMU disk image utility
=======================

View File

@ -1,3 +1,4 @@
=====================================
QEMU Disk Network Block Device Server
=====================================

View File

@ -1,3 +1,4 @@
==================================
QEMU persistent reservation helper
==================================

View File

@ -1,3 +1,4 @@
===================
QEMU Storage Daemon
===================

View File

@ -1,3 +1,4 @@
=========================
QEMU SystemTap trace tool
=========================