[Bug 1884982] [NEW] User-emu documentation mentions inexistent "runtime" downloads

* [Bug 1884982] [NEW] User-emu documentation mentions inexistent "runtime" downloads
@ 2020-06-24 15:12 Mingye Wang
  2020-11-22  0:03 ` [Bug 1884982] " Peter Maydell
                   ` (2 more replies)
  0 siblings, 3 replies; 4+ messages in thread
From: Mingye Wang @ 2020-06-24 15:12 UTC (permalink / raw)
  To: qemu-devel

Public bug reported:

The official documentation for the user-space emulator[1] contains many
references to binary blobs no longer provided by  QEMU.org for download.
The parts mentioning them should be rephrased to avoid confusion and
instructions for building these components should be provided (maybe as
a reference to the LFS book with some scripts, or... cut a deal with
some super slim Linux distros). The specific parts are:

* qemu-XXX-i386-wine.tar.gz, a wine build under the prefix /wine.
* qemu-runtime-i386-XXX-.tar.gz, a glibc build.

  [1]: https://www.qemu.org/docs/master/user/main.html

In addition, the documentation contains many other instances of
inexistent "tar.gz" files, such as in "Network emulation". Most of these
are inherited from the days of texi documentation more than 10 years
ago, and they are so old that GitHub's blame have become unreliable.
Someone really should run `fgrep -r 'tar.gz' doc' on the QEMU source
tree.

The issue was previously reported as [2], but nobody bother enough to
google the filename to find out where the confused user got the idea
from.

  [2]: https://www.mail-archive.com/qemu-devel@nongnu.org/msg569174.html

** Affects: qemu
     Importance: Undecided
         Status: New

** Tags: documentation

** Description changed:

  The official documentation for the user-space emulator[1] contains many
  references to binary blobs no longer provided by  QEMU.org for download.
  The parts mentioning them should be rephrased to avoid confusion and
  instructions for building these components should be provided (maybe as
- a reference to the LFS book with some scripts). The specific parts are:
+ a reference to the LFS book with some scripts, or... cut a deal with
+ some super slim Linux distros). The specific parts are:

  * qemu-XXX-i386-wine.tar.gz, a wine build under the prefix /wine.
  * qemu-runtime-i386-XXX-.tar.gz, a glibc build.

-   [1]: https://www.qemu.org/docs/master/user/main.html
+   [1]: https://www.qemu.org/docs/master/user/main.html

  In addition, the documentation contains many other instances of
  inexistent "tar.gz" files, such as in "Network emulation". Most of these
  are inherited from the days of texi documentation more than 10 years
  ago, and they are so old that GitHub's blame have become unreliable.
  Someone really should run `fgrep -r 'tar.gz' doc' on the QEMU source
  tree.

  The issue was previously reported as [2], but nobody bother enough to
  google the filename to find out where the confused user got the idea
  from.

-   [2]: https://www.mail-archive.com/qemu-devel@nongnu.org/msg569174.html
+   [2]: https://www.mail-archive.com/qemu-devel@nongnu.org/msg569174.html

-- 
You received this bug notification because you are a member of qemu-
devel-ml, which is subscribed to QEMU.
https://bugs.launchpad.net/bugs/1884982

Title:
  User-emu documentation mentions inexistent "runtime" downloads

Status in QEMU:
  New

Bug description:
  The official documentation for the user-space emulator[1] contains
  many references to binary blobs no longer provided by  QEMU.org for
  download. The parts mentioning them should be rephrased to avoid
  confusion and instructions for building these components should be
  provided (maybe as a reference to the LFS book with some scripts,
  or... cut a deal with some super slim Linux distros). The specific
  parts are:

  * qemu-XXX-i386-wine.tar.gz, a wine build under the prefix /wine.
  * qemu-runtime-i386-XXX-.tar.gz, a glibc build.

    [1]: https://www.qemu.org/docs/master/user/main.html

  In addition, the documentation contains many other instances of
  inexistent "tar.gz" files, such as in "Network emulation". Most of
  these are inherited from the days of texi documentation more than 10
  years ago, and they are so old that GitHub's blame have become
  unreliable. Someone really should run `fgrep -r 'tar.gz' doc' on the
  QEMU source tree.

  The issue was previously reported as [2], but nobody bother enough to
  google the filename to find out where the confused user got the idea
  from.

    [2]: https://www.mail-archive.com/qemu-
  devel@nongnu.org/msg569174.html

To manage notifications about this bug go to:
https://bugs.launchpad.net/qemu/+bug/1884982/+subscriptions

^ permalink raw reply	[flat|nested] 4+ messages in thread