Skip to contentSkip to conversation

Update documentation for OpenHackWare

PATCH New Stefan Weil 4 participants 7 messages Mar 31, 2009 – Jun 6, 2009

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Update documentation for OpenHackWare

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

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

pc-bios/README +1 -1
Index: trunk/pc-bios/README
===================================================================
@@ -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
qemu-doc.texi +3 -5
Index: trunk/qemu-doc.texi
===================================================================
@@ -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
 
#1 lore raw

PATCH 1/1 doc: Remove old URL for Open Hack'Ware.

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

---
 pc-bios/README |    3 ---
 qemu-doc.texi  |    8 --------
 2 files changed, 0 insertions(+), 11 deletions(-)
pc-bios/README +0 -3
index 162dfe8..2877a51 100644
@@ -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/).
qemu-doc.texi +0 -8
index 6eed6ef..c52361f 100644
@@ -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
 
Signature · 1 line
1.5.6.5
#2 lore raw

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

Quoted 3 lines · Stefan Weil

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

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.

#3 lore raw

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

Quoted 9 lines · Blue Swirl
Quoted 3 lines · Stefan Weil

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

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

#4 lore raw

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

Quoted 16 lines · Stefan Weil
Quoted 9 lines · Blue Swirl
Quoted 3 lines · Stefan Weil

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

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.

Quoted 7 lines

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.

Quoted 6 lines

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.

#5 lore raw

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

Quoted 3 lines
Quoted 3 lines

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.

Quoted 2 lines

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

#6 lore raw

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

In reply to Stefan Weil

Am 06.06.2009 um 17:50 schrieb Stefan Weil:

Quoted 3 lines

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