none

1 files changed, 15 insertions, 12 deletions

diff --git a/Hurd/BuildingHurd.mdwn b/Hurd/BuildingHurd.mdwn
index 8fc13e6e..a7cdfb38 100644
--- a/Hurd/BuildingHurd.mdwn
+++ b/Hurd/BuildingHurd.mdwn
@@ -2,6 +2,8 @@
 
 If you want to build the Hurd libraries and servers (translators) yourself instead of just using pre-built binaries, follow these instructions.
 
+One note before we begin: the likelihood that the compiled result will actually do what you expect it to do is the highest if you try building from the Debian source packages. This is especially true if you want to use your compilation within a Debian system.
+
 ## <a name="Getting_the_Source_Code"> Getting the Source Code </a>
 
 You can chose between getting the [sources from the developers's RCS](http://www.gnu.org/software/hurd/download.html#cvs):
@@ -31,17 +33,23 @@ Building the Hurd requires the _build-essential_ and _fakeroot_ packages, their
 
 ## <a name="Building"> Building </a>
 
-### <a name="_deb_files"> ... _.deb_ files </a>
+### <a name="Debian_deb_Files"> Debian _.deb_ Files </a>
 
 Change into the directory with the downloaded / unpacked Hurd sources, e.g.
 
     $ cd hurd-[TODO]
 
-Start the build process with
+If you want to work on the sources before building them, it's advisable to first apply the patches the Debian hurd package additionally contains:
+
+    $ debian/rules apply-patches
+
+Then edit and change whatever files you want and finally start the build process with
+
+    $ dpkg-buildpackage -us -uc -nc -b -rfakeroot
 
-    $ dpkg-buildpackage -us -uc -b -rfakeroot
+The _.deb_ packages will then drop out at the _../_ directory.
 
-### <a name="_TODO_"> [TODO] </a>
+### <a name="Building_but_not_the_Debian_Way"> Building, but not the Debian Way </a>
 
 The Hurd has to be built in a separate directory:
 
@@ -56,11 +64,6 @@ Notice that _make install_ will install the Hurd in _/_, not in _/usr/local/_ or
 
 By default profiling versions of all the libraries and code are generated but this is useless in most of the cases, so we disable them by specifying _--disable-profile_ on \_configure\_'s command line.
 
-As an alternative, you can build and install the Hurd in the Debian way (from CVS snapshot):
-
-    $ cd hurd
-    $ dpkg-buildpackage
-
 If you just want to build a specific server or library, you can pass its name to _make_:
 
     $ make ext2fs
@@ -68,11 +71,11 @@ If you just want to build a specific server or library, you can pass its name to
 
 This will automatically build all libraries that are required to build the requested server or library.
 
-### <a name="cross_compiling_"> cross compiling. </a>
+### <a name="Cross_Compiling"> Cross Compiling </a>
 
-[TODO]
+See <http://nic-nac-project.de/~schwinge/tmp/cross-gnu-env> and <http://nic-nac-project.de/~schwinge/tmp/cross-gnu> for now.
 
-## <a name="_TODO_"> [TODO] </a>
+## <a name="RPC_Ids"> </a> RPC Ids
 
 [TODO: update / integrate somewhere.]