[0/2] qemu-tech: move part to docs/devel, delete part

Message

Peter Maydell June 7, 2019, 3:28 p.m. UTC

This patchset makes some of the cleanups to qemu-tech.texi which
I suggested in my Sphinx transition plan:
https://lists.gnu.org/archive/html/qemu-devel/2019-05/msg04932.html

(1) the "translator internals" docs move to the devel/ manual
(and are given a simple by-hand texi-to-rst conversion)
(2) the "compared to other emulators" section is simply deleted:
since we haven't updated it since 2015 we obviously don't
care enough about it to keep it useful for users, and the wiki
or website would be a better place for that kind of "you might
want to know this before you install" information if we did
have anybody interested in keeping it current.

I suspect the TCG docs may have some stale info in them too,
but the devel/ manual isn't user-facing so not a very big deal.
Followup patches correcting any inaccuracies welcome :-)

thanks
-- PMM

Peter Maydell (2):
  Convert "translator internals" docs to RST, move to devel manual
  qemu-tech.texi: Remove "QEMU compared to other emulators" section

 docs/devel/index.rst |   1 +
 docs/devel/tcg.rst   | 111 +++++++++++++++++++++++
 qemu-tech.texi       | 210 -------------------------------------------
 3 files changed, 112 insertions(+), 210 deletions(-)
 create mode 100644 docs/devel/tcg.rst

Comments

Richard Henderson June 7, 2019, 6:16 p.m. UTC | #1

On 6/7/19 10:28 AM, Peter Maydell wrote:
> Peter Maydell (2):
>   Convert "translator internals" docs to RST, move to devel manual
>   qemu-tech.texi: Remove "QEMU compared to other emulators" section

Acked-by: Richard Henderson <[e-mail]>


r~

Stefan Hajnoczi June 14, 2019, 9:10 a.m. UTC | #2

On Fri, Jun 07, 2019 at 04:28:25PM +0100, Peter Maydell wrote:
> This patchset makes some of the cleanups to qemu-tech.texi which
> I suggested in my Sphinx transition plan:
> https://lists.gnu.org/archive/html/qemu-devel/2019-05/msg04932.html
> 
> (1) the "translator internals" docs move to the devel/ manual
> (and are given a simple by-hand texi-to-rst conversion)
> (2) the "compared to other emulators" section is simply deleted:
> since we haven't updated it since 2015 we obviously don't
> care enough about it to keep it useful for users, and the wiki
> or website would be a better place for that kind of "you might
> want to know this before you install" information if we did
> have anybody interested in keeping it current.
> 
> I suspect the TCG docs may have some stale info in them too,
> but the devel/ manual isn't user-facing so not a very big deal.
> Followup patches correcting any inaccuracies welcome :-)
> 
> thanks
> -- PMM
> 
> Peter Maydell (2):
>   Convert "translator internals" docs to RST, move to devel manual
>   qemu-tech.texi: Remove "QEMU compared to other emulators" section
> 
>  docs/devel/index.rst |   1 +
>  docs/devel/tcg.rst   | 111 +++++++++++++++++++++++
>  qemu-tech.texi       | 210 -------------------------------------------
>  3 files changed, 112 insertions(+), 210 deletions(-)
>  create mode 100644 docs/devel/tcg.rst
> 
> -- 
> 2.20.1
> 
> 

Reviewed-by: Stefan Hajnoczi <[e-mail]>