From: Peter Krempa <pkre...@redhat.com> Finding the correct link to a XML description or API reference section in a big blob of links concatenated in a paragraph is unpleasand and especially for 'capabilities' and 'domain capabilities' following each other.
Turn the API and XML reference sections into a list in RST and add CSS to fromat it a bit more compact. Signed-off-by: Peter Krempa <pkre...@redhat.com> --- docs/css/libvirt.css | 11 +++++++ docs/docs.rst | 69 ++++++++++++++++++++++++-------------------- 2 files changed, 48 insertions(+), 32 deletions(-) diff --git a/docs/css/libvirt.css b/docs/css/libvirt.css index 58ac1d385b..c80b1a54f6 100644 --- a/docs/css/libvirt.css +++ b/docs/css/libvirt.css @@ -123,6 +123,17 @@ img.diagram { margin-bottom: 1em; } +#documentation #application-development ul li p { + padding-bottom: 0px; + padding-top: 0px; +} + +#documentation #application-development ul { + margin-left: 2em; + padding-top: 0px; + padding-bottom: 0px; +} + .removedhv { color: darkred; } diff --git a/docs/docs.rst b/docs/docs.rst index 1f16a11e90..09939c1201 100644 --- a/docs/docs.rst +++ b/docs/docs.rst @@ -60,41 +60,46 @@ Application development ----------------------- `API reference <html/index.html>`__ - Reference manual for the C public API, split in - `common <html/libvirt-libvirt-common.html>`__, - `domain <html/libvirt-libvirt-domain.html>`__, - `domain checkpoint <html/libvirt-libvirt-domain-checkpoint.html>`__, - `domain snapshot <html/libvirt-libvirt-domain-snapshot.html>`__, - `error <html/libvirt-virterror.html>`__, - `event <html/libvirt-libvirt-event.html>`__, - `host <html/libvirt-libvirt-host.html>`__, - `interface <html/libvirt-libvirt-interface.html>`__, - `network <html/libvirt-libvirt-network.html>`__, - `node device <html/libvirt-libvirt-nodedev.html>`__, - `network filter <html/libvirt-libvirt-nwfilter.html>`__, - `secret <html/libvirt-libvirt-secret.html>`__, - `storage <html/libvirt-libvirt-storage.html>`__, - `stream <html/libvirt-libvirt-stream.html>`__ and - `admin <html/libvirt-libvirt-admin.html>`__, - `QEMU <html/libvirt-libvirt-qemu.html>`__, - `LXC <html/libvirt-libvirt-lxc.html>`__ libs + Reference manual for the C public API, split in: + + * `common <html/libvirt-libvirt-common.html>`__ + * `domain <html/libvirt-libvirt-domain.html>`__ + * `domain checkpoint <html/libvirt-libvirt-domain-checkpoint.html>`__ + * `domain snapshot <html/libvirt-libvirt-domain-snapshot.html>`__ + * `error <html/libvirt-virterror.html>`__ + * `event <html/libvirt-libvirt-event.html>`__ + * `host <html/libvirt-libvirt-host.html>`__ + * `interface <html/libvirt-libvirt-interface.html>`__ + * `network <html/libvirt-libvirt-network.html>`__ + * `node device <html/libvirt-libvirt-nodedev.html>`__ + * `network filter <html/libvirt-libvirt-nwfilter.html>`__ + * `secret <html/libvirt-libvirt-secret.html>`__ + * `storage <html/libvirt-libvirt-storage.html>`__ + * `stream <html/libvirt-libvirt-stream.html>`__ + + and the documentation for the API of the additional libs: + + * `admin <html/libvirt-libvirt-admin.html>`__ + * `QEMU <html/libvirt-libvirt-qemu.html>`__ + * `LXC <html/libvirt-libvirt-lxc.html>`__ `XML schemas <format.html>`__ Description of the XML schemas for - `domains <formatdomain.html>`__, - `networks <formatnetwork.html>`__, - `network ports <formatnetworkport.html>`__, - `network filtering <formatnwfilter.html>`__, - `storage <formatstorage.html>`__, - `storage encryption <formatstorageencryption.html>`__, - `capabilities <formatcaps.html>`__, - `domain capabilities <formatdomaincaps.html>`__, - `storage pool capabilities <formatstoragecaps.html>`__, - `node devices <formatnode.html>`__, - `secrets <formatsecret.html>`__, - `snapshots <formatsnapshot.html>`__, - `checkpoints <formatcheckpoint.html>`__, - `backup jobs <formatbackup.html>`__ + + * `domains <formatdomain.html>`__ + * `networks <formatnetwork.html>`__ + * `network ports <formatnetworkport.html>`__ + * `network filtering <formatnwfilter.html>`__ + * `storage <formatstorage.html>`__ + * `storage encryption <formatstorageencryption.html>`__ + * `capabilities <formatcaps.html>`__ + * `domain capabilities <formatdomaincaps.html>`__ + * `storage pool capabilities <formatstoragecaps.html>`__ + * `node devices <formatnode.html>`__ + * `secrets <formatsecret.html>`__ + * `snapshots <formatsnapshot.html>`__ + * `checkpoints <formatcheckpoint.html>`__ + * `backup jobs <formatbackup.html>`__ `Language bindings and API modules <bindings.html>`__ Bindings of the libvirt API for -- 2.49.0