[PULL 00/33] docs queue

[Peter Maydell]

As promised, here's a pull request with the patches which do the
qemu-doc rST conversion.

Minor changes since the patchset was posted:
 * rebased
 * the two auto-generated patches have been regenerated, to account
   for the qemu-options.hx changes that went into master since the
   patchset was posted

I have also now done the testing of the OSX change to the docs link.
We've agreed to leave updating the Windows installer for later.

thanks
-- PMM

The following changes since commit 6b02fca71329ed858423b710699952b7f017034e:

  Merge remote-tracking branch 'remotes/palmer/tags/riscv-for-master-5.0-sf4' 
into staging (2020-03-05 20:53:53 +0000)

are available in the Git repository at:

  https://git.linaro.org/people/pmaydell/qemu-arm.git tags/pull-docs-20200306

for you to fetch changes up to 29f9dff79073cfdc336466a950294be91b90f514:

  *.hx: Remove all the STEXI/ETEXI blocks (2020-03-06 11:06:55 +0000)

----------------------------------------------------------------
docs:
 * Convert qemu-doc from Texinfo to rST

----------------------------------------------------------------
Kashyap Chamarthy (1):
      docs/system: Convert qemu-cpu-models.texi to rST

Paolo Bonzini (13):
      qemu-doc: convert user-mode emulation to a separate Sphinx manual
      qemu-doc: remove target OS documentation
      texi2pod: parse @include directives outside "@c man" blocks
      qemu-doc: split CPU models doc between MIPS and x86 parts
      qemu-doc: split qemu-doc.texi in multiple files
      qemu-doc: extract common system emulator documentation from the PC section
      qemu-doc: move system requirements chapter inside PC section
      qemu-doc: split target sections to separate files
      qemu-doc: move qemu-tech.texi into main section
      qemu-doc: move included files to docs/system
      qemu-doc: remove indices other than findex
      docs/system: put qemu-block-drivers body in an included file
      docs/system: convert Texinfo documentation to rST

Peter Maydell (19):
      qemu-doc: Remove the "CPU emulation" part of the "Implementation notes"
      docs: Create defs.rst.inc as a place to define substitutions
      docs/system: Convert security.texi to rST format
      docs/system: convert managed startup to rST.
      docs/system: convert the documentation of deprecated features to rST.
      hmp-commands.hx: Add rST documentation fragments
      hmp-commands-info.hx: Add rST documentation fragments
      doc/scripts/hxtool.py: Strip trailing ':' from DEFHEADING/ARCHHEADING
      docs: Roll semihosting option information into qemu-options.hx
      docs: Roll -prom-env and -g target-specific info into qemu-options.hx
      scripts/hxtool-conv: Archive script used in qemu-options.hx conversion
      qemu-options.hx: Add rST documentation fragments
      qemu-options.hx: Fix up the autogenerated rST
      docs: Split out sections for the manpage into .rst.inc files
      docs: Generate qemu.1 manpage with Sphinx
      ui/cocoa.m: Update documentation file and pathname
      docs: Stop building qemu-doc
      docs: Remove old texinfo sources
      *.hx: Remove all the STEXI/ETEXI blocks

 docs/specs/ivshmem-spec.txt                 |    4 +-
 Makefile                                    |   47 +-
 .gitignore                                  |    3 -
 MAINTAINERS                                 |    7 +-
 docs/conf.py                                |    6 +
 docs/defs.rst.inc                           |   15 +
 docs/index.html.in                          |    2 +-
 docs/index.rst                              |    1 +
 docs/qemu-cpu-models.texi                   |  677 ---
 docs/sphinx/hxtool.py                       |   10 +-
 docs/system/build-platforms.rst             |   79 +
 docs/system/conf.py                         |    8 +-
 docs/system/cpu-models-mips.rst.inc         |  105 +
 docs/system/cpu-models-x86.rst.inc          |  365 ++
 docs/system/deprecated.rst                  |  446 ++
 docs/system/device-url-syntax.rst.inc       |  228 +
 docs/system/gdb.rst                         |   81 +
 docs/system/images.rst                      |   85 +
 docs/system/index.rst                       |   22 +-
 docs/system/invocation.rst                  |   18 +
 docs/system/ivshmem.rst                     |   64 +
 docs/system/keys.rst                        |    6 +
 docs/system/keys.rst.inc                    |   35 +
 docs/system/license.rst                     |   11 +
 docs/system/linuxboot.rst                   |   30 +
 docs/system/managed-startup.rst             |   35 +
 docs/system/monitor.rst                     |   31 +
 docs/system/mux-chardev.rst                 |    6 +
 docs/system/mux-chardev.rst.inc             |   27 +
 docs/system/net.rst                         |  100 +
 docs/system/qemu-block-drivers.rst          |  989 +---
 docs/system/qemu-block-drivers.rst.inc      |  954 ++++
 docs/system/qemu-cpu-models.rst             |   20 +
 docs/system/qemu-manpage.rst                |   45 +
 docs/system/quickstart.rst                  |   13 +
 docs/{security.texi => system/security.rst} |   82 +-
 docs/system/target-arm.rst                  |  217 +
 docs/system/target-i386-desc.rst.inc        |   62 +
 docs/system/target-i386.rst                 |   23 +
 docs/system/target-m68k.rst                 |   21 +
 docs/system/target-mips.rst                 |  120 +
 docs/system/target-ppc.rst                  |   47 +
 docs/system/target-sparc.rst                |   62 +
 docs/system/target-sparc64.rst              |   37 +
 docs/system/target-xtensa.rst               |   27 +
 docs/system/targets.rst                     |   19 +
 docs/system/tls.rst                         |  328 ++
 docs/system/usb.rst                         |  137 +
 docs/system/vnc-security.rst                |  202 +
 docs/user/conf.py                           |   15 +
 docs/user/index.rst                         |   16 +
 docs/user/main.rst                          |  295 ++
 hmp-commands-info.hx                        |  600 +--
 hmp-commands.hx                             | 1451 +++---
 qemu-deprecated.texi                        |  377 --
 qemu-doc.texi                               | 2967 -----------
 qemu-option-trace.texi                      |   28 -
 qemu-options.hx                             | 7333 ++++++++++++++-------------
 qemu-tech.texi                              |  195 -
 scripts/hxtool-conv.pl                      |  137 +
 scripts/texi2pod.pl                         |   36 +-
 ui/cocoa.m                                  |    4 +-
 62 files changed, 9302 insertions(+), 10111 deletions(-)
 create mode 100644 docs/defs.rst.inc
 delete mode 100644 docs/qemu-cpu-models.texi
 create mode 100644 docs/system/build-platforms.rst
 create mode 100644 docs/system/cpu-models-mips.rst.inc
 create mode 100644 docs/system/cpu-models-x86.rst.inc
 create mode 100644 docs/system/deprecated.rst
 create mode 100644 docs/system/device-url-syntax.rst.inc
 create mode 100644 docs/system/gdb.rst
 create mode 100644 docs/system/images.rst
 create mode 100644 docs/system/invocation.rst
 create mode 100644 docs/system/ivshmem.rst
 create mode 100644 docs/system/keys.rst
 create mode 100644 docs/system/keys.rst.inc
 create mode 100644 docs/system/license.rst
 create mode 100644 docs/system/linuxboot.rst
 create mode 100644 docs/system/managed-startup.rst
 create mode 100644 docs/system/monitor.rst
 create mode 100644 docs/system/mux-chardev.rst
 create mode 100644 docs/system/mux-chardev.rst.inc
 create mode 100644 docs/system/net.rst
 create mode 100644 docs/system/qemu-block-drivers.rst.inc
 create mode 100644 docs/system/qemu-cpu-models.rst
 create mode 100644 docs/system/qemu-manpage.rst
 create mode 100644 docs/system/quickstart.rst
 rename docs/{security.texi => system/security.rst} (77%)
 create mode 100644 docs/system/target-arm.rst
 create mode 100644 docs/system/target-i386-desc.rst.inc
 create mode 100644 docs/system/target-i386.rst
 create mode 100644 docs/system/target-m68k.rst
 create mode 100644 docs/system/target-mips.rst
 create mode 100644 docs/system/target-ppc.rst
 create mode 100644 docs/system/target-sparc.rst
 create mode 100644 docs/system/target-sparc64.rst
 create mode 100644 docs/system/target-xtensa.rst
 create mode 100644 docs/system/targets.rst
 create mode 100644 docs/system/tls.rst
 create mode 100644 docs/system/usb.rst
 create mode 100644 docs/system/vnc-security.rst
 create mode 100644 docs/user/conf.py
 create mode 100644 docs/user/index.rst
 create mode 100644 docs/user/main.rst
 delete mode 100644 qemu-deprecated.texi
 delete mode 100644 qemu-doc.texi
 delete mode 100644 qemu-option-trace.texi
 delete mode 100644 qemu-tech.texi
 create mode 100755 scripts/hxtool-conv.pl