dont sed check, can end badly
[debian/gnuradio] / README
diff --git a/README b/README
index ebbf31d4289d83766fe5bcb6a1fd057d0d3d346c..6229ecd204e2cf2633af5afa7fcc579670105635 100644 (file)
--- a/README
+++ b/README
@@ -1,11 +1,11 @@
 #
-# Copyright 2001,2002,2003,2004,2005,2006 Free Software Foundation, Inc.
+# Copyright 2001,2002,2003,2004,2005,2006,2007 Free Software Foundation, Inc.
 # 
 # This file is part of GNU Radio
 # 
 # GNU Radio is free software; you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2, or (at your option)
+# the Free Software Foundation; either version 3, or (at your option)
 # any later version.
 # 
 # GNU Radio is distributed in the hope that it will be useful,
@@ -25,8 +25,14 @@ Welcome to GNU Radio!
 As of August 3, 2006 we have restructured the GNU Radio build process
 and moved the source code repository from CVS to subversion.
 
+
 Please see http://gnuradio.org/trac for the wiki, bug tracking,
-and source code viewer.
+and source code viewer.  If you've got questions about GNU Radio, please
+subscribe to the discuss-gnuradio mailing list and post your questions
+there.  http://gnuradio.org/trac/wiki/MailingLists
+There is also a "Build Guide" in the wiki that contains OS specific
+recommendations.  See http://gnuradio.org/trac/wiki/BuildGuide
+
 
 The bleeding edge code can be found in our subversion repository at
 http://gnuradio.org/svn.  To checkout the latest, use this
@@ -117,6 +123,17 @@ not-yet-released or unstable version.)
 For those using pkgsrc, see gnuradio-pkg_chk.conf.  Those not using
 pkgsrc may also find the list useful.
 
+(0) GNU make
+
+It used to be required to have a "reasonable make", meaning GNU make,
+BSD make, or perhaps Solaris make.  It is now required to use GNU
+make.  Version 3.81 should certainly work; the intent is not to
+require the bleeding edge.
+
+Note that the examples below are written with "make".  They probably
+should say "gmake", as GNU make is installed as gmake when it is not
+the native make.
+
 (1) The "autotools"
 
        autoconf 2.57    or later
@@ -150,7 +167,9 @@ floating point version which we use.  You should also use either the
 respectively.
 
 [FIXME: GNU/Linux packages of single-precision fftw are typically called ??]
-In systems using pkgsrc, install math/fftwf.
+
+In systems using pkgsrc, install math/fftwf, which provides the
+single-precision libraries.
 
 
 (4) Python 2.3 or later              http://www.python.org
@@ -160,18 +179,18 @@ python into a bunch of separate packages including python-devel or
 libpython you'll most likely need those too.
 
 
-(5) Numeric python library   http://numeric.scipy.org
+(5) Numpy python library   http://numeric.scipy.org
 
 Provides a high performance array type for Python.
-http://sourceforge.net/project/showfiles.php?group_id=1369&package_id=1351
+http://numpy.scipy.org
+http://sourceforge.net/project/showfiles.php?group_id=1369&package_id=175103
 
 
-(6) The Boost C++ Libraries    http://www.boost.org
+(6) The Boost C++ Libraries (1.35 or later)  http://www.boost.org
 
-We use the Smart Pointer library.  Most systems already have the boost
-libraries available.  In the unlikely event that yours doesn't,
-download the source and follow the build instructions.  They're
-different from the normal ./configure && make
+We use Smart Pointers, the thread library and a bunch of other boost stuff.
+If your system doesn't have boost 1.35 or later, see README.building-boost
+for additional info.
 
 
 (7) cppunit 1.9.14 or later.   http://cppunit.sourceforge.net
@@ -229,14 +248,6 @@ installed version of python.
 You may want to add this to your shell init file (~/.bash_profile if
 you use bash).
 
-Note that on Fedora Core 4 and 5 when running on X86_64 machines,
-python is shippped with a strange (wrong) configuration that requires
-you to add both the lib64 and lib paths to your PYTHONPATH.
-E.g.,
-
-  $ export PYTHONPATH=/usr/local/lib64/python2.4/site-packages:/usr/local/lib/python2.4/site-packages
-
-[Don't complain to us, complain to the Fedora Core packagers.]
 
 
 Another handy trick if for example your fftw includes and libs are