website updates
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>webmaster@debian.org</tt>, but if you find any errors in the
-content of the Hurd porting pages, you should write to <a
-href="mailto:brinkmd@debian.org";>Marcus Brinkmann</A>, so he can fix
-it.</p>
+content of the Hurd porting pages, you should write to the <a
+href="mailto:debian-hurd@lists.debian.org";>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
Reply to: