diff --git a/Misc/BeOS-NOTES b/Misc/BeOS-NOTES
index 90013ee..0424c4f 100644
--- a/Misc/BeOS-NOTES
+++ b/Misc/BeOS-NOTES
@@ -1,30 +1,5 @@
 Python for BeOS R5
 
-This directory contains several useful things to help you build your own
-version of Python for BeOS.
-
-What's Here?
-
-ar-fake - A shell script that copies around .o files, for the as much
-              of the general effect of ar as we need but more fool-proof.
-              It also has an "so" command to build the shared library
-              that we actually install and use.
-
-linkmodule - A shell script used by the build process to build the
-             shared library versions of the standard modules; you'll
-             probably need this if you want to build dynamically loaded
-             modules from the Python archives.
-
-README - This file (obviously!).
-
-README.readline-2.2 - Instructions for compiling/installing GNU readline 2.2.
-                      You'll have to grab the GNU readline source code from
-                      prep.ai.mit.edu:/pub/GNU or any other GNU mirror.
-
-                      The Python interpreter is much nicer to work with
-                      interactively if you've got readline installed.  Highly
-                      recommended.
-
 To build,
 
    1)  ./configure --prefix=/boot/home/config
@@ -84,6 +59,67 @@
 
    make install
 
+
+Using GNU readline:
+
+   The Python interpreter is much nicer to work with interactively if
+   you've got readline installed.  Highly recommended.
+
+   You can get the original GNU readline 2.2 source code from your
+   favourite GNU software repository, such as
+   ftp://prep.ai.mit.edu/pub/gnu/.
+
+   You can get the only-slightly-modified-for-BeOS version of GNU
+   readline 2.2 from the GeekGadgets repository;
+   ftp://ftp.ninemoons.com/pub/geekgadgets/.
+ 
+
+Building libreadline for BeOS hosts:
+
+  Note that we don't build a shared library version of libreadline and
+  libhistory.  That's left as an exercise for the reader.
+
+  You won't be able to link against libreadline.a using the limited
+  linker.
+
+   1) If you're on a PowerPC system, install the POSIX ar from 
+      http://www.qnx.com/~chrish/Be/software/index.html#programming
+      (note that it's currently packaged with Python, in the BeOS/ar-1.1
+      directory).
+   
+      If you're on an x86 system, you can leave out the "AR=ar-posix"
+      part of the following instructions.  In fact, you'll have to...
+
+   2) For PowerPC, configure with:
+
+      CC=mwcc CFLAGS="-O7 -i- -I." AR=ar-posix RANLIB=: ./configure --verbose \
+      --without-gcc --prefix=/boot/home/config powerpc-*-beos
+
+      For x86, configure with:
+      
+      CC=mwcc CFLAGS="-O2 -i- -I." RANLIB=: ./configure --verbose \
+      --without-gcc --prefix=/boot/home/config x86-*-beos
+
+      Don't worry about the warnings/errors configure spews for
+      powerpc-*-beos or x86-*-beos; readline doesn't actually use this host 
+      information    for anything, although configure will die if you don't 
+      specify it.
+
+   3) Edit config.h to comment out "#define HAVE_SELECT 1"; select() on
+      BeOS doesn't work on file descriptors (such as stdin).
+
+   4) For PowerPC, make with:
+
+      make AR=ar-posix 
+
+      For x86, make with:
+      
+      make
+
+   5) Install with:
+
+      make install
+
 Enjoy!
 
 - Chris Herborth (chrish@pobox.com)