[libvirt PATCH 1/4] docs: Use consistent style in pci-addresses.rst
Indent all code snippets by the same number of spaces, and don't
embed the :: marker in the line preceding a code block.
This commit is best viewed with 'git show -w'.
Signed-off-by: Andrea Bolognani <abologna(a)redhat.com>
---
docs/pci-addresses.rst | 60 ++++++++++++++++++++++--------------------
1 file changed, 32 insertions(+), 28 deletions(-)
diff --git a/docs/pci-addresses.rst b/docs/pci-addresses.rst
index fbc741e344..0b83bb231f 100644
--- a/docs/pci-addresses.rst
+++ b/docs/pci-addresses.rst
@@ -196,24 +196,26 @@ In the simplest case, the following XML snippet
::
- <controller type='pci' index='0' model='pci-root'/>
- <controller type='pci' index='1' model='pci-bridge'>
- <model name='pci-bridge'/>
- <target chassisNr='1'/>
- <address type='pci' domain='0x0000' bus='0x00'
slot='0x01' function='0x0'>
- <zpci uid='0x0002' fid='0x00000001'/>
- </address>
- </controller>
- <interface type='bridge'>
- <mac address='02:ca:fe:fa:ce:04'/>
- <source bridge='virbr0'/>
- <model type='virtio'/>
- <address type='pci' domain='0x0000' bus='0x01'
slot='0x01' function='0x0'>
- <zpci uid='0x0001' fid='0x00000000'/>
- </address>
- </interface>
-
-will result in the following in a Linux guest::
+ <controller type='pci' index='0' model='pci-root'/>
+ <controller type='pci' index='1' model='pci-bridge'>
+ <model name='pci-bridge'/>
+ <target chassisNr='1'/>
+ <address type='pci' domain='0x0000' bus='0x00'
slot='0x01' function='0x0'>
+ <zpci uid='0x0002' fid='0x00000001'/>
+ </address>
+ </controller>
+ <interface type='bridge'>
+ <mac address='02:ca:fe:fa:ce:04'/>
+ <source bridge='virbr0'/>
+ <model type='virtio'/>
+ <address type='pci' domain='0x0000' bus='0x01'
slot='0x01' function='0x0'>
+ <zpci uid='0x0001' fid='0x00000000'/>
+ </address>
+ </interface>
+
+will result in the following in a Linux guest:
+
+::
0001:00:00.0 Ethernet controller: Red Hat, Inc. Virtio network device
@@ -221,7 +223,7 @@ Note that the PCI bridge is not visible in the guest; s390x always has
a flat
topology.
Neither are any changes in the PCI address visible in the guest; replacing
-the PCI address for the virtio-net device with
+the PCI address for the ``virtio-net`` device with
::
@@ -236,15 +238,17 @@ snippet
::
- <interface type='bridge'>
- <mac address='02:ca:fe:fa:ce:04'/>
- <source bridge='virbr0'/>
- <model type='virtio'/>
- <address type='pci' domain='0x0000' bus='0x01'
slot='0x07' function='0x3'>
- <zpci uid='0x0007' fid='0x00000003'/>
- </address>
- </interface>
+ <interface type='bridge'>
+ <mac address='02:ca:fe:fa:ce:04'/>
+ <source bridge='virbr0'/>
+ <model type='virtio'/>
+ <address type='pci' domain='0x0000' bus='0x01'
slot='0x07' function='0x3'>
+ <zpci uid='0x0007' fid='0x00000003'/>
+ </address>
+ </interface>
-will yield the following result in a Linux guest::
+will yield the following result in a Linux guest:
+
+::
0007:00:00.0 Ethernet controller: Red Hat, Inc. Virtio network device
--
2.25.2