none

1 files changed, 59 insertions, 18 deletions

diff --git a/Hurd/Xfree86.mdwn b/Hurd/Xfree86.mdwn
index d6b7f201..347ca47b 100644
--- a/Hurd/Xfree86.mdwn
+++ b/Hurd/Xfree86.mdwn
@@ -1,27 +1,57 @@
-1. First, set up the keyboard translator:
+## <a name="Setup_XFree86_in_GNU"> </a> Setup XFree86 in GNU
+
+This is a brief helper on how to setup X-Window on GNU.
+
+----
+
+### <a name="Mouse_amp_Keyboard"> Mouse &amp; Keyboard </a>
+
+First, set up the keyboard translator:
 
     # cd /dev
     # ./MAKEDEV kbd
 
-1. And then the mouse translator. For a serial port mouse, this is along the lines of:
+Then the mouse translator. For a serial port mouse this is along the lines of:
 
     # settrans /dev/mouse /hurd/mouse --device=com0 --protocol=microsoft
 
 Make sure that `/dev/com0` actually exists. If it does not, create it using `MAKEDEV` in the usual fashion.
 
-PS/2 so not require a device. It is simple a matter of:
+PS/2 mice do not require a device. It is simple a matter of:
 
     # settrans /dev/mouse /hurd/mouse --protocol=ps/2
 
-For other mice, run `/hurd/mouse` with the `--help` option.
+For other mice, run `/hurd/mouse --help` to get a listing of supported types.
+
+### <a name="Selecting_amp_Configuring_Packag"> Selecting &amp; Configuring Packages </a>
+
+You will need several X packages. The `x-window-system-core` brings you most of what you need:
+
+* `xserver-xfree86`
+* `xfonts-base`
+* `xfonts-100dpi`
+* `xfonts-75dpi`
+* `xfonts-scalable`
+* `xbase-clients`
+* `xutils`
+* `rxvt`
+* ... as well as your window manager of choice:
+  * WindowMaker, `wmaker`
+  * FVWM, `fvwm`
+  * Blackbox, `blackbox`
+  * TWM, `twm`
+
+The recommended way of configuring X is using the `xserver-xfree86` debconf template, eg:
 
-1. You will need several X packages. The `x-window-system-core` package will bring you most of what you need: `xserver-xfree86`, `xfonts-base`, `xfonts-100dpi`, `xfonts-75dpi`, `xfonts-scalable`, `xbase-clients`, `xutils`, `rxvt`, your window manager of choice
+    # dpkg-reconfigure xserver-xfree86
 
-1. The recommended way of configuring X is using the `xserver-xfree86` debconf template, eg: `dpkg-reconfigure xserver-xfree86`. It may just be easiest to just copy a working configuration file from another operation system running on the same computer and place it in `/etc/X11/XF86Config-4`, but this is discouraged as you'd have to remove some sections by hand.
+It may be easier to just copy a working configuration from another operation system on the same computer and place it in `/etc/X11/XF86Config-4`, but this is discouraged as you would have to remove some sections by hand.
 
-IMPORTANT: when you configure it, make sure you DON'T enable the following modules: `speedo`, `dri` because they're currently broken.
+**_IMPORTANT:_** when you configure X, make sure you do **NOT** enable the `speedo` and `dri` modules because they are currently broken.
 
-Then, edit the file manualy and make the mouse sections look like this:
+### <a name="Edit_XF86Config_4"> Edit XF86Config-4 </a>
+
+Now you have to edit the file manually to ensure that the mouse sections look like this:
 
     Section "InputDevice"
             Identifier      "Configured Mouse"
@@ -39,21 +69,32 @@ Then, edit the file manualy and make the mouse sections look like this:
             Option          "Protocol"              "osmouse"
     EndSection
 
-Emulate3Buttons (`Option "Emulate3Buttons" "true"`) may be optionally added. Nothing else will work.
+You may also enable the Emulate3Buttons option, but nothing else will work.
+
+            Option          "Emulate3Buttons"       "true"
 
-1. As the Hurd does not use `ld.so.conf`, it is necessary to add the following to `/etc/profile` to be sure that the libraries are found:
+### <a name="Dynamic_Linking"> Dynamic Linking </a>
+
+The Hurd does not use `ld.so.conf`, it is necessary to add the following to `/etc/profile` to be sure that the libraries are found:
 
     LD_LIBRARY_PATH=/X11R6/lib:$LD_LIBRARY_PATH
 
-1. Finally, run `startx`
+"This is a linker issue. GNU/Hurd expects that \`RPATH' is used, however, Debian takes certain measures to avoid this. Note that this does not cut it for suid binaries because of security implications. We expect to rectify this by using \`RUNPATH', which is specified in the new ELF standard." -- [Why does X not work?](http://www.gnu.org/software/hurd/faq.en.html#q4-8)
+
+### <a name="Starting_X"> Starting X </a>
+
+Finally, run `startx`
+
+However, there are several caveats to be aware of:
+
+* `xterm` does not work correctly; try `rxvt`.
+* `update-menu` does not yet work. As such, there are no fine Debian menus.
+* GNOME can now be ported with the new pthreads, but is still being worked on. Window Maker, TWM, Blackbox and FVWM all work.
 
-1. There are several caveats to be aware of:
-  1. 1. `xterm` does not work correctly; try `rxvt`.
-    2. `update-menu` does not yet work. As such, there are no fine Debian menus.
-    3. GNOME can now be ported with the new pthreads, but is still worked on. Window Maker, TWM, Blackbox and FVWM all work.
+----
 
--- [[Main/RobertMillan]] - 21 Nov 2002
+Created. -- [[Main/RobertMillan]] - 21 Nov 2002
 
-Some text formatting
+Some text formatting. -- [[Main/OgnyanKulev]] - 05 Dec 2002
 
--- [[Main/OgnyanKulev]] - 05 Dec 2002
+Dito. -- [[Main/JoachimNilsson]] - 12 Jan 2003