Add a link to <http://lists.debian.org/debian-hurd/2007/09/msg00000.html> and apply some formatting foo.

1 files changed, 29 insertions, 14 deletions

diff --git a/Distrib/HurdOnQEMU.mdwn b/Distrib/HurdOnQEMU.mdwn
index 8fb78236..7f251b3f 100644
--- a/Distrib/HurdOnQEMU.mdwn
+++ b/Distrib/HurdOnQEMU.mdwn
@@ -1,14 +1,22 @@
-# <a name="Hurd_on_QEMU"> </a> Hurd on QEMU
+# Readily Available Images
 
-... by the way, there is available an already prepared [disk image with an installation of the Debian distribution of GNU/Hurd](http://www.numenor.art.pl/balrog/hurd/) for QEMU.
+(!) Note that these are unofficial images: they have been prepared by
+volunteers and may not have been tested extensively.
 
-## <a name="What_is_Needed"> What is Needed </a>
+* [Disk image](http://www.numenor.art.pl/balrog/hurd/) with an installation of
+  Debian GNU/Hurd.
+* [Announcement](http://lists.debian.org/debian-hurd/2007/09/msg00000.html) of
+  another image.
+
+
+# What is Needed
 
 1. First thing is to install [[QEMU]].
 2. A [grub](http://www.gnu.org/software/grub/) boot disk for the floppy disk image needed for booting. The [0\.97 version](ftp://alpha.gnu.org/gnu/grub/grub-0.97-i386-pc.ext2fs) works fine. I downloaded it an renamed to `floppy.img`.
 3. You will need a [Debian/Hurd installation CD](http://www.debian.org/ports/hurd/hurd-cd). K14 works fine.
 
-## <a name="Installing_Debian_Hurd_with_QEMU"> </a> Installing Debian/Hurd with QEMU
+
+# Installing Debian/Hurd with QEMU
 
 First off you will need to create a disk image using `qemu-img`. I have set mine to 2 gigabytes, although you should be able to get away with less.
 
@@ -24,7 +32,8 @@ Now run your image with floppy booting (`-boot a`) and finish the install (`./na
 
 **Important:** Older versions on gnumach needed that the `-M isapc` was passed to qemu. This is not needed anymore.
 
-## <a name="Mounting_Disk_Image_on_Host"> Mounting Disk Image on Host </a>
+
+# Mounting Disk Image on Host
 
 You may wish to mount your disk image on your host system to transfer files. To do this you will first need to find the offset of the partition you wish to mount.
 
@@ -41,7 +50,8 @@ Now take the number of sectors for the beginning of the partition and multiply i
 
     # mount -o loop,offset=32256 hd0.img /mnt/diskimage
 
-## <a name="Networking_in_QEMU"> </a> Networking in QEMU
+
+# Networking in QEMU
 
 If you just want to access the internet from within QEMU, you can setup pfinet for QEMU's user-networking:
 
@@ -53,14 +63,16 @@ Outgoing internet connections should just work then, although you might have to
 
 If you want to connect from the host system to the Hurd system running in QEMU, you need to setup something more advanced, like bridged networking.
 
-## <a name="Bridged_Networking"> Bridged Networking </a>
 
-### <a name="What_is_Needed"> What is Needed </a>
+## Bridged Networking
+
+### What is Needed
 
 1. Your Linux kernel will need 802.1d Ethernet Bridging support and TUN/TAP device driver support.
 2. You will need to install [bridge-utils](http://bridge.sourceforge.net).
 
-### <a name="Setting_Up_the_Host_Bridge"> Setting Up the Host Bridge </a>
+
+### Setting Up the Host Bridge
 
 You need to setup a bridge on the host first. This assumes `eth0` is down. I have modified my hosts network startup scripts to automatically setup a bridge, you may want to do this also.
 
@@ -70,7 +82,7 @@ You need to setup a bridge on the host first. This assumes `eth0` is down. I hav
 
 At this point you will need to setup `br0` as you would normally `eth0` (`dhcpcd br0` for example).
 
-### <a name="The_qemu_ifup_Script"> The qemu-ifup Script </a>
+### The qemu-ifup Script
 
 This script gets called when QEMU starts and will attach the tun device to the bridge. QEMU will look for this file at `/etc/qemu-ifup` and that is where I keep mine.
 
@@ -78,7 +90,8 @@ This script gets called when QEMU starts and will attach the tun device to the b
     sudo ifconfig $1 0.0.0.0 promisc up
     sudo brctl addif br0 $1
 
-### <a name="Setting_up_the_Network_in_the_Hu"> Setting up the Network in the Hurd </a>
+
+## Setting up the Network in the Hurd
 
 Now it is time to start-up your QEMU Hurd system and get networking going in there.
 
@@ -92,7 +105,8 @@ Once you have logged in as `root` run the `pfinet` translator with values that a
 
 That should do it! Do not forget to edit/update `/etc/resolv.conf` to get DNS working.
 
-## <a name="Related_Links"> Related Links </a>
+
+# Related Links
 
 These are links that users of [[HurdOnQEMU]] may find helpful.
 
@@ -100,9 +114,10 @@ These are links that users of [[HurdOnQEMU]] may find helpful.
 
 [[Hurd/QemuImageForL4]] - a QEMU image for the Hurd/L4 project.
 
-## <a name="TODO"> </a> TODO
 
-[[IRC]], 2007-07-04.
+# TODO
+
+[[IRC]], #hurd, 2007-07-04.
 
     <azeem-uni> so, is there a way to use a Debian GNU/Hurd partition (/dev/hda6) with qemu directly?
     <tschwinge> Don't dare to do that, please.