summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--contributing.mdwn10
-rw-r--r--devel.html159
-rw-r--r--docs.html302
-rw-r--r--documentation.mdwn16
-rw-r--r--hurd.mdwn2
-rw-r--r--hurd/authentication.mdwn2
-rw-r--r--hurd/critique.mdwn4
-rw-r--r--hurd/documentation.mdwn48
-rw-r--r--hurd/documentation/auth.html (renamed from auth.html)96
-rw-r--r--hurd/documentation/hurd-paper.html (renamed from hurd-paper.html)70
-rw-r--r--hurd/documentation/hurd-talk.html (renamed from hurd-talk.html)110
-rw-r--r--hurd/hurd_hacking_guide.mdwn16
-rw-r--r--hurd/ng/position_paper.mdwn9
-rw-r--r--hurd/reference_manual.mdwn18
-rw-r--r--hurd/running/distrib.mdwn2
-rw-r--r--hurd/running/gnu/universal_package_manager.mdwn2
-rw-r--r--hurd/translator.mdwn1
-rw-r--r--hurd/translator/auth.mdwn13
-rw-r--r--microkernel/faq/multiserver_microkernel.mdwn4
-rw-r--r--microkernel/mach/documentation.mdwn18
-rw-r--r--microkernel/mach/gnu_mach.mdwn1
-rw-r--r--microkernel/mach/gnu_mach/reference_manual.mdwn26
-rw-r--r--microkernel/mach/mig/documentation.mdwn3
23 files changed, 184 insertions, 748 deletions
diff --git a/contributing.mdwn b/contributing.mdwn
index 698d03b..f100338 100644
--- a/contributing.mdwn
+++ b/contributing.mdwn
@@ -52,7 +52,7 @@ is another possibility, see the page about
[[running_a_Hurd_system|hurd/running]] for the full story.
Then you can either play around and eventually strive to do something
-useful or -- if you want -- ask us to assign something to you, depending
+useful or -- if you want -- [[ask_us|contact_us]] to assign something to you, depending
on the skills you have and the resources you intend to invest.
Please spend some time with thinking about the items in this [[questionnaire]].
@@ -62,10 +62,10 @@ 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 these web pages, 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.
+For more reading resources, please see these web pages, for example,
+[[Hurd_documentation|hurd/documentation]] and
+[[Mach_documentation|microkernel/mach/documentation]] for links to a bunch of
+documents.
### Porting Packages
diff --git a/devel.html b/devel.html
deleted file mode 100644
index 2a31f95..0000000
--- a/devel.html
+++ /dev/null
@@ -1,159 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN"
- "http://www.w3.org/TR/REC-html40/strict.dtd">
-<HTML>
-<HEAD>
-<TITLE>The GNU&nbsp;Hurd - GNU Project - Free Software Foundation (FSF)</TITLE>
-<LINK REV="made" HREF="mailto:web-hurd@gnu.org">
-<META NAME="keywords" CONTENT="hurd">
-</HEAD>
-<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#1F00FF" ALINK="#FF0000" VLINK="#9900DD">
-<TABLE width="100%" border="0" cellspacing="5" cellpadding="15">
-<TR>
-<TD COLSPAN="2">
-<IMG SRC="/graphics/hurd_sm_mf.jpg" ALT=" [image of the Hurd logo] ">
-[
-<!-- Please keep this list alphabetical -->
-<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! -->
- <A HREF="/software/hurd/devel.html">en</A>
-| <A HREF="/software/hurd/devel.eo.html">eo</A>
-| <a href="/software/hurd/devel.es.html">es</a>
-]
-</TD>
-</TR>
-<TR>
-<TD ALIGN="LEFT" VALIGN="TOP" BGCOLOR="#eeeeee">
-<A HREF="/software/hurd/whatsnew.html"><STRONG>What's New</STRONG></A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/changelogs.html">ChangeLogs</A><BR>
-&nbsp;<br>
-<a href="/software/hurd/docs.html">Documentation</a><br>
-<P>
-<A HREF="/software/hurd/hurd.html"><STRONG>GNU&nbsp;Hurd</STRONG></A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/install.html">Installation</A><BR>
-<A HREF="/software/hurd/help.html">Getting&nbsp;Help</A><BR>
-<A HREF="/software/hurd/download.html">Source&nbsp;Code</A><BR>
-<A HREF="/software/hurd/devel.html">Development</A><BR>
-<A HREF="/software/hurd/history.html">History</A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/gnumach.html"><STRONG>GNU&nbsp;Mach</STRONG></A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/gnumach-install.html">Installation</A><BR>
-<A HREF="/software/hurd/gnumach-download.html">Source&nbsp;Code</A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/mig.html"><STRONG>GNU&nbsp;MIG</STRONG></A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/mig-download.html">Source&nbsp;Code</A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/related-projects.html"><STRONG>Related&nbsp;Projects</STRONG></A>
-</TD>
-<TD ALIGN="LEFT" VALIGN="TOP">
-<HR>
-<H3><A NAME="contents">Table of Contents</A></H3>
-<UL>
- <LI><A HREF="#contrib" NAME="TOCcontrib">Contributing</A>
- <li><a href="#machinery" name="TOCmachinery">Machinery: getting access to a
- system</a>
- <LI><A HREF="#tasks" NAME="TOCtasks">Tasks</A>
-</UL>
-<HR>
-
-<H3><A HREF="#TOCcontrib" NAME="contrib">Contributing</A></H3>
-<P>
-If you want to contribute to the Hurd, you should first install and
-use it for a while, to become familiar with its features and design.
-To join the development team, subscribe to the
-<a href="http://lists.gnu.org/mailman/listinfo/bug-hurd">Bug-Hurd</a>
-<a href="mailto:bug-hurd@gnu.org">&lt;bug-hurd@gnu.org&gt;</a>
-mailing list, which is also the place where you can announce your
-intentions, make your proposals and send in your patches.
-(You can also send mail there without being subscribed to the list.)
-<P>
-There is also the <a
-href="http://lists.gnu.org/mailman/listinfo/hurd-devel-readers">
-Hurd-devel-readers</a>
-mailing list. It is the read-only version of Hurd-devel, an internal
-low-volume list restricted to the core developers of the Hurd. If you
-want to follow up on the discussion of the Hurd experts, please reply
-to the Bug-hurd mailing list. You can also follow the Hurd-devel
-mailing list by browsing the <A
-HREF="http://lists.gnu.org/archive/html/hurd-devel/">web-based archive of
-Hurd-devel</A>.
-
-<h3><a href="#TOCmachinery" name="machinery">Machinery: getting access to a
-system</a></h3>
-<p>
-There are essentially two possibilities: either you install the GNU/Hurd on a
-system (see <a href="/software/hurd/install.html">here</a>) or if you don't
-have a system to install it on, you can be provided with a shell account. See
-<a href="http://www.bddebian.com/~wiki/public_hurd_boxen">this wiki page</a>
-for details.
-
-<H3><A HREF="#TOCtasks" NAME="tasks">Tasks</A></H3>
-<P>
-Developing an operating system is a huge job, with a lot of different
-things to do. To be able to keep track of issues, we use a
-<ul>
- <li><a
- href="http://savannah.gnu.org/bugs/?func=browse&set=open&group=hurd">bug
- tracker</a> to register and comment on bugs, a
- <li><a
- href="http://savannah.gnu.org/task/?func=browse&set=open&group=hurd">task
- tracker</a> for tasks people could work on and a
- <li><a
- href="http://savannah.gnu.org/patch/?func=browse&set=open&group=hurd">patch
- tracker</a> where people can install their patches.
-</ul>
-There is also an older (but still valid) list of specific items in the
-<A HREF="http://cvs.savannah.gnu.org/viewcvs/~checkout~/hurd/hurd/tasks?rev=HEAD&content-type=text/plain">task file</A>
-and in the
-<A HREF="http://cvs.savannah.gnu.org/viewcvs/~checkout~/hurd/hurd/TODO?rev=HEAD&content-type=text/plain">TODO file</A>
-of the Hurd source repository.
-
-</TD>
-</TR>
-</TABLE>
-
-<HR>
-
-[
-<!-- Please keep this list alphabetical -->
-<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! -->
- <A HREF="/software/hurd/devel.html">en</A>
-| <A HREF="/software/hurd/devel.eo.html">eo</A>
-| <a href="/software/hurd/devel.es.html">es</a>
-]
-
-<HR>
-
-<P>
-Return to <A HREF="/home.html">GNU's home page</A>.
-<P>
-
-Please send FSF &amp; GNU inquiries &amp; questions to
-
-<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>.
-There are also <A HREF="/home.html#ContactInfo">other ways to
-contact</A> the FSF.
-<P>
-
-Please send comments on these web pages to
-
-<A HREF="mailto:web-hurd@gnu.org"><EM>web-hurd@gnu.org</EM></A>,
-send other questions to
-<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>.
-<P>
-Copyright (C) 2001, 2002, 2006, 2007
-Free Software Foundation, Inc.,
-59 Temple Place - Suite 330, Boston, MA 02111, USA
-<P>
-Verbatim copying and distribution of this entire article is
-permitted in any medium, provided this notice is preserved.
-<P>
-Updated:
-<!-- timestamp start -->
-$Date$ $Author$
-<!-- timestamp end -->
-<HR>
-</BODY>
-</HTML>
diff --git a/docs.html b/docs.html
deleted file mode 100644
index 9c3a43f..0000000
--- a/docs.html
+++ /dev/null
@@ -1,302 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN"
- "http://www.w3.org/TR/REC-html40/strict.dtd">
-<HTML>
-<HEAD>
-<meta http-equiv="content-type" content="text/html; charset=utf-8">
-<TITLE>The GNU&nbsp;Hurd - GNU Project - Free Software Foundation (FSF)</TITLE>
-<LINK REV="made" HREF="mailto:web-hurd@gnu.org">
-<META NAME="keywords" CONTENT="hurd">
-</HEAD>
-<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#1F00FF" ALINK="#FF0000" VLINK="#9900DD">
-<TABLE width="100%" border="0" cellspacing="5" cellpadding="15">
-<TR>
-<TD COLSPAN="2">
-<IMG SRC="/graphics/hurd_sm_mf.jpg" ALT=" [image of the Hurd logo] ">
-[
-<!-- Please keep this list alphabetical -->
-<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! -->
- <A HREF="/software/hurd/docs.html">English</A>
-| <A HREF="/software/hurd/docs.eo.html">Esperanto</A>
-| <a href="/software/hurd/docs.es.html">Spanish</a>
-]
-</TD>
-</TR>
-<TR>
-<TD ALIGN="LEFT" VALIGN="TOP" BGCOLOR="#eeeeee">
-<A HREF="/software/hurd/whatsnew.html"><STRONG>What's New</STRONG></A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/changelogs.html">ChangeLogs</A><BR>
-&nbsp;<br>
-<a href="/software/hurd/docs.html">Documentation</a><br>
-<P>
-<A HREF="/software/hurd/hurd.html"><STRONG>GNU&nbsp;Hurd</STRONG></A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/install.html">Installation</A><BR>
-<A HREF="/software/hurd/help.html">Getting&nbsp;Help</A><BR>
-<A HREF="/software/hurd/download.html">Source&nbsp;Code</A><BR>
-<A HREF="/software/hurd/devel.html">Development</A><BR>
-<A HREF="/software/hurd/history.html">History</A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/gnumach.html"><STRONG>GNU&nbsp;Mach</STRONG></A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/gnumach-install.html">Installation</A><BR>
-<A HREF="/software/hurd/gnumach-download.html">Source&nbsp;Code</A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/mig.html"><STRONG>GNU&nbsp;MIG</STRONG></A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/mig-download.html">Source&nbsp;Code</A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/related-projects.html"><STRONG>Related&nbsp;Projects</STRONG></A>
-</TD>
-
-<TD ALIGN="LEFT" VALIGN="TOP">
-<HR>
-<H3><A NAME="contents">Table of Contents</A></H3>
-<UL>
- <li><a href="#papers" name="TOCpapers">Introductory material, papers and
- other informational documents</a>
- <LI><A HREF="#faq" NAME="TOCfaq">Frequently asked questions</A>
- <li><a href="#wiki" name="TOCwiki">Wiki</a>
- <LI><A HREF="#manuals" NAME="TOCmanuals">Reference manuals</A>
-</UL>
-<HR>
-
-<h3><a href="#TOCpapers" name="papers">Introductory material, papers and other
-informational documents</a></h3>
-<P>
-<UL>
-
-<LI>
-<A HREF="hurd-paper.html">Towards a New Strategy of OS Design</A>, an
-architectural overview by Thomas Bushnell, BSG.
-
-<LI>
-<A HREF="hurd-talk.html">The Hurd</A>, a presentation by Marcus
-Brinkmann.
-
-<LI>
-<A HREF="/software/hurd/users-guide/using_gnuhurd.html" NAME="UsersGuide">
-GNU/Hurd User's Guide</A>, an introduction to the important
-concepts and software of the GNU system, written for new
-users, AKA "GNUbies."
-<P>
-Available Formats:
-<UL>
-<LI>
-<A HREF="/software/hurd/users-guide/using_gnuhurd.html">HTML version</A> for
-browsing online.
-<LI>
-<A HREF="/software/hurd/users-guide/using_gnuhurd.ps">PostScript version [477kB, 67 pages]</A>
-for download.
-<LI>
-<A HREF="/software/hurd/users-guide/using_gnuhurd.txt">ASCII text version [154kB]</A>.
-<LI>
-<A HREF="/software/hurd/users-guide/using_gnuhurd.texi">Texinfo source [155kB]</A>.
-</UL>
-
-<LI>
-<A HREF="/software/hurd/hacking-guide/hhg.html">The Hurd Hacking
-Guide</A>, an introduction to GNU&nbsp;Hurd and Mach programming by
-Wolfgang J&auml;hrling.
-<P>
-Available Formats:
-<UL>
-<LI>
-<A HREF="/software/hurd/hacking-guide/hhg.html">HTML version</A> for
-browsing online.
-<LI>
-<A HREF="/software/hurd/hacking-guide/hhg.ps">PostScript version [187kB, 37 pages]</A>
-for download.
-<LI>
-<A HREF="/software/hurd/hacking-guide/hhg.txt">ASCII text version [59kB]</A>.
-<LI>
-<A HREF="/software/hurd/hacking-guide/hhg.texi">Texinfo source [60kB]</A>.
-</UL>
-
-<li>
-<a href="http://hurdextras.nongnu.org/ipc_guide/">The <em>Unofficial GNU Mach
-IPC beginner's guide</em></a>, an easy introduction to Inter Process
-Comunication in the Mach microkernel by Manuel Pavón Valderrama.
-
-<li>
-<a
-href="http://walfield.org/pub/people/neal/papers/hurd-misc/mach-ipc-without-mig.txt"><em>Mach
-IPC without MIG</em></a>, an exercise by Neal H Walfield <q>to understand Mach
-IPC at one of its lowest application levels</q>.
-
-<ul>
-<li>
-<a
-href="http://walfield.org/pub/people/neal/papers/hurd-misc/ipc-hello.c"><em>ipc-hello.c</em></a>:
-<q>Hello world à la mach ipc</q>.
-
-</ul>
-
-<li>
-<a
-href=http://walfield.org/pub/people/neal/papers/hurd-misc/manual-bootstrap.txt><em>Manually
-Bootstrapping a Translator</em></a>, a text by Neal H. Walfield about how to
-<q>manually connect the translator to the filesystem</q>.
-
-<LI>
-<A HREF="auth.html">The Authentication Server</A>, the transcript of a talk about the details of
-the authentication mechanisms in the Hurd by Wolfgang J&auml;hrling.
-
-<li><a
-href="http://lists.gnu.org/archive/html/l4-hurd/2002-06/msg00001.html"><em>The
-Mach Paging Interface as Used by the Hurd</em></a>, a text by Neal Walfield.
-
-<li><a
-href="http://lists.gnu.org/archive/html/bug-hurd/2007-01/msg00046.html"><em>A
-Critique of the GNU&nbsp;Hurd Multi-server Operating System</em></a>, an
-analysis of the GNU&nbsp;Hurd on GNU&nbsp;Mach system, written by Neal Walfield
-and Marcus Brinkmann.
-
-<li><a
-href="http://lists.gnu.org/archive/html/l4-hurd/2007-01/msg00007.html">Position
-paper <em>Improving Usability via Access Decomposition and Policy
-Refinement</em></a>: Neal Walfield and Marcus Brinkmann give an overview about
-how a future, subsequent system may be architected.
-
-</UL>
-
-<H3><A HREF="#TOCfaq" NAME="faq">Frequently asked questions</A></H3>
-<P>
-Please check out the
-<A HREF="faq.en.html">Frequently
-Asked Questions about the GNU&nbsp;Hurd (33k characters)</A> and their
-answers, which cover most issues a new user will be confronted with.
-<P>
-This document is available in several languages:
-<UL>
-<LI><A HREF="faq.en.html">English</A>
-<LI><A HREF="faq.fr.html">fran&ccedil;ais</A>
-<LI><A HREF="faq.de.html">deutsch</A>
-<LI><A HREF="faq.ja.html">Japanese</A>
-<LI><A HREF="faq.es.html">espa&ntilde;ol</A>
-<LI><A HREF="faq.it.html">italiano</A>
-
-</UL>
-
-<h3><a href="#TOCwiki" name="wiki">Wiki</a></h3>
-<p>A <a href="http://www.bddebian.com/~wiki/">wiki</a> is available for
-collecting ideas and reciepes. Fell free
-to <a href="http://www.bddebian.com/~wiki/HowToContributeToThisWiki">contribute</a>!
-
-<p>Some topics:
-
-<ul>
-
-<li><a href="http://www.bddebian.com/~wiki/hurd/ng">The future direction of
-the GNU Hurd</a>.
-
-</ul>
-
-
-<H3><A HREF="#TOCmanuals" NAME="manuals">Reference manuals</A></H3>
-
-<ul>
-
-<li>
-<p>
-The GNU&nbsp;Mach Reference Manual documents the architecture, the usage and
-the programming of the GNU&nbsp;Mach microkernel. At the moment, the manual
-documents the interface completely, but is not very useful as a tutorial or
-introduction into the Mach architecture.
-<p>
-Available Formats:
-<ul>
-<li><a href="/software/hurd/gnumach-doc/index.html">HTML version</a>
-for browsing online;</li>
-<li><a href="/software/hurd/gnumach-doc/mach.ps">PostScript version</a>
-[around 900KiB];</li>
-<li><a href="/software/hurd/gnumach-doc/mach.ps.gz">gzipped PostScript
-version</a> [around 300KiB];</li>
-<li><a href="/software/hurd/gnumach-doc/mach.pdf">PDF version</a>
-[around 700KiB].</li>
-</ul>
-<p>
-If you want to work on the manual, you're advised to make a checkout of the <a
-href="gnumach-download.html#cvs">source tree</a>. Be sure to get the
-<samp>GNU&nbsp;Mach 1 branch</samp> when you intend to work on the manual. You
-can then find the manual's sources in the <samp>doc/</samp> directory. Please
-submit any modifications to <a
-href="mailto:bug-hurd@gnu.org">&lt;bug-hurd@gnu.org&gt;</a> (if possible in
-unidiff format, as produced by <samp>diff -u</samp>).
-
-</li>
-
-<li>
-<P>
-The GNU&nbsp;Hurd Reference Manual documents the architecture, the usage
-and the programming of the GNU&nbsp;Hurd. At the moment, the manual is
-quite incomplete.
-<P>
-Available Formats:
-<UL>
-<LI>
-<A HREF="/software/hurd/doc/hurd_toc.html">HTML version</A> for browsing online.
-</LI>
-<LI>
-<A HREF="/software/hurd/doc/hurd.ps">PostScript version [1020kB, 91 pages]</A>
-for download.
-</LI>
-</UL>
-<P>
-If you want to work on the manual, you're advised to make a checkout of the <a
-href="download.html#cvs">source tree</a>. You can then find the manual's
-sources in the <samp>doc/</samp> directory. Please submit any modifications to
-<a href="mailto:bug-hurd@gnu.org">&lt;bug-hurd@gnu.org&gt;</a> (if possible in
-unidiff format, as produced by <samp>diff -u</samp>).
-
-</li>
-
-</ul>
-
-</TD>
-</TR>
-</TABLE>
-
-<HR>
-
-[
-<!-- Please keep this list alphabetical -->
-<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! -->
- <A HREF="/software/hurd/docs.html">English</A>
-| <A HREF="/software/hurd/docs.eo.html">Esperanto</A>
-| <a href="/software/hurd/docs.es.html">Spanish</a>
-]
-
-<HR>
-
-<P>
-Return to <A HREF="/home.html">GNU's home page</A>.
-<P>
-
-Please send FSF &amp; GNU inquiries &amp; questions to
-
-<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>.
-There are also <A HREF="/home.html#ContactInfo">other ways to
-contact</A> the FSF.
-<P>
-
-Please send comments on these web pages to
-
-<A HREF="mailto:web-hurd@gnu.org"><EM>web-hurd@gnu.org</EM></A>,
-send other questions to
-<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>.
-<P>
-Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007
-Free Software Foundation, Inc.,
-59 Temple Place - Suite 330, Boston, MA 02111, USA
-<P>
-Verbatim copying and distribution of this entire article is
-permitted in any medium, provided this notice is preserved.
-<P>
-Updated:
-<!-- timestamp start -->
-$Date$ $Author$
-<!-- timestamp end -->
-<HR>
-</BODY>
-</HTML>
diff --git a/documentation.mdwn b/documentation.mdwn
index 45bb5ff..4e4b4b2 100644
--- a/documentation.mdwn
+++ b/documentation.mdwn
@@ -8,21 +8,13 @@ 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]]."]]"""]]
-# General
+Documentation for...
- * [GNU Hurd Documentation](http://www.gnu.org/software/hurd/docs.html)
+ * [[GNU_Hurd|hurd/documentation]]
+ * [[Mach|microkernel/mach/documentation]]
-# Introductory Material
-
-## External
-
- * [*Examining the Legendary HURD
- Kernel*](http://www.informit.com/articles/printerfriendly.aspx?p=1180992),
- an article by David Chisnall.
-
- Also covers a bit of GNU's and the Hurd's history, fundamental techniques
- applied, comparisions to other systems.
+ * [[MIG|microkernel/mach/mig/documentation]]
# [[Unix]] Programming
diff --git a/hurd.mdwn b/hurd.mdwn
index 61e83d2..3c65bb4 100644
--- a/hurd.mdwn
+++ b/hurd.mdwn
@@ -53,8 +53,6 @@ in the *unstable* branch of the Debian archive.
* [[Critique]] - Analysis
* [[Hurd_Hacking_Guide]]
* [[Concepts]]
-* Other resources
- * [Docs at gnu.org](http://www.gnu.org/software/hurd/docs.html)
# Using
diff --git a/hurd/authentication.mdwn b/hurd/authentication.mdwn
index cbb164c..14144d8 100644
--- a/hurd/authentication.mdwn
+++ b/hurd/authentication.mdwn
@@ -10,7 +10,7 @@ is included in the section entitled
UIDs on the Hurd are separate from processes. A process has
[[capabilities|capability]] designating so-called UID vectors that
-are implemented by an [[auth]] server. This
+are implemented by an [[translator/auth]] server. This
makes them easily [[virtualizable|virtualization]].
When a process wishes to gain access to a resource provided by a third
diff --git a/hurd/critique.mdwn b/hurd/critique.mdwn
index 9770138..dacd7bb 100644
--- a/hurd/critique.mdwn
+++ b/hurd/critique.mdwn
@@ -8,8 +8,8 @@ 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]]."]]"""]]
-[[NealWalfield]] and [[MarcusBrinkmann]] wrote a paper titled [*A Critique of
-the GNU Hurd Multi-Server Operating
+Neal Walfield and Marcus Brinkmann wrote a paper titled [*A Critique of
+the GNU Hurd Multi-server Operating
System*](http://walfield.org/papers/200707-walfield-critique-of-the-GNU-Hurd.pdf).
This was published in ACM SIGOPS Operating Systems Review in July 2007. This
is sometimes referred to as *the critique*.
diff --git a/hurd/documentation.mdwn b/hurd/documentation.mdwn
index bb37a8b..a8c3a98 100644
--- a/hurd/documentation.mdwn
+++ b/hurd/documentation.mdwn
@@ -1,4 +1,5 @@
-[[meta copyright="Copyright © 2008 Free Software Foundation, Inc."]]
+[[meta copyright="Copyright © 2001, 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
@@ -8,10 +9,53 @@ 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]]."]]"""]]
+# Introductory Material
+
* [[What_Is_the_GNU_Hurd]]
* [[Advantages]]
* [[FAQ]]
- * <http://www.gnu.org/software/hurd/docs.html>
+ * [[*Towards_a_New_Strategy_of_OS_Design*|hurd-paper]], an architectural
+ overview by Thomas Bushnell, BSG.
+
+ * [[*The_Hurd*|hurd-talk]], a presentation by Marcus Brinkmann.
+
+ * [[*A_Critique_of_the_GNU_Hurd_Multi-server_Operating_System*|critique]], an
+ analysis of the GNU Hurd on GNU Mach system, written by Neal Walfield and
+ Marcus Brinkmann.
+
+## External
+
+ * [*Examining the Legendary HURD
+ Kernel*](http://www.informit.com/articles/printerfriendly.aspx?p=1180992),
+ an article by David Chisnall.
+
+ Also covers a bit of GNU's and the Hurd's history, fundamental techniques
+ applied, comparisions to other systems.
+
+
+# Development
+
+ * *[[The_GNU_Hurd_Reference_Manual|reference_manual]]*.
+
+ * The *[[Hurd_Hacking_Guide]]*, an introduction to GNU&nbsp;Hurd and Mach
+ programming by Wolfgang Jährling.
+
+ * [*Manually Bootstrapping a
+ Translator*](http://walfield.org/pub/people/neal/papers/hurd-misc/manual-bootstrap.txt),
+ a text by Neal Walfield about how to *manually connect the translator to
+ the filesystem*.
+
+ * [[*The_Authentication_Server*|auth]], the transcript of a talk about the
+ details of the authentication mechanisms in the Hurd by Wolfgang Jährling.
+
+ * [*The Mach Paging Interface as Used by the
+ Hurd*](http://lists.gnu.org/archive/html/l4-hurd/2002-06/msg00001.html), a
+ text by Neal Walfield.
+
+ * In the
+ [[Position_paper_*Improving_Usability_via_Access_Decomposition_and_Policy*|ng/position_paper]]
+ Neal Walfield and Marcus Brinkmann give an overview about how a future,
+ subsequent system may be architected.
diff --git a/auth.html b/hurd/documentation/auth.html
index 676442e..487fc1f 100644
--- a/auth.html
+++ b/hurd/documentation/auth.html
@@ -1,48 +1,11 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN"
- "http://www.w3.org/TR/REC-html40/strict.dtd">
-<HTML>
-<HEAD>
-<TITLE>The GNU&nbsp;Hurd - GNU Project - Free Software Foundation (FSF)</TITLE>
-<LINK REV="made" HREF="mailto:web-hurd@gnu.org">
-<META NAME="keywords" CONTENT="hurd">
-</HEAD>
-<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#1F00FF" ALINK="#FF0000" VLINK="#9900DD">
-<TABLE width="100%" border="0" cellspacing="5" cellpadding="15">
-<TR>
-<TD COLSPAN="2">
-<IMG SRC="/graphics/hurd_sm_mf.jpg" ALT=" [image of the Hurd logo] ">
-[
- <A HREF="/software/hurd/auth.html">English</A>
-]
-</TD>
-</TR>
-<TR>
-<TD ALIGN="LEFT" VALIGN="TOP" BGCOLOR="#eeeeee">
-<A HREF="/software/hurd/whatsnew.html"><STRONG>What's New</STRONG></A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/changelogs.html">ChangeLogs</A><BR>
-&nbsp;<br>
-<a href="/software/hurd/docs.html">Documentation</a><br>
-<P>
-<A HREF="/software/hurd/hurd.html"><STRONG>GNU&nbsp;Hurd</STRONG></A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/install.html">Installation</A><BR>
-<A HREF="/software/hurd/help.html">Getting&nbsp;Help</A><BR>
-<A HREF="/software/hurd/download.html">Source&nbsp;Code</A><BR>
-<A HREF="/software/hurd/devel.html">Development</A><BR>
-<A HREF="/software/hurd/history.html">History</A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/gnumach.html"><STRONG>GNU&nbsp;Mach</STRONG></A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/gnumach-install.html">Installation</A><BR>
-<A HREF="/software/hurd/gnumach-download.html">Source&nbsp;Code</A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/mig.html"><STRONG>GNU&nbsp;MIG</STRONG></A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/mig-download.html">Source&nbsp;Code</A><BR>
-</TD>
-<TD ALIGN="LEFT" VALIGN="TOP">
-<HR>
+[[meta copyright="Copyright © 2002, 2008 Free Software Foundation, Inc."]]
+
+[[meta license="Verbatim copying and distribution of this entire article is
+permitted in any medium, provided this notice is preserved."]]
+
+[[meta title="The Authentication Server, the transcript of a talk about the
+details of the authentication mechanisms in the Hurd by Wolfgang Jährling"]]
+
<H3><A NAME="contents">Table of Contents</A></H3>
<UL>
<LI><A HREF="#intro" NAME="TOCintro">Introduction</A>
@@ -203,46 +166,3 @@ At this point, I have said at least most of what can be said about the
auth server and the protocol it implements, so I will finish by saying
that it might be an interesting task (for you) to modify some existing
software to take advantage of the features I described here.
-
-</TD>
-</TR>
-</TABLE>
-
-<HR>
-
-[
- <A HREF="/software/hurd/auth.html">English</A>
-]
-
-<HR>
-
-<P>
-Return to <A HREF="/home.html">GNU's home page</A>.
-<P>
-
-Please send FSF &amp; GNU inquiries &amp; questions to
-
-<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>.
-There are also <A HREF="/home.html#ContactInfo">other ways to
-contact</A> the FSF.
-<P>
-
-Please send comments on these web pages to
-
-<A HREF="mailto:web-hurd@gnu.org"><EM>web-hurd@gnu.org</EM></A>,
-send other questions to
-<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>.
-<P>
-Copyright (C) 2002 Free Software Foundation, Inc.,
-59 Temple Place - Suite 330, Boston, MA 02111, USA
-<P>
-Verbatim copying and distribution of this entire article is
-permitted in any medium, provided this notice is preserved.
-<P>
-Updated:
-<!-- timestamp start -->
-$Date$ $Author$
-<!-- timestamp end -->
-<HR>
-</BODY>
-</HTML>
diff --git a/hurd-paper.html b/hurd/documentation/hurd-paper.html
index bb49829..15d2dae 100644
--- a/hurd-paper.html
+++ b/hurd/documentation/hurd-paper.html
@@ -1,27 +1,13 @@
-<!DOCTYPE html PUBLIC "-//IETF//DTD HTML 2.0//EN">
-<HTML>
-<HEAD>
-<TITLE>Towards a New Strategy of OS Design</TITLE>
-<LINK REV="made" HREF="mailto:web-hurd@gnu.org">
-</HEAD>
-<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#1F00FF" ALINK="#FF0000" VLINK="#9900DD">
-<H1>Towards a New Strategy of OS Design</H1>
-<A HREF="/graphics/hurd_sm_mf.jpg"><IMG SRC="/graphics/hurd_sm_mf.jpg"
- ALT=" [image of a Hurd Metafont Logo] "
- WIDTH="333" HEIGHT="80">&#32;(jpeg 10k)</A>
-<A HREF="/graphics/hurd_mf.jpg">(jpeg 20k)</A>
-<A HREF="/philosophy/gif.html">no gifs due to patent problems</A>
-<BR>
-<BR>
-[
-<!-- Please keep this list alphabetical -->
-<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! -->
- <A HREF="/software/hurd/hurd-paper.html">English</A>
-| <A HREF="/software/hurd/hurd-paper.he.html">Hebrew</A>
-| <A HREF="/software/hurd/hurd-paper.tr.html">Turkish</A>
-]
+[[meta copyright="Copyright © 1996, 1997, 1998, 2007, 2008 Free Software
+Foundation, Inc."]]
+
+[[meta license="Verbatim copying and distribution of this entire article is
+permitted in any medium, provided this notice is preserved."]]
+
+[[meta title="Towards a New Strategy of OS Design, an architectural overview by
+Thomas Bushnell, BSG."]]
+
-<P>
This article explains why FSF is developing a new operating system named the
Hurd, which will be a foundation of the whole GNU system.
The Hurd is built
@@ -772,41 +758,3 @@ While the Hurd
will be willing to send and receive trailers, it will gain fairly little
advantage in doing so because there is no requirement that data be copied and
avoiding copies for page-aligned data is irrelevant.
-
-<HR>
-
-[
-<!-- Please keep this list alphabetical -->
-<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! -->
- <A HREF="/software/hurd/hurd-paper.html">English</A>
-| <A HREF="/software/hurd/hurd-paper.he.html">Hebrew</A>
-| <A HREF="/software/hurd/hurd-paper.tr.html">Turkish</A>
-]
-
-<HR>
-
-Return to <A HREF="/home.html">GNU's home page</A>.
-<P>
-FSF &amp; GNU inquiries &amp; questions to
-<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>.
-Other <A HREF="/home.html#ContactInfo">ways to contact</A> the FSF.
-<P>
-Comments on these web pages to
-<A HREF="mailto:web-hurd@gnu.org"><EM>web-hurd@gnu.org</EM></A>,
-send other questions to
-<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>.
-<P>
-Copyright (C) 1996 Trent Fisher
-<BR>
-Copyright (C) 1996, 1997, 1998, 2007 Free Software Foundation, Inc.,
-51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
-<P>
-Verbatim copying and distribution of this entire article is
-permitted in any medium, provided this notice is preserved.<P>
-Updated:
-<!-- hhmts start -->
-19 Dec 1998 jonas
-<!-- hhmts end -->
-<HR>
-</BODY>
-</HTML>
diff --git a/hurd-talk.html b/hurd/documentation/hurd-talk.html
index 630bbc7..d608e12 100644
--- a/hurd-talk.html
+++ b/hurd/documentation/hurd-talk.html
@@ -1,52 +1,11 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN"
- "http://www.w3.org/TR/REC-html40/strict.dtd">
-<HTML>
-<HEAD>
-<TITLE>The GNU&nbsp;Hurd - GNU Project - Free Software Foundation (FSF)</TITLE>
-<LINK REV="made" HREF="mailto:web-hurd@gnu.org">
-<META NAME="keywords" CONTENT="hurd">
-</HEAD>
-<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#1F00FF" ALINK="#FF0000" VLINK="#9900DD">
-<TABLE width="100%" border="0" cellspacing="5" cellpadding="15">
-<TR>
-<TD COLSPAN="2">
-<IMG SRC="/graphics/hurd_sm_mf.jpg" ALT=" [image of the Hurd logo] ">
-[
-<!-- Please keep this list alphabetical -->
-<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! -->
- <A HREF="/software/hurd/hurd-talk.html">English</A>
-]
-</TD>
-</TR>
-<TR>
-<TD ALIGN="LEFT" VALIGN="TOP" BGCOLOR="#eeeeee">
-<A HREF="/software/hurd/whatsnew.html"><STRONG>What's New</STRONG></A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/changelogs.html">ChangeLogs</A><BR>
-&nbsp;<br>
-<a href="/software/hurd/docs.html">Documentation</a><br>
-<P>
-<A HREF="/software/hurd/hurd.html"><STRONG>GNU&nbsp;Hurd</STRONG></A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/install.html">Installation</A><BR>
-<A HREF="/software/hurd/help.html">Getting&nbsp;Help</A><BR>
-<A HREF="/software/hurd/download.html">Source&nbsp;Code</A><BR>
-<A HREF="/software/hurd/devel.html">Development</A><BR>
-<A HREF="/software/hurd/history.html">History</A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/gnumach.html"><STRONG>GNU&nbsp;Mach</STRONG></A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/gnumach-install.html">Installation</A><BR>
-<A HREF="/software/hurd/gnumach-download.html">Source&nbsp;Code</A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/mig.html"><STRONG>GNU&nbsp;MIG</STRONG></A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/mig-download.html">Source&nbsp;Code</A><BR>
-&nbsp;<BR>
-<A HREF="/software/hurd/related-projects.html"><STRONG>Related&nbsp;Projects</STRONG></A>
-</TD>
-<TD ALIGN="LEFT" VALIGN="TOP">
-<HR>
+[[meta copyright="Copyright © 2001 Marcus Brinkmann"]]
+
+[[meta license="Verbatim copying and distribution of this entire article is
+permitted in any medium, provided this notice is preserved."]]
+
+[[meta title="The Hurd, a presentation by Marcus Brinkmann"]]
+
+
<H4><A NAME="contents">Table of Contents</A></H4>
<UL>
<LI><A HREF="#int" NAME="TOCint">Introduction</A>
@@ -85,7 +44,7 @@
This talk about the Hurd was written by Marcus Brinkmann for
<UL>
<LI>OSDEM, Brussels, 4. Feb 2001,
-<LI>Frhjahrsfachgesprche, Cologne, 2. Mar 2001 and
+<LI>Frühjahrsfachgespräche, Cologne, 2. Mar 2001 and
<LI>Libre Software Meeting, Bordeaux, 4. Jul 2001.
</UL>
@@ -352,8 +311,7 @@ servers, too!
</TD></TR></TABLE>
<P>
To quote Thomas Bushnell, BSG, from his paper
-<A HREF="/software/hurd/hurd-paper.html">``A new strategy towards OS
-design'' (1996)</A>:
+[[``Towards_a_New_Strategy_of_OS_design''_(1996)|hurd-paper]]:
<BLOCKQUOTE>
The GNU&nbsp;Hurd, by contrast, is designed to make the area of system code
as limited as possible. Programs are required to communicate only
@@ -1101,51 +1059,3 @@ Join us at
</TD></TR></TABLE>
<P>
List of contacts.
-
-<P>
-<EM>Some of these links are at other web sites not maintained by the
-FSF. The FSF is not responsible for the content of these other web sites.</EM>
-
-</TD>
-</TR>
-</TABLE>
-
-<HR>
-
-[
-<!-- Please keep this list alphabetical -->
-<!-- PLEASE UPDATE THE LIST AT THE BOTTOM (OR TOP) OF THE PAGE TOO! -->
- <A HREF="/software/hurd/hurd-talk.html">English</A>
-]
-
-<HR>
-
-<P>
-Return to <A HREF="/home.html">GNU's home page</A>.
-<P>
-
-Please send FSF &amp; GNU inquiries &amp; questions to
-
-<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>.
-There are also <A HREF="/home.html#ContactInfo">other ways to
-contact</A> the FSF.
-<P>
-
-Please send comments on these web pages to
-
-<A HREF="mailto:web-hurd@gnu.org"><EM>web-hurd@gnu.org</EM></A>,
-send other questions to
-<A HREF="mailto:gnu@gnu.org"><EM>gnu@gnu.org</EM></A>.
-<P>
-Copyright (C) 2001 Marcus Brinkmann <A HREF="mailto:marcus@gnu.org">&lt;marcus@gnu.org&gt;</A>
-<P>
-Verbatim copying and distribution of this entire article is
-permitted in any medium, provided this notice is preserved.
-<P>
-Updated:
-<!-- timestamp start -->
-$Date$ $Author$
-<!-- timestamp end -->
-<HR>
-</BODY>
-</HTML>
diff --git a/hurd/hurd_hacking_guide.mdwn b/hurd/hurd_hacking_guide.mdwn
index 0cb96f3..2ef08f8 100644
--- a/hurd/hurd_hacking_guide.mdwn
+++ b/hurd/hurd_hacking_guide.mdwn
@@ -8,6 +8,16 @@ 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]]."]]"""]]
-Originally written by Wolfgang Jährling, the [Hurd Hacking Guide](http://www.gnu.org/software/hurd/hacking-guide/hhg.html)
-contains an overview of some of the Hurd's features.
-Also contains a tutorial on writing your own [[translator]].
+Originally written by Wolfgang Jährling, the *Hurd Hacking Guide* contains an
+introduction to GNU Hurd and GNU Mach programming, an overview of some of the
+Hurd's features. It also contains a tutorial on writing your own
+[[translator]].
+
+ * [HTML version](http://www.gnu.org/software/hurd/hacking-guide/hhg.html) for
+ browsing online,
+ * [PostScript version](http://www.gnu.org/software/hurd/hacking-guide/hhg.ps)
+ [187kB, 37 pages],
+ * [ASCII text
+ version](http://www.gnu.org/software/hurd/hacking-guide/hhg.txt) [59kB],
+ * [Texinfo source](http://www.gnu.org/software/hurd/hacking-guide/hhg.texi)
+ [60kB].
diff --git a/hurd/ng/position_paper.mdwn b/hurd/ng/position_paper.mdwn
index 3240a41..e0f4bf6 100644
--- a/hurd/ng/position_paper.mdwn
+++ b/hurd/ng/position_paper.mdwn
@@ -8,7 +8,8 @@ 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]]."]]"""]]
-[[NealWalfield]] and [[MarcusBrinkmann]] wrote a paper titled [*Improving
-Usability via Access Decomposition and Policy
-Refinement*](http://walfield.org/papers/20070104-walfield-access-decomposition-policy-refinement.pdf).
-This is sometimes referred to as *the position paper*.
+Neal Walfield and Marcus Brinkmann wrote a paper titled [*Improving Usability
+via Access Decomposition and Policy
+Refinement*](http://walfield.org/papers/20070104-walfield-access-decomposition-policy-refinement.pdf)
+where they give an overview about how a future, subsequent system may be
+architected. This is sometimes referred to as *the position paper*.
diff --git a/hurd/reference_manual.mdwn b/hurd/reference_manual.mdwn
new file mode 100644
index 0000000..5b5bff2
--- /dev/null
+++ b/hurd/reference_manual.mdwn
@@ -0,0 +1,18 @@
+[[meta copyright="Copyright © 2001, 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 GNU Hurd Reference Manual* documents the architecture, the usage and the
+programming of the GNU Hurd. At the moment, the manual is quite incomplete.
+
+ * [HTML version](http://www.gnu.org/software/hurd/doc/hurd_toc.html) for
+ browsing online,
+ * [PostScript version](http://www.gnu.org/software/hurd/doc/hurd.ps)
+ [1020KiB, 91 pages].
diff --git a/hurd/running/distrib.mdwn b/hurd/running/distrib.mdwn
index fc42e86..b0a6bad 100644
--- a/hurd/running/distrib.mdwn
+++ b/hurd/running/distrib.mdwn
@@ -94,7 +94,7 @@ about getting applications to work (if possible).
* GNU [Coding Standards](http://www.gnu.org/prep/standards.html)
* [[TestSuites]] - Posix, Perl, results feedback, etc.
-* [docs and papers](http://www.gnu.org/software/hurd/docs.html)
+* [[Documentation]]
* [[SystemAPILimits]]
* [[CodeAnnouncements]] - Recent coding projects related to the Hurd
diff --git a/hurd/running/gnu/universal_package_manager.mdwn b/hurd/running/gnu/universal_package_manager.mdwn
index 009b26b..440f112 100644
--- a/hurd/running/gnu/universal_package_manager.mdwn
+++ b/hurd/running/gnu/universal_package_manager.mdwn
@@ -127,7 +127,7 @@ OK. I will give you steps.
i. Install a GNU System by folowing [[these_instructions|setup]]
-ii. Read about GNU Design <http://www.gnu.org/software/hurd/hurd-paper.html>
+ii. Read about GNU Design: [[Towards_a_New_Strategy_of_OS_Design|documentation/hurd-paper]]
iii. Read about translators <http://www.debian.org/ports/hurd/hurd-doc-translator>
diff --git a/hurd/translator.mdwn b/hurd/translator.mdwn
index b995293..889f02a 100644
--- a/hurd/translator.mdwn
+++ b/hurd/translator.mdwn
@@ -43,6 +43,7 @@ See some [[examples]] about how to use translators.
# Existing Translators
+* [[auth]]
* [[pfinet]]
* [[pflocal]]
* [[hostmux]]
diff --git a/hurd/translator/auth.mdwn b/hurd/translator/auth.mdwn
new file mode 100644
index 0000000..73e7e02
--- /dev/null
+++ b/hurd/translator/auth.mdwn
@@ -0,0 +1,13 @@
+[[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]]."]]"""]]
+
+[[*The_Authentication_Server*|documentation/auth]], the transcript of a talk
+about the details of the authentication mechanisms in the Hurd by Wolfgang
+Jährling.
diff --git a/microkernel/faq/multiserver_microkernel.mdwn b/microkernel/faq/multiserver_microkernel.mdwn
index da69042..68ed332 100644
--- a/microkernel/faq/multiserver_microkernel.mdwn
+++ b/microkernel/faq/multiserver_microkernel.mdwn
@@ -22,5 +22,5 @@ use, but now, because the server runs in user space as the user that started
it, they may, for instance, mount an FTP filesystem in their home directory.
For more information about the design of the Hurd, read the paper by Thomas
-Bushnell, BSG: [Towards a new strategy on OS
-design](http://www.gnu.org/software/hurd/hurd-paper.html).
+Bushnell, BSG:
+[[Towards_a_New_Strategy_of_OS_Design|hurd/documentation/hurd-paper]].
diff --git a/microkernel/mach/documentation.mdwn b/microkernel/mach/documentation.mdwn
index fe87038..f6f2eb7 100644
--- a/microkernel/mach/documentation.mdwn
+++ b/microkernel/mach/documentation.mdwn
@@ -1,4 +1,5 @@
-[[meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]]
+[[meta copyright="Copyright © 2001, 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
@@ -11,12 +12,27 @@ 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.
+ * *[[The_GNU_Mach_Reference_Manual|gnu_mach/reference_manual]]*.
+
- 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)
+ * [*The Unofficial GNU Mach IPC beginner's
+ guide*](http://hurdextras.nongnu.org/ipc_guide/), an easy introduction to
+ Inter Process Comunication in the Mach microkernel by Manuel Pavón
+ Valderrama.
+
+ * [*Mach IPC without
+ MIG*](http://walfield.org/pub/people/neal/papers/hurd-misc/mach-ipc-without-mig.txt),
+ an exercise by Neal Walfield *to understand Mach IPC at one of its lowest
+ application levels*.
+
+ * [*ipc-hello.c*](http://walfield.org/pub/people/neal/papers/hurd-misc/ipc-hello.c):
+ *Hello world à la mach ipc*.
+
- [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)
diff --git a/microkernel/mach/gnu_mach.mdwn b/microkernel/mach/gnu_mach.mdwn
index cdb43a6..19e1ea5 100644
--- a/microkernel/mach/gnu_mach.mdwn
+++ b/microkernel/mach/gnu_mach.mdwn
@@ -71,6 +71,7 @@ GNU/Hurd.
# Development
+ * [[Reference_Manual]]
* [[Building]]
* [[Debugging]]
* [[Boot_Trace]]
diff --git a/microkernel/mach/gnu_mach/reference_manual.mdwn b/microkernel/mach/gnu_mach/reference_manual.mdwn
new file mode 100644
index 0000000..225ab17
--- /dev/null
+++ b/microkernel/mach/gnu_mach/reference_manual.mdwn
@@ -0,0 +1,26 @@
+[[meta copyright="Copyright © 2001, 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 GNU Mach Reference Manual* documents the architecture, the usage and the
+programming of the GNU Mach microkernel. At the moment, the manual documents
+the interface completely, but is not very useful as a tutorial or introduction
+into the Mach architecture.
+
+ * [HTML version](http://www.gnu.org/software/hurd/gnumach-doc/index.html)
+ for browsing online,
+ * [PostScript
+ version](http://www.gnu.org/software/hurd/gnumach-doc/mach.ps) [around
+ 900KiB],
+ * [gzipped PostScript
+ version](http://www.gnu.org/software/hurd/gnumach-doc/mach.ps.gz)
+ [around 300KiB],
+ * [PDF version](http://www.gnu.org/software/hurd/gnumach-doc/mach.pdf)
+ [around 700KiB].
diff --git a/microkernel/mach/mig/documentation.mdwn b/microkernel/mach/mig/documentation.mdwn
index 8c977e5..a0bbbe1 100644
--- a/microkernel/mach/mig/documentation.mdwn
+++ b/microkernel/mach/mig/documentation.mdwn
@@ -66,8 +66,7 @@ pp. 67--77."
# Further Relevant Documentation
- * The [GNU Mach Reference
- Manual](http://www.gnu.org/software/hurd/docs.html#manuals), espacially
+ * The [[GNU_Mach_Reference_Manual|gnu_mach/reference_manual]], espacially
[Chapter 4, Inter Process
Communication](http://www.gnu.org/software/hurd/gnumach-doc/Inter-Process-Communication.html),
which, for example, explains how the <a name="dealloc">`dealloc` flag</a>