Re: Hey all, I would like to help write some docs

[B. Douglas Hilton]

Here is a patch which updates the README and provides instructions for 
building on systems with buggy autoreconf (like Debian unstable). I also 
added sample steps for building Pistachio and made a change to the 
sample GRUB menu.lst entry to reflect that sigma0 gets installed into 
/libexec/l4 by default.

Doug



diff -cr hurd-l4/ChangeLog hurd-l4a/ChangeLog
*** hurd-l4/ChangeLog   Mon Apr 26 17:16:25 2004
--- hurd-l4a/ChangeLog  Wed Jun 16 02:30:00 2004
***************
*** 1,3 ****
--- 1,8 ----
+ 2004-07-16  B. Douglas Hilton <address@hidden>
+ 
+       * README: Added info for building on Debian systems with buggy
+       autotools wrappers. Added example for building Pistachio
+ 
  2004-04-26  Marcus Brinkmann  <address@hidden>
  
        * configure.ac: Add include for wortel/headers.m4.
diff -cr hurd-l4/README hurd-l4a/README
*** hurd-l4/README      Fri Sep 19 10:18:04 2003
--- hurd-l4a/README     Wed Jun 16 02:44:12 2004
***************
*** 22,27 ****
--- 22,36 ----
  $ cp wortel/wortel /l4/boot
  $ cp physmem/physmem /l4/boot
  
+ On Debian systems try the following if autoreconf fails:
+ 
+ $ aclocal-1.8
+ $ autoconf2.50
+ $ autoheader2.50
+ $ automake-1.8 -a
+ 
+ Then proceed as above from the ./configure step
+ 
  
  Installation on ia32
  --------------------
***************
*** 35,41 ****
  
  sigma0 must be built with a different link base than the default value
  0x20000, because that conflicts with GRUB (on ia32).  I have
! successfully used a link base of 0x40000.
  
  Then set up GRUB to boot laden as the kernel, and the L4 kernel,
  sigma0, wortel (the rootserver) and physmem as its modules (in that
--- 44,59 ----
  
  sigma0 must be built with a different link base than the default value
  0x20000, because that conflicts with GRUB (on ia32).  I have
! successfully used a link base of 0x40000. From your build directory
! within the pistachio source tree, the following build commands
! should be appropriate for an ia32 system.
! 
! $ mkdir build
! $ cd build
! $ ../user/configure --with-s0-linkbase=0x40000 --prefix=/l4
! $ make
! $ make install
! $ cp kernel/ia32-kernel /l4/boot
  
  Then set up GRUB to boot laden as the kernel, and the L4 kernel,
  sigma0, wortel (the rootserver) and physmem as its modules (in that
***************
*** 50,56 ****
  root (hd0,0)
  kernel /boot/laden -D
  module /boot/ia32-kernel
! module /boot/sigma0
  module /boot/wortel -D
  module /boot/physmem
  
--- 68,74 ----
  root (hd0,0)
  kernel /boot/laden -D
  module /boot/ia32-kernel
! module /libexec/l4/sigma0
  module /boot/wortel -D
  module /boot/physmem
  
***************
*** 59,65 ****
  ------------
  
  sigma0 in pistachio 0.2 is a bit buggy.  The following patch fixes the
! problems that the bugs cause to wortel.
  
  --- pistachio-0.2/user/serv/sigma0/sigma0.cc.prev     2003-09-16 
20:29:14.000000000 +0200
  +++ pistachio-0.2/user/serv/sigma0/sigma0.cc  2003-09-16 21:03:09.000000000 
+0200
--- 77,83 ----
  ------------
  
  sigma0 in pistachio 0.2 is a bit buggy.  The following patch fixes the
! problems that the bugs cause to wortel. 
  
  --- pistachio-0.2/user/serv/sigma0/sigma0.cc.prev     2003-09-16 
20:29:14.000000000 +0200
  +++ pistachio-0.2/user/serv/sigma0/sigma0.cc  2003-09-16 21:03:09.000000000 
+0200