Re: [PATCH RFC 2/2] docs: rstfy vfio-ap documentation

[Cornelia Huck <cohuck@redhat.com>]

On Tue, 28 Jan 2020 19:01:42 +0100
Cornelia Huck <cohuck@redhat.com> wrote:

> Move to system/, as this is mostly about configuring vfio-ap.
> 
> Signed-off-by: Cornelia Huck <cohuck@redhat.com>
> ---
>  MAINTAINERS                              |   2 +-
>  docs/system/index.rst                    |   1 +
>  docs/{vfio-ap.txt => system/vfio-ap.rst} | 755 ++++++++++++-----------
>  3 files changed, 387 insertions(+), 371 deletions(-)
>  rename docs/{vfio-ap.txt => system/vfio-ap.rst} (56%)
> 

> -Example: Configure AP Matrixes for Three Linux Guests:
> -=====================================================
> +Example: Configure AP Matrices for Three Linux Guests
> +-----------------------------------------------------
>  Let's now provide an example to illustrate how KVM guests may be given
>  access to AP facilities. For this example, we will show how to configure
>  three guests such that executing the lszcrypt command on the guests would
> -look like this:
> -
> -Guest1
> -------
> -CARD.DOMAIN TYPE  MODE
> -------------------------------
> -05          CEX5C CCA-Coproc
> -05.0004     CEX5C CCA-Coproc
> -05.00ab     CEX5C CCA-Coproc
> -06          CEX5A Accelerator
> -06.0004     CEX5A Accelerator
> -06.00ab     CEX5C CCA-Coproc
> -
> -Guest2
> -------
> -CARD.DOMAIN TYPE  MODE
> -------------------------------
> -05          CEX5A Accelerator
> -05.0047     CEX5A Accelerator
> -05.00ff     CEX5A Accelerator (5,4), (5,171), (6,4), (6,171),
> -
> -Guest3
> -------
> -CARD.DOMAIN TYPE  MODE
> -------------------------------
> -06          CEX5A Accelerator
> -06.0047     CEX5A Accelerator
> -06.00ff     CEX5A Accelerator
> +look like this::
> +
> +  Guest1
> +  ------
> +  CARD.DOMAIN TYPE  MODE
> +  ------------------------------
> +  05          CEX5C CCA-Coproc
> +  05.0004     CEX5C CCA-Coproc
> +  05.00ab     CEX5C CCA-Coproc
> +  06          CEX5A Accelerator
> +  06.0004     CEX5A Accelerator
> +  06.00ab     CEX5C CCA-Coproc
> +
> +  Guest2
> +  ------
> +  CARD.DOMAIN TYPE  MODE
> +  ------------------------------
> +  05          CEX5A Accelerator
> +  05.0047     CEX5A Accelerator
> +  05.00ff     CEX5A Accelerator (5,4), (5,171), (6,4), (6,171),

Just noticed this trailing stuff (had already been in the original
file). Looks like a stray paste, will remove.

> +
> +  Guest3
> +  ------
> +  CARD.DOMAIN TYPE  MODE
> +  ------------------------------
> +  06          CEX5A Accelerator
> +  06.0047     CEX5A Accelerator
> +  06.00ff     CEX5A Accelerator