Hi, I updated the installation instructions a bit to reflect the Hurd console and the current state of X configuration and also did some other minor changes.
pseudo-changelog: * Removed mention of the Hurd kernel-cousin, it's gone since several years now. * Removed bug-grub as Hurd related mailing list. * Changed the contact address from Marcus to debian-hurd * Use -b 4096 as option for mke2fs, to work-around limitations in ext2fs. * Removed 'don't touch keyboard during bootup', it's since fixed. * Updated apt-offline documentation location * Rewrote X configuration and added Hurd console sections. * Also mention the NIC-update in the news entry for K8. Index: hurd-contact.wml =================================================================== RCS file: /cvs/webwml/webwml/english/ports/hurd/hurd-contact.wml,v retrieving revision 1.25 diff -u -u -r1.25 hurd-contact.wml --- hurd-contact.wml 2 Oct 2004 23:23:11 -0000 1.25 +++ hurd-contact.wml 12 Jan 2005 11:29:40 -0000 @@ -14,12 +14,6 @@ distribution. If you have problems with the Debian packages of the Hurd, or if you want to join the development, this is the correct place. -<p> -As the Debian GNU/Hurd project is covered in a -<a href="http://www.kerneltraffic.org/debian-hurd/latest.html";>Kernel -Cousin</a> you can read <em>excellent</em> summaries of the mailing -list discussion online. Don't waste your time reading the full thing, -go over to Kernel Cousins!</li> <li> <a href="http://lists.gnu.org/mailman/listinfo/help-hurd";><code>help-hurd</code></a> @@ -40,17 +34,12 @@ from the developers on this list. You can also report bugs there, but please consider using the <a href="$(HOME)/Bugs/">Debian Bug Tracking System</A> for this purpose.</li></ul> -<p> -There are further mailing lists that are closely related to the Hurd -development. -<ul> -<li><a name="bug-grub"><tt>bug-grub</tt></a> is a mailing list hosted -by GNU for discussion about GNU Grub development.</li></ul> <h2> Contacting the Web Author</h2> <p> If you have troubles with the web server, you should contact <tt>[EMAIL PROTECTED]</tt>, but if you find any errors in the -content of the Hurd porting pages, you should write to <a -href="mailto:[EMAIL PROTECTED]">Marcus Brinkmann</A>, so he can fix -it.</p> +content of the Hurd porting pages, you should write to the <a +href="mailto:[email protected]";>debian-hurd</A> mailing list, so we +can fix it. +</p> Index: hurd-install.wml =================================================================== RCS file: /cvs/webwml/webwml/english/ports/hurd/hurd-install.wml,v retrieving revision 1.35 diff -u -u -r1.35 hurd-install.wml --- hurd-install.wml 28 Nov 2004 22:45:36 -0000 1.35 +++ hurd-install.wml 12 Jan 2005 11:29:41 -0000 @@ -108,12 +108,12 @@ </p> <p> -To create a filesystem, use <CODE>mke2fs</CODE> and pass it <SAMP>`-o hurd' +To create a filesystem, use <CODE>mke2fs</CODE> and pass it <SAMP>`-b 4096 -o hurd' </SAMP> to designate the Hurd as the owner of the new file system. For instance, assuming the partition is <TT>`/dev/hda2'</TT>: </p> -<table><tr><td> </td><td class=example><pre> # mke2fs -o hurd /dev/hda2 +<table><tr><td> </td><td class=example><pre> # mke2fs -b 4096 -o hurd /dev/hda2 </pre></td></tr></table> @@ -280,12 +280,6 @@ </pre></td></tr></table> <p> -Sit back and watch the messages. This is actually more important than most -people believe: there is a bug in GNU Mach whereby hitting a key during the -boot process causes the kernel to panic. -</p> - -<p> If GNU/Hurd fails to boot, it could be due to shared IRQs: GNU Mach does not play well with these. You can verify your situation by looking at, for instance, the <TT>`/proc/interrupts'</TT> file under GNU/Linux. Also, as GNU @@ -504,59 +498,57 @@ If GNU Mach does not recognize your network card or you use a modem, the only way to upgrade will be to download the packages and then transfer them to the GNU system. The easiest way to do this is to use apt off-line. Refer to -<TT>`/usr/share/doc/apt/offline'</TT> for detailed instructions. +<TT>`/usr/share/doc/apt-doc/offline.text.gz'</TT> for detailed instructions. </p> - -<h3> 8.4 XFree86 </h3> +<h3> 8.4 The Hurd console</h3> <p> -XFree86 has been ported and all video cards, which it supports that do not -require a kernel module should work. -</p> - -<p> -First, set up the keyboard translator: +Besides the Mach console you encountered during installation, the GNU Hurd features +a powerful user-space console providing virtual terminals. Currently, you have to +start the Hurd console manually with the following command: </p> <table><tr><td> </td><td class=example><pre> # cd /dev - \# ./MAKEDEV kbd + \# console -d vga -d pc_mouse --repeat=mouse -d pc_kbd --repeat=kbd -d generic_speaker -c /dev/cons /dev/vcs </pre></td></tr></table> -<p> -And then the mouse translator. For a serial port mouse, run the following -replace <TT>`com0'</TT> with the appropriate communication port: +</p> +Inside the Hurd console, you can switch between virtual terminals via <KBD>ALT+F1, +ALT+F2</KBD> and so on. <KBD>ALT+CTRL+BACKSPACE</KBD> detachs the Hurd console and +brings you back to the Mach console, from where you can reattach again with the above +command. </p> -<table><tr><td> </td><td class=example><pre> # settrans -cap /dev/mouse /hurd/mouse --device=com0 --protocol=microsoft -</pre></td></tr></table> +<h3> 8.5 XFree86 </h3> <p> -Make sure that <TT>`/dev/com0'</TT> actually exists. If it does not, create it -using <CODE>MAKEDEV</CODE> in the usual fashion. +XFree86 has been ported and all video cards, which it supports that do not +require a kernel module should work. </p> <p> -PS/2 so not require a device node. It is simple a matter of: +You need to be in the Hurd console and have repeaters setup as indicated in +Section 8.4 above. As XFree86 has <CODE>/dev/kbd</CODE> hardcoded as device for +the keyboard, you have to make a symlink: + </p> -<table><tr><td> </td><td class=example><pre> # settrans -cap /dev/mouse /hurd/mouse --protocol=ps/2 +<table><tr><td> </td><td class=example><pre> # cd /dev + \# cd /dev + \# ln -s cons/kbd kbd + \# ln -s cons/mouse mouse </pre></td></tr></table> <p> -Other mice can be used; run <TT>`/hurd/mouse'</TT> with the -<SAMP>`--help'</SAMP> option for details. -</p> - -<p> -You will need several X packages. x-window-system-core, rxvt and twm or fvwm -are a good start. +You will need several X packages. <CODE>x-window-system-core, rxvt</CODE> and +<CODE>twm, fvwm<CODE> or <CODE>wmaker</CODE> are a good start. </p> <p> Debconf can be used to configure XFree86, however, it is not Hurd aware and -the configuration file will need to be tweaked. Change the pointer section to -read: +the configuration file will need to be tweaked. After configuring, change the +pointer section to read: </p> <table><tr><td> </td><td class=example><pre>Section "Pointer" @@ -566,8 +558,8 @@ </pre></td></tr></table> <p> -<SAMP>`Emulate3Buttons'</SAMP> may be optionally added. Nothing else will -work. +<SAMP>`Emulate3Buttons'</SAMP> and <SAMP>`ZAxisMapping'</SAMP> must both be +disabled. </p> <p> @@ -593,9 +585,3 @@ </p> -<h3> 8.5 Virtual Terminals </h3> - -<p> -GNU/Hurd does not have virtual terminals although it is in development. Use -the <CODE>screen</CODE> package in the interim. -</p> Index: hurd-news.wml =================================================================== RCS file: /cvs/webwml/webwml/english/ports/hurd/hurd-news.wml,v retrieving revision 1.30 diff -u -u -r1.30 hurd-news.wml --- hurd-news.wml 30 Dec 2004 21:40:14 -0000 1.30 +++ hurd-news.wml 12 Jan 2005 11:29:41 -0000 @@ -5,7 +5,7 @@ <h3><:=spokendate ("2004-12-30"):></h3> <P>The K8 CD Images are now available. These Images support Filesystems bigger -than 2 GB.<br/> +than 2 GB and feature an update of the network device drivers.<br/> See the <A HREF="./hurd-cd">Hurd CD page</a> for further information.</p> <h3><:=spokendate ("2004-03-06"):></h3> If nobody objects, can either somebody commit this please, or I'll forward it to debian-www in the next days. Comments welcome cheers, Michael -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
