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

[Pierre Morel <pmorel@linux.ibm.com>]

On 2020-02-13 17:29, Cornelia Huck 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} | 796 ++++++++++++-----------
>   3 files changed, 420 insertions(+), 379 deletions(-)
>   rename docs/{vfio-ap.txt => system/vfio-ap.rst} (55%)

...snip...

>   
> -   Example 1: Valid configuration:
> -   ------------------------------
> -   Guest1: adapters 1,2  domains 5,6
> -   Guest2: adapter  1,2  domain 7
> +Example 1: Valid configuration
> +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
> +
> ++----------+--------+--------+
> +|          | Guest1 | Guest2 |
> ++==========+========+========+
> +| adapters |  1, 2  |  1, 2  |
> ++----------+--------+--------+
> +| domains  |  5, 6  |  7     |
> ++----------+--------+--------+
> +

Here when leaving the first cell empty I have a bad rendering with LaTeX.
It is correct when it is filled with something like:

+----------+--------+--------+
|  type    | Guest1 | Guest2 |
+==========+========+========+
| adapters |  1, 2  |  1     |
+----------+--------+--------+
| domains  |  5, 6  |  6, 7  |
+----------+--------+--------+

However it may be because I do not use the right tools.
Did not find which one I am suppose to use.
Currently using:
rst2latex vfio-ap.rst > vfio-ap.tex && pdflatex vfio-ap.tex

Regards,
Pierre




-- 
Pierre Morel
IBM Lab Boeblingen