Merge branch 'master' of braunbox:~hurd-web/hurd-web

7 files changed, 90 insertions, 81 deletions

diff --git a/hurd/documentation/translator_primer.mdwn b/hurd/documentation/translator_primer.mdwn
index bbfb3649..35eab2fb 100644
--- a/hurd/documentation/translator_primer.mdwn
+++ b/hurd/documentation/translator_primer.mdwn
@@ -28,13 +28,11 @@ to enable you to easily try three of them:
 To try out the simplest of translators, you can go the following simple steps: 
 
 	$ touch hello
-	$ cat hello  
+	$ cat hello
 	$ settrans hello /hurd/hello  
 	$ cat hello  
 	"Hello World!"  
-	$ settrans -g hello  
-	$ cat hello  
-	$
+	
 	$ fsysopts hello
 	/hurd/hello --contents='Hello World!
 	'
@@ -42,22 +40,23 @@ To try out the simplest of translators, you can go the following simple steps:
 	> '
 	$ cat hello
 	Hello GNU!
-	$
-
-What you do with these steps is first verifying that the file "hello" is empty. 
+	
+	$ settrans -g hello  
+	$ cat hello  
+What you do with these steps is first creating the file "hello" and verifying that it is empty. 
 
-Then you setup the translator /hurd/hello in the file/node hello. 
+Then you setup the translator `/hurd/hello` in the file/node `hello`. 
 
-After that you check the contents of the file, and the translator returns "Hello World!". 
+After that, you check the contents of the file, and the translator returns "Hello World!". 
 
 Because you are a curious hacker, you wonder what filesystem options this node has.  It turns
 out that the hello translator uses a "contents" option.  We can change what the hello
-translator returns with another call to fsysopts.
+translator returns with another call to [[fsysopts]].
 
 To finish it,
 you remove the translator from the file "hello"
 (and tell any active running instances to go away)
-via "settrans -g hello".
+via "`settrans --g hello`", which is shorthand for "`settrans --goaway hello`"
 Having done that, verify that now the file is empty again.
 
 ### Transparent FTP
diff --git a/hurd/fsysopts.mdwn b/hurd/fsysopts.mdwn
index ff30f31d..bafe2bc9 100644
--- a/hurd/fsysopts.mdwn
+++ b/hurd/fsysopts.mdwn
@@ -8,7 +8,7 @@ Sections, no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license
 is included in the section entitled [[GNU Free Documentation
 License|/fdl]]."]]"""]]
 
-Get or set command line options for a running [[translator]].
+fsysopts, or <strong>F</strong>ile<strong>SYS</strong>tem<strong>OPT</strong>ions, Gets or sets command line options for a running [[translator]].
 
 See [[documentation/translators#manage]].
 
diff --git a/hurd/running/debian.mdwn b/hurd/running/debian.mdwn
index c52fbf75..b758fd52 100644
--- a/hurd/running/debian.mdwn
+++ b/hurd/running/debian.mdwn
@@ -1,8 +1,11 @@
 [[!meta title="Debian GNU/Hurd"]]
 
-# Debian Resources
-- Official page about the Debian GNU/Hurd port: [Debian GNU/Hurd](http://www.debian.org/ports/hurd/)
-- Debian [[FAQ]] — Frequently Asked Questions
+Debian GNU/Hurd is an effort to port the Debian distribution to the Hurd. Around 75% of Debian packages can already be run under Debian GNU/Hurd, which makes it very usable. See the [[Status]] of the Debian port for more information.
+
+<!-- I don't know what it means that /etc/mtab -> /proc/mounts, but this is what I could interpret.
+     It was simply a line (h1, for some reason, on this page and it looked out of place. Correct or even delete this if it makes no sense -->
+
+One noteable difference in this port, is that `/etc/mtab` -> `/proc/mounts`
 
 ## QEMU Image
 [[!inline pages=hurd/running/debian/qemu_image raw=yes feeds=no]]
@@ -17,23 +20,11 @@
   * [[Patch_submission]] — How to submit patches for build failures
 - [[Creating_image_tarball]]
 
-# Additional Information
-- [Presentation](http://people.debian.org/~mbanck/talks/hurd_lt2004/html/)
-  *Debian GNU/Hurd*, [[MichaelBanck]], LinuxTag 2004 Karlsruhe
-- [[Status]]
-- [Archive Qualification](http://wiki.debian.org/ArchiveQualification/hurd-i386)
-
-
-# `/etc/mtab` -> `/proc/mounts`
-
 ## IRC, freenode, #hurd, 2014-02-12
 
     <braunr> hm, there is something weird
-    <braunr> after successfully installing (with the new installer cd), and
-      rebooting, system init fails because fsck can't be run on /home (a
-      separate partition)
-    <braunr> it can't fsck because at that point, /home is already mounted, and
-      indeed the translator is running
+    <braunr> after successfully installing (with the new installer cd), and rebooting, system init fails because fsck can't be run on /home (a separate partition)
+    <braunr> it can't fsck because at that point, /home is already mounted, and indeed the translator is running
     <braunr> teythoon: any idea what might cause that ?
     <teythoon> me ?
     <teythoon> no
@@ -52,30 +43,24 @@
     <teythoon> i believe they dropped that
     <youpi> err, but something must be creating it for newer systems
     <teythoon> good point
-    <braunr> well, except for these small details, everything went pretty
-      smooth
+    <braunr> well, except for these small details, everything went pretty smooth
     <braunr> both on ide and ahci
     <youpi> it seems /etc/mtab gets created at boot
     <youpi> (on Linux I mean)
-    <teythoon> youpi: i cannot find the init script, but i'm sure that it was
-      there
+    <teythoon> youpi: i cannot find the init script, but i'm sure that it was there
     <youpi> I can't find it either on the installed system...
     <azeem> maybe pere or rleigh in #debian-hurd can help
 
 
 ## IRC, freenode, #hurd, 2014-02-13
 
-    <braunr>   6<--60(pid1698)->dir_lookup ("var/run/mtab" 4194305 0) = 0 3
-      "/run/mtab"  (null)
+    <braunr>   6<--60(pid1698)->dir_lookup ("var/run/mtab" 4194305 0) = 0 3 "/run/mtab"  (null)
     <braunr> looks like /etc/mtab isn't actually used anymore
     <teythoon> it never was on hurd
     <tomodach1> braunr: well it is generated i believe from mounted filesystems
-    <tomodach1> if its still around there is a reason for it, like posix
-      compatiblity perhaps?
-    <braunr> well the problem is that, as mentioned in pere's thread on
-      bug-hurd, some tools now expect /var/run/mtab instead of /etc/mtab
-    <braunr> and since nothing currently creates this file, these tools, such
-      as df, are lost
+    <tomodach1> if its still around there is a reason for it, like posix compatiblity perhaps?
+    <braunr> well the problem is that, as mentioned in pere's thread on bug-hurd, some tools now expect /var/run/mtab instead of /etc/mtab
+    <braunr> and since nothing currently creates this file, these tools, such as df, are lost
     <braunr> they can't find the info they're looking for
 
 
@@ -87,11 +72,14 @@
     <pere> yes.  I recommended fixing it in the hurd package. (BTS #737759)
     <braunr> yes i saw but was there any action taken ?
     <pere> did not check
-    <teythoon> i thought youpi mentioned that it is fixed in the libc and we
-      just need to rebuild coreutils or something
+    <teythoon> i thought youpi mentioned that it is fixed in the libc and we just need to rebuild coreutils or something
     <pere> yes
     <braunr> oh ok
     <braunr> but doesn't that mean it will use /etc/mtab ?
-    <pere> if I was a hurd porter, I would fix it in hurd while waiting for a
-      fix in coreutils, just to save people for wondering about the breakage,
-      but I am not the most patient of developers. :)
+    <pere> if I was a hurd porter, I would fix it in hurd while waiting for a fix in coreutils, just to save people for wondering about the breakage, but I am not the most patient of developers. :)
+
+# Externel
+* Official page about the Debian GNU/Hurd port: [Debian GNU/Hurd](http://www.debian.org/ports/hurd/)
+* Debian [[FAQ]] — Frequently Asked Questions
+* [Presentation](http://people.debian.org/~mbanck/talks/hurd_lt2004/html/) -Debian GNU/Hurd*, [[MichaelBanck]], LinuxTag 2004 Karlsruhe
+* [Archive Qualification](http://wiki.debian.org/ArchiveQualification/hurd-i386)
diff --git a/hurd/running/debian/qemu_image.mdwn b/hurd/running/debian/qemu_image.mdwn
index c25b76ab..fe1b7444 100644
--- a/hurd/running/debian/qemu_image.mdwn
+++ b/hurd/running/debian/qemu_image.mdwn
@@ -14,23 +14,50 @@ as <https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.ta
 
 Usage:
 
-* Install qemu-kvm via your distros packages.
-* Download the debian image
-    $ `wget https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.tar.gz`
-* Unpack it.
-    $ `tar -xz < debian-hurd.img.tar.gz`
-* Run it
-    $ `kvm -m 1G -drive cache=writeback,file=$(echo debian-hurd-*.img) -net user,hostfwd=tcp:127.0.0.1:2222-:22`
-    # Optionally use --curses to keep your keyboard layout. If need be modprobe kvm_amd, kvm intel and kvm to get kvm support (which is much, much faster).
+* Install qemu-kvm via your distribution's package manager (it might just be named qemu)
+
+* Download the debian image:
+
+<!-- Codeblocks nested in lists are garbage in Markdown. The only clean way to do this is by adding a comment after every list entry. Sorry about this!-->
+
+	$ wget https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.tar.gz
+
+* Unpack it:
+
+<!-- Yes, another comment. I can leave these empty but then again I can fill them. -->
+
+	$ tar -xz < debian-hurd.img.tar.gz
+
+* Run it:
+
+<!-- A world in which nobody washes their dishes is a dishtopia -->
+
+	$ kvm -m 1G -drive cache=writeback,file=$(echo debian-hurd-*.img) -net user,hostfwd=tcp:127.0.0.1:2222-:22
+
 * Login as root (the root password is empty)
-* set up a root password with passwd
+
+* Set up a root password with passwd
+
+Optionally you may use `--curses` to keep your keyboard layout. If need be modprobe kvm_amd, kvm intel and kvm to get kvm support (which is much, much faster).
+
+Note that if you do not have a command named `kvm`, you can try something across the lines of:
+
+	$ qemu-system-i386 --enable-kvm -drive cche=writeback,file=$(echo debian-hurd-*.img) -net user,hostfwd=tcp:127.0.0.1:2222-:22
+
+Or, if your machine does not allow for KVM acceleration, omit `--enable-kvm` from the command.
+
+
 
 Please also read the README file: <https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/README>
 
+<!-- It is unconventional, in wikis, to write external links like [...](http://...).
+     Usually a link to an external site should always be fully visible, but I think
+     people can understand where these lead, but revert if this is a bad idea.-->
+
 If you have troubles extracting the image, you can use
-the gz version <https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.gz>,
-the zip version <https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.zip>,
-or even the plain version <https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img> (5GiB!)
+the [gz version](https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.gz),
+the [zip version](https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.zip),
+or even the [plain version](https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img) (5GiB!)
 
 See the discussion about [[hurd/running/qemu/writeback_caching]].
 
diff --git a/hurd/running/distrib.mdwn b/hurd/running/distrib.mdwn
index 8c411fd0..357d840a 100644
--- a/hurd/running/distrib.mdwn
+++ b/hurd/running/distrib.mdwn
@@ -9,45 +9,41 @@ distributions in regard to ethical criteria.  Please visit
 <http://www.gnu.org/distros/free-system-distribution-guidelines.html> to learn
 what those standards are."""]]
 
-Working distributions of GNU/Hurd: 
+There are several GNU distributions that are built on the Hurd. If you develop a Hurd-based distro or know of one that isn't on this list yet, feel free to add it!
+
+###Working distributions of GNU/Hurd: 
 
 * [[Debian]]
 
-GNU/Hurd distributions in early stages of development: 
+###GNU/Hurd distributions in early stages of development: 
 
 * [[Arch|arch_hurd]] (features a LiveCD)
 * [[Nix]]
 
-Defunct GNU/Hurd distributions:
+###Defunct GNU/Hurd distributions:
 
   * Bee GNU/Hurd.  Castellano distribution, pkgsrc package based.
-  * [[GNU]]
   * Unofficial port to Gentoo and the portage system.  It was
     [announced](http://forums.gentoo.org/viewtopic.php?t=41939&amp;postdays=0&amp;postorder=asc&amp;start=0)
     March 17, 2003 in the Gentoo forums, but development stopped at some point.
 
-    IRC, freenode, #hurd, 2013-01-15:
+####IRC, freenode, #hurd, 2013-01-15:
 
         <WhiteKIBA> we are trying to revive Gentoo/hurd
         <WhiteKIBA> we are using debian as a start
-        <WhiteKIBA> we installed portage on debian and are now bootstrapping
-          the system into a folder
+        <WhiteKIBA> we installed portage on debian and are now bootstrapping the system into a folder
         <WhiteKIBA> except glibc everything seems fine 
-        <_d3f> braunr: http://wiki.rout0r.org/index.php/Gentoo/Hurd/en - if you
-          want to know more.
+        <_d3f> braunr: http://wiki.rout0r.org/index.php/Gentoo/Hurd/en - if you want to know more.
 
-    IRC, freenode, #hurd, 2013-02-01:
+####IRC, freenode, #hurd, 2013-02-01:
 
-        <WhiteKIBA> natsukao: http://wiki.rout0r.org/index.php/Gentoo/Hurd/en I
-          am working on it
-        <WhiteKIBA> if i can get glibc to compile correctly i can create a
-          stage3 but at the moment it fails
+        <WhiteKIBA> natsukao: http://wiki.rout0r.org/index.php/Gentoo/Hurd/en I am working on it
+        <WhiteKIBA> if i can get glibc to compile correctly i can create a stage3 but at the moment it fails
 
-    IRC, freenode, #hurd, 2013-02-02:
+####IRC, freenode, #hurd, 2013-02-02:
 
         <alexxy> WhiteKIBA: you may be interested in my try to run gentoo/hurd
-        <alexxy> WhiteKIBA:
-          http://omrb.pnpi.spb.ru/gitweb/?p=gentoo/hurd.git;a=summary
+        <alexxy> WhiteKIBA: http://omrb.pnpi.spb.ru/gitweb/?p=gentoo/hurd.git;a=summary
 
 
 # Using
@@ -72,7 +68,7 @@ about getting applications to work (if possible).
 </dl>
 
 
-# Misc.
+# External
 
-* [Ognyan Kulev Collection](http://debian.fmi.uni-sofia.bg/~ogi/hurd/links/index.html) of links (unsupported)
+* [Ognyan Kulev Collection](https://web.archive.org/web/20080513192630/http://www.bddebian.com/~wiki/) of links (unsupported)
 * [2000 Jim Franklin Collection](http://angg.twu.net/the_hurd_links.html) of links
diff --git a/hurd/running/gnu.mdwn b/hurd/running/gnu.mdwn
index 69a3210a..f6aada87 100644
--- a/hurd/running/gnu.mdwn
+++ b/hurd/running/gnu.mdwn
@@ -1,6 +1,6 @@
 # <a name="The_GNU_Operating_System"> </a> The GNU Operating System
 
-The GNU Operating System, or GNU System as it is more commonly known, will be a
+The GNU Operating System, Commonly referred to as simply "The GNU System", is a
 complete [[Unix]]-like operating system composed entirely of [free
 software](http://www.gnu.org/philosophy/free-sw.html).  The creation of the GNU
 System is one of the goals of the [GNU Project](http://www.gnu.org/), which was
@@ -15,7 +15,7 @@ including [[POSIX|https://en.wikipedia.org/wiki/POSIX]], modularity, and
 respecting user freedom.  Many of these goals are things that the GNU/Hurd can
 resolve, however the GNU/Hurd is not the most stable operating system yet.
 
-If you are looking for a production ready GNU system, then Debian GNU/Hurd may
+If you are looking for a production ready GNU system, then [[hurd/running/Debian]] GNU/Hurd may
 not be the best choice for you.  Debian GNU/Hurd currently lacks 64-bit support,
 many device drivers, sound support, SMP, and a few other essential bits that
 provide a flexible operating system.
diff --git a/hurd/what_is_the_gnu_hurd.mdwn b/hurd/what_is_the_gnu_hurd.mdwn
index 7a7f3d43..8315bfff 100644
--- a/hurd/what_is_the_gnu_hurd.mdwn
+++ b/hurd/what_is_the_gnu_hurd.mdwn
@@ -11,8 +11,7 @@ License|/fdl]]."]]"""]]
 
 [[!meta title="What Is the GNU Hurd?"]]
 
-The Hurd is the GNU project's replacement for [[UNIX]], a popular operating
-system [[kernel]].
+The Hurd is the GNU project's replacement for the [[UNIX]] system's [[kernel]].
 
 The Hurd is firstly a collection of protocols formalizing how different
 components may interact.  The protocols are designed to reduce the mutual