[PATCH v2 1/2] docs: Update introduction in pci-addresses.rst

Changing the introduction to bring the idea of this document better across. Signed-off-by: Andrea Bolognani <abologna(a)redhat.com&gt; Reviewed-by: Boris Fiuczynski <fiuczy(a)linux.ibm.com&gt; Reviewed-by: Cornelia Huck <cohuck(a)redhat.com&gt; --- docs/pci-addresses.rst | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/pci-addresses.rst b/docs/pci-addresses.rst index 1d2dc8e5fc..7c8e9edd73 100644 --- a/docs/pci-addresses.rst +++ b/docs/pci-addresses.rst @@ -4,9 +4,12 @@ PCI addresses in domain XML and guest OS .. contents:: -When discussing PCI addresses, it's important to understand the -relationship between the addresses that can be seen in the domain XML -and those that are visible inside the guest OS. +Looking at the configuration for a guest, it would be reasonable +to expect that each PCI device would show up in the guest OS with +a PCI address that matches the one present in the corresponding +``<address>`` element of the domain XML, but that's not guaranteed +to happen and will in fact not be the case in all but the simplest +scenarios. Simple cases -- 2.25.1