[Qemu-commits] [qemu/qemu] 2f2c4e: Convert "translator internals" docs to RST, move t...

[Peter Maydell]

  Branch: refs/heads/master
  Home:   https://github.com/qemu/qemu
  Commit: 2f2c4e4731449449a2b1aafcd73e4f9ae107d78b
      
https://github.com/qemu/qemu/commit/2f2c4e4731449449a2b1aafcd73e4f9ae107d78b
  Author: Peter Maydell <address@hidden>
  Date:   2019-06-17 (Mon, 17 Jun 2019)

  Changed paths:
    M docs/devel/index.rst
    A docs/devel/tcg.rst
    M qemu-tech.texi

  Log Message:
  -----------
  Convert "translator internals" docs to RST, move to devel manual

Our user-facing manual currently has a section "translator internals"
which has some high-level information about the design of the
TCG translator. This should really be in our new devel/ manual.
Convert it to RST format and move it there.

Signed-off-by: Peter Maydell <address@hidden>
Acked-by: Richard Henderson <address@hidden>
Message-id: address@hidden
Reviewed-by: Stefan Hajnoczi <address@hidden>


  Commit: 282d36b5e27ba86d42d0638430e439c2c257367b
      
https://github.com/qemu/qemu/commit/282d36b5e27ba86d42d0638430e439c2c257367b
  Author: Peter Maydell <address@hidden>
  Date:   2019-06-17 (Mon, 17 Jun 2019)

  Changed paths:
    M qemu-tech.texi

  Log Message:
  -----------
  qemu-tech.texi: Remove "QEMU compared to other emulators" section

The "QEMU compared to other emulators" section of our documentation
hasn't been updated since 2015 (and parts of the text are even older).
We're clearly not very well placed to track the evolution of a
dozen other emulation projects, and an inaccurate or out of date
comparison doesn't serve anybody, so we're best off just removing
the whole documentation section.

If anybody cares strongly about maintaining a comparison page,
it's probably better to do that on the project's wiki where
we can update it more dynamically.

Signed-off-by: Peter Maydell <address@hidden>
Reviewed-by: Daniel P. Berrangé <address@hidden>
Acked-by: Richard Henderson <address@hidden>
Message-id: address@hidden
Reviewed-by: Stefan Hajnoczi <address@hidden>


  Commit: 9b4cc0c2d4775f5cd9d3ec97ceadc78d17590cce
      
https://github.com/qemu/qemu/commit/9b4cc0c2d4775f5cd9d3ec97ceadc78d17590cce
  Author: Peter Maydell <address@hidden>
  Date:   2019-06-17 (Mon, 17 Jun 2019)

  Changed paths:
    M docs/specs/index.rst

  Log Message:
  -----------
  docs/specs/index.rst: Fix minor syntax issues

The docs/specs/index.rst has a couple of minor issues which
we didn't notice because we weren't building the manual:
 * the ToC entry for the new PPC XIVE docs points to
   a nonexistent file
 * the initial comment needs to be marked by '..', not '.',
   or it will appear in the output
 * the title doesn't match the capitialization used by
   the existing interop or devel manuals, and uses
   'full-system emulation' rather than the 'system emulation'
   that the interop manual title uses

Fix these minor issues before we start trying to build the manual.

Signed-off-by: Peter Maydell <address@hidden>
Reviewed-by: Cédric Le Goater <address@hidden>
Acked-by: Aleksandar Markovic <address@hidden>
Message-id: address@hidden


  Commit: 0783a732f9ee2de28dc722d6cd87f04b2f264a48
      
https://github.com/qemu/qemu/commit/0783a732f9ee2de28dc722d6cd87f04b2f264a48
  Author: Peter Maydell <address@hidden>
  Date:   2019-06-17 (Mon, 17 Jun 2019)

  Changed paths:
    M Makefile
    A docs/specs/conf.py

  Log Message:
  -----------
  docs: Build and install specs manual

Now we have some rST format docs in the docs/specs/ manual, we should
actually build and install it.

Signed-off-by: Peter Maydell <address@hidden>
Acked-by: Aleksandar Markovic <address@hidden>
Message-id: address@hidden


  Commit: 076243ffe6c1b687e9e6d98348c3bf3398df78f3
      
https://github.com/qemu/qemu/commit/076243ffe6c1b687e9e6d98348c3bf3398df78f3
  Author: Peter Maydell <address@hidden>
  Date:   2019-06-17 (Mon, 17 Jun 2019)

  Changed paths:
    M Makefile
    M docs/devel/index.rst
    A docs/devel/tcg.rst
    A docs/specs/conf.py
    M docs/specs/index.rst
    M qemu-tech.texi

  Log Message:
  -----------
  Merge remote-tracking branch 'remotes/pmaydell/tags/pull-docs-20190617' into 
staging

docs infrastructure queue:
 * fix some minor syntax issues in docs/specs/index.rst
 * build and install the 'specs' manual, since it now has some content
 * delete the "QEMU compared to other emulators" section of the docs
 * Convert "translator internals" docs to RST, move to devel manual

# gpg: Signature made Mon 17 Jun 2019 15:56:07 BST
# gpg:                using RSA key E1A5C593CD419DE28E8315CF3C2525ED14360CDE
# gpg:                issuer "address@hidden"
# gpg: Good signature from "Peter Maydell <address@hidden>" [ultimate]
# gpg:                 aka "Peter Maydell <address@hidden>" [ultimate]
# gpg:                 aka "Peter Maydell <address@hidden>" [ultimate]
# Primary key fingerprint: E1A5 C593 CD41 9DE2 8E83  15CF 3C25 25ED 1436 0CDE

* remotes/pmaydell/tags/pull-docs-20190617:
  docs: Build and install specs manual
  docs/specs/index.rst: Fix minor syntax issues
  qemu-tech.texi: Remove "QEMU compared to other emulators" section
  Convert "translator internals" docs to RST, move to devel manual

Signed-off-by: Peter Maydell <address@hidden>


Compare: https://github.com/qemu/qemu/compare/144ecc7f1a12...076243ffe6c1