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

[Cornelia Huck]

On Thu, 16 Apr 2020 17:56:17 +0200
Boris Fiuczynski <fiuczy at linux.ibm.com> wrote:

> Changing the introduction to bring the idea of this document better across.
> 
> Signed-off-by: Andrea Bolognani <abologna at redhat.com>
> Reviewed-by: Boris Fiuczynski <fiuczy at linux.ibm.com>
> ---
>  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

Reviewed-by: Cornelia Huck <cohuck at redhat.com>

...although I'm not sure about the s-o-b chain here :)