Re: [PATCH 1/3] qemu-nbd: Convert invocation documentation to rST

[Eric Blake]

On 1/16/20 8:15 AM, Peter Maydell wrote:
> The qemu-nbd documentation is currently in qemu-nbd.texi in Texinfo
> format, which we present to the user as:
>   * a qemu-nbd manpage
>   * a section of the main qemu-doc HTML documentation
>
> Convert the documentation to rST format, and present it to the user as:
>   * a qemu-nbd manpage
>   * part of the interop/ Sphinx manual

As I have now posted a patch that conflicts with this 
(https://lists.gnu.org/archive/html/qemu-devel/2020-01/msg05118.html), 
and it needs a v2, I'm happy to do my rebase on top of this series, and 
stage these patches through my NBD tree if they don't land on master 
sooner via another path.

> v1->v2:
>   * avoided some long lines in the Makefile
> ---
>   Makefile                               |  16 +-
>   MAINTAINERS                            |   1 +
>   docs/interop/conf.py                   |   4 +-
>   docs/interop/index.rst                 |   1 +
>   docs/interop/qemu-nbd.rst              | 263 +++++++++++++++++++++++++
>   docs/interop/qemu-option-trace.rst.inc |  30 +++
>   qemu-doc.texi                          |   6 -
>   qemu-nbd.texi                          | 214 --------------------
>   qemu-option-trace.texi                 |   4 +
>   9 files changed, 313 insertions(+), 226 deletions(-)
>   create mode 100644 docs/interop/qemu-nbd.rst
>   create mode 100644 docs/interop/qemu-option-trace.rst.inc
>   delete mode 100644 qemu-nbd.texi

Reviewed-by: Eric Blake <address@hidden>

--
Eric Blake, Principal Software Engineer
Red Hat, Inc.           +1-919-301-3226
Virtualization:  qemu.org | libvirt.org