Re: More patches for the FAQ

[Alfred M. Szmidt]

How about the following instead?  I made some minor modifications here
and there, most notable is the OSKit information.  Frédéric, I hope I
spelt your name correctly.

Ognyan, your L4 changes will be commited soonish... Sorry for the
delay.

--- faq.en.in   07 Jan 2005 00:28:26 +0100      1.15
+++ faq.en.in   19 Jan 2005 13:02:08 +0100      
@@ -115,12 +115,14 @@ try it and help us get there.
 
 ??     Why is `/usr' a symbolic link to `.'?
 
-{MB} The distinction between `/' and `/usr' has historical reasons.
+{MB,FH} The distinction between `/' and `/usr' has historical reasons.
 Back when Unix systems were booted from two tapes, a small root tape
 and a big user tape.  Today, we like to use different partitions for
 these two spaces.  The Hurd throws this historical garbage away.  We
-think that we have found a more flexible solution called shadow
-filesystems.  Unfortunately, support for shadowed filesystems is not yet
-implemented.
+think that we have found a more flexible solution called union
+filesystems, which allow to create virtual filesystems which are the
+union of several other filesystems.  However, support for union
+filesystems is still in early development.
+
 ? Installation
 
@@ -301,14 +319,21 @@ about translators.
 
 ??     Where is the documentation?
 
-{NHW} There are neither man pages nor info nodes for the Hurd translators
-and commands.  Documentation lives inside of the binaries and can be
-found by passing the `--help' option to a given command.  For instance:
+{NHW,MM} There are neither man pages nor info nodes for the Hurd
+translators and commands.  Documentation lives inside of the binaries
+and can be found by passing the `--help' option to a given command.
+For instance:
 
        # /hurd/ext2fs --help
 
 will tell you what types of options the ext2fs translator accepts.
 
+The GNU/Hurd User's Guide and the GNU Hurd Reference Manual both
+provide some help about the usage of and concepts behind the GNU Hurd.
+You can find them, among others, at:
+
+       http://www.gnu.org/software/hurd/docs.html
+
 ??     What is a translator?
 
 {MB} There is a text about translators available at:
@@ -336,10 +361,19 @@ prompt.
 
 ??     How do I use non-US keyboard bindings?
 
-{NHW} Take a look at:
+{NHW,FH} Take a look at:
 
        http://www.xs4all.nl/~mgerards/xkb8.tar.gz
 
+If you want a debian package, you can add to your
+'etc/apt/sources.list'
+
+       deb http://debian.duckcorp.org/unstable/binary-hurd-i386/ ./
+
+and then run
+
+        apt-get install console-driver-xkb.
+
 ??     How do I enable color on the console?
 
 {NHW} If you are using the GNU Mach microkernel, you can set your
@@ -378,7 +412,9 @@ filesystem.
 
 ??     Why does `ps aux' give me strange output?
 
-{MB} Try `ps Aux'.
+{MB,MM} Try `ps Aux'.  Indeed, under GNU/Hurd, `ps aux' doesn't list
+all processes: it omits the session and group leaders, and the
+processes without parent.
 
 ??     I have a hung process that I want to kill, however, `ps' is now
        hanging too.
@@ -466,6 +502,17 @@ happens.  Thomas explains:
 
 If you can reproduce this error message, please report it.
 
+??     What does ``computer bought the farm'' mean ?
+
+{FH} This message is the text that corresponds to the errno code
+`EIEIO'.  Roland McGrath explains:
+
+       That message is not output by any particular servers at
+       particular times; rather it is the perror text for the errno
+       code EIEIO, which is returned by various RPCs and functions
+       for a variety of "hopeless" error conditions.
+
+
 ??     What does ``/dev/hd0s1: MOUNTED READ-ONLY; MUST USE `fsysopts
        --writable''' mean?
 
@@ -558,13 +605,17 @@ at:
 
 ??     What is OSKit-Mach?
 
-{NHW} There are two versions of Mach: GNU Mach and OSKit-Mach.  The
-former uses the drivers from Linux 2.0.x while the latter uses the
-University of Utah's OSKit.  If all goes well, OSKit-Mach will be
-stabilized and become the official kernel.  You can find out more about
-the OSKit at:
-
-       http://www.cs.utah.edu/flux/oskit
+{NHW,FH} There are two versions of GNU Mac that are in use: GNU Mach
+1.x and GNU Mach 2.x, formerly known as OSKit-Mach.  The former uses
+the drivers from Linux 2.0.x while the latter uses the University of
+Utah's OSKit library for drivers.  You can find out more about the
+OSKit library at:
+
+       http://www.cs.utah.edu/flux/oskit
+
+GNU Mach 2.x is usable, but some things are still missing or not
+working, like the serial port and scsi drivers.  This is why GNU Mach
+2.0 hasn't released yet and the two versions coexist.
 
 ??     Where is the documentation?
 
@@ -647,9 +698,11 @@ files like backups in the modified tree,
        # diff -x ChangeLog -Nurp hurd-orig hurd
 
 
-Answers were given by:
-* {NHW} Neal H Walfield  <address@hidden>
-* {MB} Marcus Brinkmann  <address@hidden>
-* {AMS} Alfred M. Szmidt <address@hidden>
+Answers were given by (in chronological order):
+* {NHW} Neal H Walfield         <address@hidden>
+* {MB} Marcus Brinkmann         <address@hidden>
+* {AMS} Alfred M. Szmidt <address@hidden>
+* {FH} Frédéric Henry   <address@hidden>
+* {MM} Manuel Menal     <address@hidden>
 
  vim:ts=8:sw=8:tw=72