mach/building: Reword for clarity

1 files changed, 12 insertions, 13 deletions

diff --git a/microkernel/mach/mig/gnu_mig/building.mdwn b/microkernel/mach/mig/gnu_mig/building.mdwn
index 4d4be660..759c1a84 100644
--- a/microkernel/mach/mig/gnu_mig/building.mdwn
+++ b/microkernel/mach/mig/gnu_mig/building.mdwn
@@ -10,7 +10,7 @@ RCS](http://git.savannah.gnu.org/cgit/hurd/):
 
     $ git clone git://git.savannah.gnu.org:/srv/git/hurd/mig.git
 
-... or (if you are working on a Debian system) the ones that are used for the
+... or (if you are working on a Debian system) get the sources that are used for the
 [current Debian mig package](http://packages.debian.net/source/unstable/mig):
 
     $ apt-get source mig
@@ -23,16 +23,15 @@ The unpacked source tree is around 1 MiB, and the build tree also is around 1 Mi
 
 ### <a name="Preparing_for_the_Build"> Preparing for the Build </a>
 
-Building the Mach Interface Generator requires the _build-essential_ and
-_fakeroot_ packages, their dependencies and additional packages that are
-specified by the source mig package:
+Building MIG requires the *build-essential* and *fakeroot* packages,
+and some additional dependencies specified by the mig source package:
 
     # apt-get install build-essential fakeroot
     # apt-get build-dep mig
 
 ### <a name="Building_and_Installing"> Building and Installing </a> <a name="_a_deb_file"> ... a _.deb_ file </a>
 
-Change into the directory with the downloaded / unpacked MIG sources (_mig-SomeVersionNumber):
+Change into the directory with the downloaded / unpacked MIG sources:
 
     $ cd mig-X.X.X.XX
 
@@ -40,15 +39,15 @@ Start the build process:
 
     $ dpkg-buildpackage -us -uc -b -rfakeroot
 
-You can then install / distribute the _.deb_ file which will drop out one
-directory above the current one.
+This will create a _.deb_ package in the parent directory,
+which you can then install on your system.
 
 ## <a name="_on_non_Debian_systems"> On non-Debian Systems: </a>
 
 ### <a name="Preparing_for_the_Build"> Preparing for the Build </a>
 
 Building the Mach Interface Generator requires a C compiler, a standard 32 bit
-C library (with corresponding header files) and your favourite flavor of awk
+C library (with corresponding header files), your favourite flavor of awk
 (gawk), yacc (bison), lex (flex) and make.
 
 Additionally, you need to have GNU Mach's header files installed.  See
@@ -61,24 +60,24 @@ First, generate the configuration files:
     $ cd mig
     $ autoreconf --install
 
-The Mach Interface Generator should be built in a subdirectory:
+The Mach Interface Generator has to be built in a separate build directory:
 
     $ mkdir build
     $ cd build
 
-Find the root directory where you installed GNU Mach's header files and where
-you now intend to install the Mach Interface Generator (_~/gnu_), and run
+Find the base directory where you installed GNU Mach's header files and where
+you now intend to install the Mach Interface Generator (e.g. _~/gnu_), and run
 configure:
 
     $ GNU=~/gnu
     $ TARGET_CPPFLAGS=-I"$GNU"/include ../configure --prefix="$GNU"
 
-The --host flag is necessary if you are building on a 64 bit machine:
+If you are building on a 64 bit machine, you need to add a --host option:
 
     $ GNU=~/gnu
     $ TARGET_CPPFLAGS=-I"$GNU"/include ../configure --prefix="$GNU" --host=i686-unknown-linux-gnu 
 
-Build and install the Mach Interface Generator into _$GNU_, i.e. _~/gnu/_ in our example:
+Build and install the Mach Interface Generator into _$GNU_ (i.e. _~/gnu/_ in our example):
 
     $ make all install