Documenting bugs

[B. Douglas Hilton]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Marcus, you're totally right, documenting bugs is silly, at least
within the main source code tree. I've redirected my efforts to
fleshing out a new wiki page on gnufans where notes and build tips can
be entered in a more unofficial manner. Here's the link to what I have
hacked out so far.

http://hurd.gnufans.org/bin/view/Hurd/HurdOnL4

As with any wiki, anybody can revise and edit this page so if any of
you see something that doesn't seem right or if you have something to
add then feel free to jump right in and fix it. I'm about half-way
done with the page right now but I'm getting tired and might have to
stop soon. Hopefully the page will be in a somewhat reasonably
finished state by Monday.

- - The Dougster


Marcus Brinkmann wrote:

| At Wed, 16 Jun 2004 02:45:57 -0400, B. Douglas Hilton wrote:
|
|> [1  <text/plain; us-ascii (7bit)>] 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.
|
|
| Hi,
|
| let's start with some general notes: You should explain to me/us
| why a specific change is necessary.  Just referring to a buggy
| autoreconf does not tell me enough to understand what's going on.
| All things equal, I liked Jeroens solution more.  However, what I
| like even more if things just work.  In particular, I hate
| documenting bugs. :-/
|
|> 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
|
|
| Mmh.  Ok.  Referring to --with-s0-linkbase=0x40000 as configure
| option should be enough, though.  The rest is canonical and should
| be documented in the L4 tree.
|
| Nitpick: You need two spaces after a full stop (".  From").
|
|> ! module /libexec/l4/sigma0
|
|
| Oh well.
|

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.4 (GNU/Linux)
Comment: Using GnuPG with Thunderbird - http://enigmail.mozdev.org

iD8DBQFA1WT74zktPX8iI80RApEHAKCMStKWfy8ifWxA0yht5tRPuJhaQQCfTQwP
u0oRbag76iYVogDNfsmgybo=
=vud2
-----END PGP SIGNATURE-----