[Qemu-devel] [PATCH] [STABLE] Update documentation for OpenHackWare

[Qemu-devel] [PATCH] [STABLE] Update documentation for OpenHackWare

[Stefan Weil]

[-- Attachment #1: Type: text/plain, Size: 295 bytes --]

Hello,

the QEMU documentation contains broken links for
OpenHackWare (OHW).

This patch removes them (there are no new links)
and marks OHW as old and no longer supported.

Bad links might also be fixed in stable - the patch
can be applied to trunk and to the stable branch.

Regards
Stefan




[-- Attachment #2: ohw.patch --]
[-- Type: text/x-diff, Size: 1668 bytes --]

Remove broken links for OHW and try to update the OHW documentation.

Signed-off-by: Stefan Weil <weil@mail.berlios.de>

Index: trunk/pc-bios/README
===================================================================
--- trunk.orig/pc-bios/README	2009-03-31 18:13:25.000000000 +0200
+++ trunk/pc-bios/README	2009-03-31 18:14:07.000000000 +0200
@@ -32,7 +32,7 @@
   git://git.kernel.org/pub/scm/virt/vgabios/vgabios.git
 
 - The PowerPC Open Hack'Ware Open Firmware Compatible BIOS is
-  available at http://perso.magic.fr/l_indien/OpenHackWare/index.htm.
+  no longer supported and will be removed in the future.
 
 - video.x is a PowerMac NDRV compatible driver for a VGA frame
   buffer. It comes from the Mac-on-Linux project
Index: trunk/qemu-doc.texi
===================================================================
--- trunk.orig/qemu-doc.texi	2009-03-31 18:18:25.000000000 +0200
+++ trunk/qemu-doc.texi	2009-03-31 18:18:30.000000000 +0200
@@ -1654,8 +1654,9 @@
 PC compatible keyboard and mouse.
 @end itemize
 
-QEMU uses the Open Hack'Ware Open Firmware Compatible BIOS available at
-@url{http://perso.magic.fr/l_indien/OpenHackWare/index.htm}.
+Earlier versions of QEMU used the Open Hack'Ware Open Firmware Compatible BIOS.
+It is still provided for compatiblity reasons (PREP platform),
+but it is no longer supported.
 
 Since version 0.9.1, QEMU uses OpenBIOS @url{http://www.openbios.org/}
 for the g3beige and mac99 PowerMac machines. OpenBIOS is a free (GPL
@@ -1689,9 +1690,6 @@
 @c man end
 
 
-More information is available at
-@url{http://perso.magic.fr/l_indien/qemu-ppc/}.
-
 @node Sparc32 System emulator
 @section Sparc32 System emulator
 

[Qemu-devel] [PATCH] doc: Remove old URL for Open Hack'Ware.

[Stefan Weil]

The URL http://perso.magic.fr/l_indien/ no longer exists.

Signed-off-by: Stefan Weil <weil@mail.berlios.de>
---
 pc-bios/README |    3 ---
 qemu-doc.texi  |    8 --------
 2 files changed, 0 insertions(+), 11 deletions(-)

diff --git a/pc-bios/README b/pc-bios/README
index 162dfe8..2877a51 100644
--- a/pc-bios/README
+++ b/pc-bios/README
@@ -31,9 +31,6 @@
   repo that HEAD refers to is located at
   git://git.kernel.org/pub/scm/virt/vgabios/vgabios.git
 
-- The PowerPC Open Hack'Ware Open Firmware Compatible BIOS is
-  available at http://perso.magic.fr/l_indien/OpenHackWare/index.htm.
-
 - video.x is a PowerMac NDRV compatible driver for a VGA frame
   buffer. It comes from the Mac-on-Linux project
   (http://www.maconlinux.org/).
diff --git a/qemu-doc.texi b/qemu-doc.texi
index 6eed6ef..c52361f 100644
--- a/qemu-doc.texi
+++ b/qemu-doc.texi
@@ -1311,9 +1311,6 @@ PREP Non Volatile RAM
 PC compatible keyboard and mouse.
 @end itemize
 
-QEMU uses the Open Hack'Ware Open Firmware Compatible BIOS available at
-@url{http://perso.magic.fr/l_indien/OpenHackWare/index.htm}.
-
 Since version 0.9.1, QEMU uses OpenBIOS @url{http://www.openbios.org/}
 for the g3beige and mac99 PowerMac machines. OpenBIOS is a free (GPL
 v2) portable firmware implementation. The goal is to implement a 100%
@@ -1339,16 +1336,11 @@ qemu-system-ppc -prom-env 'auto-boot?=false' \
  -prom-env 'boot-args=conf=hd:2,\yaboot.conf'
 @end example
 
-These variables are not used by Open Hack'Ware.
-
 @end table
 
 @c man end
 
 
-More information is available at
-@url{http://perso.magic.fr/l_indien/qemu-ppc/}.
-
 @node Sparc32 System emulator
 @section Sparc32 System emulator
 
-- 
1.5.6.5

Re: [Qemu-devel] [PATCH] doc: Remove old URL for Open Hack'Ware.

[Blue Swirl]

On 6/6/09, Stefan Weil <weil@mail.berlios.de> wrote:
> The URL http://perso.magic.fr/l_indien/ no longer exists.
>
>  Signed-off-by: Stefan Weil <weil@mail.berlios.de>

Removing only the references would mean that we'd have mysterious
binaries without any explanation in pc-bios. We should also delete
ppc_rom.bin, ohw.diff and support for loading OHW but that would make
PREP machine untestable.

Re: [Qemu-devel] [PATCH] doc: Remove old URL for Open Hack'Ware.

[Stefan Weil]

Blue Swirl schrieb:
> On 6/6/09, Stefan Weil <weil@mail.berlios.de> wrote:
>> The URL http://perso.magic.fr/l_indien/ no longer exists.
>>
>> Signed-off-by: Stefan Weil <weil@mail.berlios.de>
>
> Removing only the references would mean that we'd have mysterious
> binaries without any explanation in pc-bios. We should also delete
> ppc_rom.bin, ohw.diff and support for loading OHW but that would make
> PREP machine untestable.

For insiders, there is nothing mysterious because they know
the history.

For other people, a URL which is invalid does not help,
so the binaries are already mysterious today.
I did not find any valid URL with the sources.

Maybe the QEMU maintainers can add a git submodule
containing the OHW sources from Debian's package
openhackware?

This was the latest contribution to the previous discussion:

http://lists.gnu.org/archive/html/qemu-devel/2009-04/msg00312.html

I came to the conclusion that PREP support is still wanted,
so the binaries should remain part of QEMU.

Stefan

Re: [Qemu-devel] [PATCH] doc: Remove old URL for Open Hack'Ware.

[Blue Swirl]

On 6/6/09, Stefan Weil <weil@mail.berlios.de> wrote:
> Blue Swirl schrieb:
>
> > On 6/6/09, Stefan Weil <weil@mail.berlios.de> wrote:
>  >> The URL http://perso.magic.fr/l_indien/ no longer exists.
>  >>
>  >> Signed-off-by: Stefan Weil <weil@mail.berlios.de>
>  >
>  > Removing only the references would mean that we'd have mysterious
>  > binaries without any explanation in pc-bios. We should also delete
>  > ppc_rom.bin, ohw.diff and support for loading OHW but that would make
>  > PREP machine untestable.
>
>
> For insiders, there is nothing mysterious because they know
>  the history.
>
>  For other people, a URL which is invalid does not help,
>  so the binaries are already mysterious today.
>  I did not find any valid URL with the sources.
>
>  Maybe the QEMU maintainers can add a git submodule
>  containing the OHW sources from Debian's package
>  openhackware?

http://www.openfirmware.info also contains a few open source
OpenFirmware implementations, perhaps OHW could be archived there.

>  This was the latest contribution to the previous discussion:
>
>  http://lists.gnu.org/archive/html/qemu-devel/2009-04/msg00312.html
>
>  I came to the conclusion that PREP support is still wanted,
>  so the binaries should remain part of QEMU.

IMHO for PREP to remain in working condition, OpenBIOS should be
ported to it, otherwise we can't change anything.

Re: [Qemu-devel] [PATCH] doc: Remove old URL for Open Hack'Ware.

[Paul Brook]

> >  Maybe the QEMU maintainers can add a git submodule
> >  containing the OHW sources from Debian's package
> >  openhackware?

I'm tempted to remove OHW, and whoever cares about PREP emulation can make 
OpenBIOS work. I admit I don't really know how much effort this would take, 
but I'd be surprised if it's all that hard.

> http://www.openfirmware.info also contains a few open source
> OpenFirmware implementations, perhaps OHW could be archived there.

IIUC calling OHW an OpenFirmware implementation is a bit of a stretch. It 
implements the bare minimum required to boot certain ppc-linux kernels.

Paul

Re: [Qemu-devel] [PATCH] doc: Remove old URL for Open Hack'Ware.

[Andreas Färber]

Am 06.06.2009 um 17:50 schrieb Stefan Weil:

> Maybe the QEMU maintainers can add a git submodule
> containing the OHW sources from Debian's package
> openhackware?

You are right that it would be better to have full sourcecode around  
than a patch against a vanished tarball. But including sources from  
Debian's package inside QEMU would probably be a lie too since the  
binary blob contains changes not part of QEMU's patch or the last  
official tarball.

If there is continued interest in OHW, you could set up its own  
external Git repository as for kqemu.

Andreas