Merge branch 'master' of arnebab@flubber:~wiki/wiki

21 files changed, 305 insertions, 94 deletions

diff --git a/contributing.mdwn b/contributing.mdwn
index 6f2064e9..bad6463f 100644
--- a/contributing.mdwn
+++ b/contributing.mdwn
@@ -1,4 +1,5 @@
-[[meta copyright="Copyright © 2006, 2007, 2008 Free Software Foundation, Inc."]]
+[[meta copyright="Copyright © 2006, 2007, 2008 Free Software Foundation,
+Inc."]]
 
 [[meta license="""[[toggle id="license" text="GFDL 1.2+"]][[toggleable
 id="license" text="Permission is granted to copy, distribute and/or modify this
@@ -14,12 +15,17 @@ Welcome!  Every single contribution is very much encouraged!
 
 There are various ways of contributing, read on about contributing to...
 
-# These wiki pages
+[[!toc levels=3]]
+
+
+# Documentation
+
+## These Wiki Pages
 
 Please read about [[how_to_contribute_to_this_wiki|wiki]].
 
 
-# The system itself
+# The System Itself
 
 There are essential two kinds of Hurd system designs.
 
@@ -51,11 +57,41 @@ on the skills you have and the resources you intend to invest.
 
 Please spend some time with thinking about the items in this [[questionnaire]].
 
+Before you can significantly contribute, take some time to learn about the
+system, e.g., [[microkernels_for_beginners|microkernel/for_beginners]].  Until
+you can do the basic exercises listed there, you won't be able to significantly
+contribute to the Hurd.
+
 For more reading resources, please see this whole wiki, and also
 <http://www.gnu.org/software/hurd/devel.html>,
 <http://www.gnu.org/software/hurd/docs.html> for links to a bunch of documents,
 and <http://www.gnu.org/software/hurd/> in general.
 
+### Porting Packages
+
+Debian is currently the Hurd distribution of choice among Hurd users and
+developers.
+
+Here is a
+[[list_of_Debian_packages_that_need_porting|hurd/running/debian/porting]].
+
+You can also just [[install_Debian_GNU/Hurd|hurd/running/debian]] and find what
+doesn't work or suit you and try to improve that.
+
+### Open Issues: GNU Hurd
+
+Here is a [[list_of_open_issues|hurd/Open_Issues]] for the [[GNU_Hurd|hurd]].
+
+### Open Issues: GNU Mach
+
+Here is a [[list_of_open_issues|microkernel/mach/gnumach/Open_Issues]] for
+[[GNU_Mach|microkernel/mach/gnumach]].
+
+### Open Issues: GNU MIG
+
+Here is a [[list_of_open_issues|microkernel/mach/mig/Open_Issues]] for
+[[GNU_MIG|microkernel/mach/mig]].
+
 
 <a name="hurd_on_modern_microkernel"> </a>
 ## Hurd on a modern microkernel
diff --git a/hurd.mdwn b/hurd.mdwn
index 8392abef..6f6aae4f 100644
--- a/hurd.mdwn
+++ b/hurd.mdwn
@@ -55,6 +55,8 @@
 * [[Building]]
   * [[building/Cross-Compiling]]
 
+* [[Open_Issues]]
+
 # Developer References
 
 * [[Rules]]
diff --git a/hurd/contributing.mdwn b/hurd/contributing.mdwn
deleted file mode 100644
index f083b9b8..00000000
--- a/hurd/contributing.mdwn
+++ /dev/null
@@ -1,48 +0,0 @@
-[[meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]]
-
-[[meta license="""[[toggle id="license" text="GFDL 1.2+"]][[toggleable
-id="license" text="Permission is granted to copy, distribute and/or modify this
-document under the terms of the GNU Free Documentation License, Version 1.2 or
-any later version published by the Free Software Foundation; with no Invariant
-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]]."]]"""]]
-
-# Porting Applications
-
-Debian is currently the Hurd distribution of choice among Hurd
-users and developers.  Approximately half of the Debian archive
-has been compiled successfully on the Hurd, however, many
-programs fail to build for various reasons.  A [list of build 
-failures including error messages](http://unstable.buildd.net/buildd/hurd-i386_Failed.html)
-can be found, as well as a [preliminary analysis](http://lists.debian.org/debian-hurd/2007/07/msg00000.html)
-of them. If you want to port any of these, file patches in the 
-[Alioth patch tracker](http://alioth.debian.org/tracker/?atid=410472&group_id=30628&func=browse)
- for review. It might be a good idea to record your intention 
-to port something in the [Alioth task tracker](http://alioth.debian.org/pm/task.php?group_project_id=34&group_id=30628&func=browse) so other people do not do duplicated work. You can also just 
-install the Hurd and find what doesn't work for you and port 
-it and then file patches for that package in [above patch tracker](http://alioth.debian.org/tracker/?atid=410472&group_id=30628&func=browse).
-Another important task is making sure that patches go upstream as 
-well, especially for GNU projects.
-
-If you want to further development, a list of interesting 
-projects is available in the [Alioth task tracker](http://alioth.debian.org/pm/task.php?group_project_id=35&group_id=30628&func=browse).
-Those projects are not necessarily Debian specific, but do
-not touch the Hurd proper.
-
-# Hurd Proper
-
-If you are interested in developping the Hurd proper, there is
-plenty of work to do.  Before you can significantly contribute,
-take some time to learn about the system, e.g.,
-[[microkernels_for_beginners|microkernel/for_beginners]].  Until you can do the basic exercises
-listed there, you won't be able to significantly contribute to
-the Hurd.
-
-See the [[ToDo]].
-
-# GNU Mach
-
-[[GNU_Mach|microkernel/mach/gnumach]] is the underlying microkernel used by the
-Hurd.  It has a number of deficencies;
-[[microkernel/mach/gnumach/projects]].
diff --git a/hurd/open_issues.mdwn b/hurd/open_issues.mdwn
new file mode 100644
index 00000000..d7dc4d99
--- /dev/null
+++ b/hurd/open_issues.mdwn
@@ -0,0 +1,19 @@
+[[meta copyright="Copyright © 2008 Free Software Foundation, Inc."]]
+
+[[meta license="""[[toggle id="license" text="GFDL 1.2+"]][[toggleable
+id="license" text="Permission is granted to copy, distribute and/or modify this
+document under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no Invariant
+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]]."]]"""]]
+
+[[meta title="Open Issues"]]
+
+This is a dumping ground for open issues for the GNU Hurd.
+
+[[inline
+pages="hurd/open_issues/* and !*/discussion"
+show=0
+actions=yes
+rootpage="hurd/open_issues" postformtext="Add a new item titled:"]]
diff --git a/hurd/open_issues/cvs_tasks_file.mdwn b/hurd/open_issues/cvs_tasks_file.mdwn
new file mode 100644
index 00000000..9a053e33
--- /dev/null
+++ b/hurd/open_issues/cvs_tasks_file.mdwn
@@ -0,0 +1,14 @@
+[[meta copyright="Copyright © 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free
+Software Foundation, Inc."]]
+
+[[meta license="""[[toggle id="license" text="GFDL 1.2+"]][[toggleable
+id="license" text="Permission is granted to copy, distribute and/or modify this
+document under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no Invariant
+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]]."]]"""]]
+
+The canonical [tasks
+file](http://savannah.gnu.org/cgi-bin/viewcvs/~checkout~/hurd/hurd/tasks?rev=HEAD&content-type=text/plain)
+from the CVS archive.
diff --git a/hurd/open_issues/cvs_todo_file.mdwn b/hurd/open_issues/cvs_todo_file.mdwn
new file mode 100644
index 00000000..958502e1
--- /dev/null
+++ b/hurd/open_issues/cvs_todo_file.mdwn
@@ -0,0 +1,14 @@
+[[meta copyright="Copyright © 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free
+Software Foundation, Inc."]]
+
+[[meta license="""[[toggle id="license" text="GFDL 1.2+"]][[toggleable
+id="license" text="Permission is granted to copy, distribute and/or modify this
+document under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no Invariant
+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]]."]]"""]]
+
+The canonical [TODO
+file](http://savannah.gnu.org/cgi-bin/viewcvs/~checkout~/hurd/hurd/TODO?rev=HEAD&content-type=text/plain)
+from the CVS archive.
diff --git a/hurd/open_issues/libfshelp_in_hurdlibs.mdwn b/hurd/open_issues/libfshelp_in_hurdlibs.mdwn
new file mode 100644
index 00000000..7717cef8
--- /dev/null
+++ b/hurd/open_issues/libfshelp_in_hurdlibs.mdwn
@@ -0,0 +1,12 @@
+[[meta copyright="Copyright © 2008 Free Software Foundation, Inc."]]
+
+[[meta license="""[[toggle id="license" text="GFDL 1.2+"]][[toggleable
+id="license" text="Permission is granted to copy, distribute and/or modify this
+document under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no Invariant
+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]]."]]"""]]
+
+[[libtrivfs]] seems to use [[libfshelp]], but doesn't have it listed in
+`HURDLIBS`.  Should change that?  Same for [[libnetfs]] and [[libdiskfs]]?
diff --git a/hurd/todo.mdwn b/hurd/open_issues/some_todo_list.mdwn
index 2d65f0c8..d9aab4d1 100644
--- a/hurd/todo.mdwn
+++ b/hurd/open_issues/some_todo_list.mdwn
@@ -1,13 +1,17 @@
-For how best to contribte, see [[contributing]].
+[[meta copyright="Copyright © 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free
+Software Foundation, Inc."]]
+
+[[meta license="""[[toggle id="license" text="GFDL 1.2+"]][[toggleable
+id="license" text="Permission is granted to copy, distribute and/or modify this
+document under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no Invariant
+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]]."]]"""]]
 
 This todo is primarily targetted at the Hurd proper
 and applications that rely on the Hurd interfaces.
 
-The canonical TODOs from the CVS archive:
-
-* [TODO file](http://savannah.gnu.org/cgi-bin/viewcvs/~checkout~/hurd/hurd/TODO?rev=HEAD&content-type=text/plain)
-* [Task file](http://savannah.gnu.org/cgi-bin/viewcvs/~checkout~/hurd/hurd/tasks?rev=HEAD&content-type=text/plain)
-
 * psmisc
 
 The tools provided by the psmisc package are linux centric. Killall and pstree, for instance, require Linux's proc file system but could just as easily use Hurd's libps.
diff --git a/hurd/open_issues/wrong_reply_message_id.mdwn b/hurd/open_issues/wrong_reply_message_id.mdwn
new file mode 100644
index 00000000..d9db996c
--- /dev/null
+++ b/hurd/open_issues/wrong_reply_message_id.mdwn
@@ -0,0 +1,15 @@
+[[meta copyright="Copyright © 2008 Free Software Foundation, Inc."]]
+
+[[meta license="""[[toggle id="license" text="GFDL 1.2+"]][[toggleable
+id="license" text="Permission is granted to copy, distribute and/or modify this
+document under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no Invariant
+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]]."]]"""]]
+
+    <tschwinge> # settrans -P -a /servers/socket/2 /hurd/pfinet -i eth0 -a 192.168.10.61 -g 192.168.10.1 -m 255.255.255.0
+    <tschwinge> Translator pid: 2289
+    <tschwinge> Pausing...
+    <tschwinge> pfinet: /build/buildd/hurd-20080607/build-tree/hurd/libports/create-internal.c:115: _ports_create_port_internal: Unexpected error: (ipc/mig) wrong reply message ID.
+    <neal> it would be nice to print out the id when those sorts of errors occur.
diff --git a/hurd/running/debian/patch_submission.mdwn b/hurd/running/debian/patch_submission.mdwn
index 0fd73b7b..0a1bfb3f 100644
--- a/hurd/running/debian/patch_submission.mdwn
+++ b/hurd/running/debian/patch_submission.mdwn
@@ -8,29 +8,48 @@ 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]]."]]"""]]
 
-If you fixed a Debian package which FTBFS (fails to build from source), you should submit the patch so that all users can profit from your work.
-
-If it is not a Debian-specific patch, you should strongly consider submitting the patch upstream for inclusion.  This applies even more so if it is a GNU package, or otherwise frequently used package, or you know upstream anyway.
-
-If you had to change the code considerably and are not 100% sure you did not introduce a regression, or are not very experienced with these kinds of code changes, you should first submit your patch for review to the [Debian alioth patch tracker](http://alioth.debian.org/tracker/?atid=410472&group_id=30628&func=browse). 
-
-If the patch is trivial, or one of the Debian porters approved your patch for submission, submit the patch to the Debian BTS (bug tracking system).  You can either use the reportbug tool, or just simple mail.  In any case, you should follow these guidelines:
-
- 
- * The submission address is <submit@bugs.debian.org>
- * Subject/Bug title should be "(source-package): FTBFS on hurd-i386: (reason)"
- * "Severity:" should be "important", **not "serious"**
- * "Version:" should be the version of the source package in unstable
- * Add "Tags: patch"
- * Add "User: debian-hurd@lists.debian.org"
- * Add "Usertags: hurd"
-
-In the bug description, mention that the package fails to build on hurd-i386 and (if possible) quote the failure.  If possible, point to the failing build log from <http://buildd.debian-ports.org/build.php>.
-
-Then, explain the failure (Debian maintainers usually do not know much about Hurd-specific failures), and attach the patch.
+If you fixed a Debian package which *FTBFS* (fails to build from source), you
+should submit the patch so that all users can profit from your work.
+
+If it is not a Debian-specific patch, you should strongly consider submitting
+the patch upstream for inclusion.  This applies even more so if it is a GNU
+package, or otherwise frequently used package, or you know upstream anyway.
+
+If you had to change the code considerably and are not 100% sure you did not
+introduce a regression, or are not very experienced with these kinds of code
+changes, you should first submit your patch for review to the [Debian alioth
+patch
+tracker](http://alioth.debian.org/tracker/?atid=410472&group_id=30628&func=browse).
+
+If the patch is trivial, or one of the Debian porters approved your patch for
+submission, submit the patch to the Debian BTS (bug tracking system).  You can
+either use the reportbug tool, or just simple mail.  In any case, you should
+follow these guidelines:
+
+  * The submission address is <submit@bugs.debian.org>.
+  * The mail's subject (which will become the bug's title) should be
+    `SOURCE-PACKAGE: FTBFS on hurd-i386: REASON`.
+  * The first lines of the mail's body (the so-called *pseudo-header*):
+      * `Severity: important` -- not *serious*.
+      * `Version: VERSION` -- the version of the source package in unstable.
+      * `Tags: patch` -- as/if you include a ready-to-be-applied patch.
+      * `User: debian-hurd@lists.debian.org`
+      * `Usertags: hurd`
+
+In the bug description, mention that the package fails to build on hurd-i386
+and (if possible) quote the failure.  If possible, point to the failing build
+log from <http://buildd.debian-ports.org/build.php> or elsewhere.
+
+Then, explain the failure (Debian maintainers usually do not know much about
+Hurd-specific failures), and attach the patch.
 
 The patch should be in unidiff form.
 
-If the package uses a patch system, it is preferable to submit the patch in a ready to use form (e.g. as a dpatch), but this is not required. Also, try to keep the patch small, e.g. do not submit a 100k autotools diff for a one-line change in configure.in or a Makefile.am, but in this case mention that autotools need to be rerun and let the maintainer choose (you can suggest you would file a complete diff if the maintainer prefers)
+If the package uses a patch system, it is preferable to submit the patch in a
+ready-to-use form (e.g. as a *dpatch*), but this is not required.  Also, try to
+keep the patch small, e.g., do not submit a 100 KiB autotools diff for a
+one-line change in `configure.in` or a `Makefile.am`, but in this case mention
+that autotools need to be rerun and let the maintainer choose (you can suggest
+you would file a complete diff if the maintainer prefers).
 
 Last but not least, try to be courteous.
diff --git a/hurd/running/debian/porting.mdwn b/hurd/running/debian/porting.mdwn
index 16f39427..7ca91d37 100644
--- a/hurd/running/debian/porting.mdwn
+++ b/hurd/running/debian/porting.mdwn
@@ -1,4 +1,4 @@
-[[meta copyright="Copyright © 2008 Free Software Foundation, Inc."]]
+[[meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]]
 
 [[meta license="""[[toggle id="license" text="GFDL 1.2+"]][[toggleable
 id="license" text="Permission is granted to copy, distribute and/or modify this
@@ -10,11 +10,22 @@ is included in the section entitled
 
 [[meta title="Debian packages that need porting"]]
 
-A large amount of Debian source packages can (by now) simple be built for
-Debian GNU/Hurd systems.
+Approximately half of the Debian archive has been compiled successfully on the
+Hurd, however, many programs fail to build for various reasons.
 
-Here are listed some of those (the important ones, as they're, e.g., blocking
-other packages from being built) that need someone to work on them.
+A [list of build failures including error
+messages](http://unstable.buildd.net/buildd/hurd-i386_Failed.html) can be
+found, as well as a [preliminary
+analysis](http://lists.debian.org/debian-hurd/2007/07/msg00000.html) of them.
+
+It might be a good idea to record your intention to port something either in
+the list below or in the [Alioth task
+tracker](http://alioth.debian.org/pm/task.php?group_project_id=34&group_id=30628&func=browse)
+so other people do not do duplicated work.
+
+Aside from the Alioth task tracker, here is a list of some packages (the
+important ones, as they're, e.g., blocking other packages from being built)
+that need someone to work on them.
 
 When you have a patch to submit, please adhere to the [[patch_submission]]
 guidelines.
diff --git a/hurd/running/debian/porting/gcc.mdwn b/hurd/running/debian/porting/gcc.mdwn
new file mode 100644
index 00000000..12982253
--- /dev/null
+++ b/hurd/running/debian/porting/gcc.mdwn
@@ -0,0 +1,50 @@
+[[meta copyright="Copyright © 2008 Free Software Foundation, Inc."]]
+
+[[meta license="""[[toggle id="license" text="GFDL 1.2+"]][[toggleable
+id="license" text="Permission is granted to copy, distribute and/or modify this
+document under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no Invariant
+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]]."]]"""]]
+
+For GCC trunk:
+
+Debian package has patches (for 4.3).  Some have been forwarded upstream.  (And
+have been ignored.)  [[Thomas_Schwinge|tschwinge]] is working on getting them
+integrated.
+
+  * [\[meta-bug\] bootstrap bugs for
+    \*-gnu\*](http://gcc.gnu.org/bugzilla/show_bug.cgi?id=21824)
+
+      * [\[4.2/4.3/4.4 Regression\] GNU Hurd bootstrap error: 'OPTION\_GLIBC'
+        undeclared](http://gcc.gnu.org/bugzilla/show_bug.cgi?id=28102)
+
+          * [Tool chain configuration: GNU/\* sharing stuff with
+            GNU/Linux](http://gcc.gnu.org/ml/gcc/2007-11/msg00289.html)
+
+          * [\[PATCH\] GNU/Hurd target
+            configuration](http://gcc.gnu.org/ml/gcc-patches/2008-10/msg00344.html)
+
+  * [build system: gcc\_cv\_libc\_provides\_ssp and
+    NATIVE\_SYSTEM\_HEADER\_DIR](http://gcc.gnu.org/ml/gcc/2008-10/msg00130.html)
+
+      * [-fstack-protector shouldn't use TLS in freestanding
+        mode](http://gcc.gnu.org/bugzilla/show_bug.cgi?id=29838)
+
+  * [Port libgcc's configury for
+    \*-\*-gnu\*](http://gcc.gnu.org/ml/gcc-patches/2008-10/msg00315.html)
+
+
+Additionally:
+
+  * `libgcc/configure.ac` [might
+    need](http://gcc.gnu.org/ml/gcc-patches/2008-10/msg00315.html) to be
+    aligned for us to the `*linux*` cases.  As well as at the end of
+    `libgcc/config.host`.  Check.
+
+        checking whether decimal floating point is supported... no
+        checking whether fixed-point is supported... no
+
+  * Also in other places: configure fragments that have `*linux*` cases
+    might/should often contain those for us (and GNU/k*BSD) as well.
diff --git a/index.mdwn b/index.mdwn
index 9c3a1398..7587785d 100644
--- a/index.mdwn
+++ b/index.mdwn
@@ -32,10 +32,10 @@ package from Debian experimental fixed this for me.  -->
 To help the Hurd you can for example (from high level stuff to the inner core)
 
 * [[Contribute_to_this_wiki|contributing/wiki]],
-* <a href="#run">Run a GNU/Hurd system</a>, and help others get their Hurds running, 
-* [[Port_applications|hurd/contributing]] to work in Hurd, 
+* [[Run_a_GNU/Hurd_system|index#run]], and help others get their systems running, 
+* [[Port_applications|hurd/running/debian/porting]] to work in Hurd, 
 * Write [[translators|hurd/translator]] to extend the Hurd, 
-* Work on [[Hurd_on_Mach|contributing#hurd_on_mach]], or
+* Work on the [[Hurd_on_Mach|contributing#hurd_on_mach]], or
 * Help to port the Hurd [[to_a_modern_microkernel|contributing#hurd_on_modern_microkernel]].
 
 Read about ways to contribute [[in_more_detail|contributing]].
diff --git a/microkernel/mach/documentation.mdwn b/microkernel/mach/documentation.mdwn
index 83e2d0e2..fe870386 100644
--- a/microkernel/mach/documentation.mdwn
+++ b/microkernel/mach/documentation.mdwn
@@ -11,7 +11,14 @@ is included in the section entitled
   - [Meet Mach](http://www.stepwise.com/Articles/Technical/MeetMach.html), a
     summary of Mach's history and main concepts.
 
-  - OSF's [Kernel
-    Interface](ftp://ftp.cs.cmu.edu/afs/cs/project/mach/public/doc/osf/kernel_interface.ps)
-  - OSF's [Kernel
-    Principles](ftp://ftp.cs.cmu.edu/afs/cs/project/mach/public/doc/osf/kernel_principles.ps)
+  - OSF's [Kernel Interface (ps)](ftp://ftp.cs.cmu.edu/afs/cs/project/mach/public/doc/osf/kernel_interface.ps)
+    [Kernel Interface (pdf)](http://shakthimaan.com/downloads/hurd/kernel_interface.pdf) 
+
+  - OSF's [Kernel Principles (ps)](ftp://ftp.cs.cmu.edu/afs/cs/project/mach/public/doc/osf/kernel_principles.ps) 
+    [Kernel Principles (pdf)](http://shakthimaan.com/downloads/hurd/kernel_principles.pdf)
+
+  - [Porting and Modifying the Mach 3.0 Microkernel](http://shakthimaan.com/downloads/hurd/Porting%20and%20Modifying%20the%20Mach%203.0%20Microkernel.pdf)
+
+  - [An IO System for Mach](http://shakthimaan.com/downloads/hurd/An%20IO%20System%20for%20Mach.pdf)
+
+  - [A Programmers' Guide to Mach System Call](http://shakthimaan.com/downloads/hurd/A.Programmers.Guide.to.the.Mach.System.Calls.pdf)
diff --git a/microkernel/mach/gnumach.mdwn b/microkernel/mach/gnumach.mdwn
index 71681eed..d45549f5 100644
--- a/microkernel/mach/gnumach.mdwn
+++ b/microkernel/mach/gnumach.mdwn
@@ -27,3 +27,4 @@ GNU Mach runs on x86 machines.  See the
 * [[Boot_Trace]]
 * [[Projects]]
     * [[Rules]]
+    * [[Open_Issues]]
diff --git a/microkernel/mach/gnumach/open_issues.mdwn b/microkernel/mach/gnumach/open_issues.mdwn
new file mode 100644
index 00000000..433ec3ef
--- /dev/null
+++ b/microkernel/mach/gnumach/open_issues.mdwn
@@ -0,0 +1,19 @@
+[[meta copyright="Copyright © 2008 Free Software Foundation, Inc."]]
+
+[[meta license="""[[toggle id="license" text="GFDL 1.2+"]][[toggleable
+id="license" text="Permission is granted to copy, distribute and/or modify this
+document under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no Invariant
+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]]."]]"""]]
+
+[[meta title="Open Issues"]]
+
+This is a dumping ground for open issues for GNU Mach.
+
+[[inline
+pages="microkernel/mach/gnumach/open_issues/* and !*/discussion"
+show=0
+actions=yes
+rootpage="microkernel/mach/gnumach/open_issues" postformtext="Add a new item titled:"]]
diff --git a/microkernel/mach/gnumach/projects.mdwn b/microkernel/mach/gnumach/projects.mdwn
index 10ba0fe2..9ace6270 100644
--- a/microkernel/mach/gnumach/projects.mdwn
+++ b/microkernel/mach/gnumach/projects.mdwn
@@ -33,6 +33,8 @@ so that no duplicate efforts end up.
 
   * [[Clean_up_the_code]]
 
+  * [[Open_Issues]]
+
   * Update the core architecture and drivers
 
       * Check what NetBSD, FreeBSD and Linux do with their host specific code
diff --git a/microkernel/mach/mig.mdwn b/microkernel/mach/mig.mdwn
index f47eadfb..c620420a 100644
--- a/microkernel/mach/mig.mdwn
+++ b/microkernel/mach/mig.mdwn
@@ -10,3 +10,4 @@ GNU MIG is fully compatible with OSF MIG.
 * MIG's [homepage](http://www.gnu.org/software/hurd/mig.html)
 * [[Documentation]]
 * [[Building]] - Building (and obtaining) MIG
+* [[Open_Issues]]
diff --git a/microkernel/mach/mig/open_issues.mdwn b/microkernel/mach/mig/open_issues.mdwn
new file mode 100644
index 00000000..2d870695
--- /dev/null
+++ b/microkernel/mach/mig/open_issues.mdwn
@@ -0,0 +1,19 @@
+[[meta copyright="Copyright © 2008 Free Software Foundation, Inc."]]
+
+[[meta license="""[[toggle id="license" text="GFDL 1.2+"]][[toggleable
+id="license" text="Permission is granted to copy, distribute and/or modify this
+document under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no Invariant
+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]]."]]"""]]
+
+[[meta title="Open Issues"]]
+
+This is a dumping ground for open issues for GNU MIG.
+
+[[inline
+pages="microkernel/mach/mig/open_issues/* and !*/discussion"
+show=0
+actions=yes
+rootpage="microkernel/mach/mig/open_issues" postformtext="Add a new item titled:"]]
diff --git a/microkernel/mach/mig/open_issues/duplicate_inclusion_guards.mdwn b/microkernel/mach/mig/open_issues/duplicate_inclusion_guards.mdwn
new file mode 100644
index 00000000..93347759
--- /dev/null
+++ b/microkernel/mach/mig/open_issues/duplicate_inclusion_guards.mdwn
@@ -0,0 +1,14 @@
+[[meta copyright="Copyright © 2008 Free Software Foundation, Inc."]]
+
+[[meta license="""[[toggle id="license" text="GFDL 1.2+"]][[toggleable
+id="license" text="Permission is granted to copy, distribute and/or modify this
+document under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no Invariant
+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]]."]]"""]]
+
+E.g., both `/usr/include/hurd/process.h` and
+`/usr/include/hurd/process_request.h` use `_process_user_` as an inclusion
+guard.  This leads to problems when both are needed, as is the case in
+[[GDB]]'s `gdb/gnu-nat.c`.
diff --git a/microkernel/viengoos/building.mdwn b/microkernel/viengoos/building.mdwn
index 8868c46c..909f1b5e 100644
--- a/microkernel/viengoos/building.mdwn
+++ b/microkernel/viengoos/building.mdwn
@@ -14,7 +14,7 @@ Checkout hurd-l4:
 
     cvs -z3 -d :pserver:anonymous@cvs.savannah.gnu.org:/sources/hurd co hurd-l4
 
-Apply hurd-l4/libl4/ patch to change to gs:0 on line 35.
+There is a patch in the README file, to change to %%gs:0 in libl4/ia32/l4/bits/vregs.h in line 35. It should have been applied already in the checked out code. Do verify.
 
 Configure:
 
@@ -56,10 +56,10 @@ Get Pistachio using hg:
 
 Build:
 
-   cd kernel
+    cd kernel
 
-   make BUILDDIR=build
-   cd build
+    make BUILDDIR=build
+    cd build
 
 Check Makeconf.local: