projects / debian / gnuradio / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
Fixes units of pen in frequency plot.
[debian/gnuradio] / README
diff --git a/README b/README
index a3f1d8b0a23ba27f80f5e0256ffaedaee6fbe3c9..6eeb0fe8ae68be216bda4dbe7d64e3f88f561db9 100644 (file)
--- a/README
+++ b/README
@@ -1,5 +1,5 @@
 #
 #
-# Copyright 2001,2002,2003,2004,2005,2006,2007 Free Software Foundation, Inc.
+# Copyright 2001,2002,2003,2004,2005,2006,2007,2009 Free Software Foundation, Inc.
 # 
 # This file is part of GNU Radio
 # 
 # 
 # This file is part of GNU Radio
 # 
@@ -22,10 +22,6 @@
 Welcome to GNU Radio!
 
 
 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.  If you've got questions about GNU Radio, please
 subscribe to the discuss-gnuradio mailing list and post your questions
 Please see http://gnuradio.org/trac for the wiki, bug tracking,
 and source code viewer.  If you've got questions about GNU Radio, please
 subscribe to the discuss-gnuradio mailing list and post your questions
@@ -44,14 +40,6 @@ For information about subversion, please see:
   http://subversion.tigris.org/
 
 
   http://subversion.tigris.org/
 
 
-
-GNU Radio is now distributed as one giant blob, instead of N smaller
-blobs.  We believe that this will reduce some of the build problems
-people were seeing.  Now you'll always get all of the code, and the
-configure step will determine which components can be built on your
-system.
-
-
 How to Build GNU Radio:
 
   (1) Ensure that you've satisfied the external dependencies listed
 How to Build GNU Radio:
 
   (1) Ensure that you've satisfied the external dependencies listed
@@ -63,8 +51,8 @@ How to Build GNU Radio:
 
       With the exception of SDCC, the following GNU/Linux
       distributions are known to come with all required dependencies
 
       With the exception of SDCC, the following GNU/Linux
       distributions are known to come with all required dependencies
-      pre-packaged: Ubuntu 6.06, SuSE 10.0 (the pay version, not the
-      free download), Fedora Core 5.  Other distribution may work too.
+      pre-packaged: Ubuntu 8.10, SuSE 10.0 (the pay version, not the
+      free download), Fedora Core 9.  Other distribution may work too.
       We know these three are easy.  The required packages may be
       contained on your installation CD/DVD, or may be loaded over the
       net.  The specifics vary depending on your GNU/Linux
       We know these three are easy.  The required packages may be
       contained on your installation CD/DVD, or may be loaded over the
       net.  The specifics vary depending on your GNU/Linux
@@ -78,7 +66,6 @@ How to Build GNU Radio:
 
       See the wiki at http://gnuradio.org/trac/wiki for details.
 
 
       See the wiki at http://gnuradio.org/trac/wiki for details.
 
-      FIXME: update the wiki; talk about OS/X, NetBSD and MinGW too.
 
   (2) do the "usual dance"
 
 
   (2) do the "usual dance"
 
@@ -172,9 +159,9 @@ In systems using pkgsrc, install math/fftwf, which provides the
 single-precision libraries.
 
 
 single-precision libraries.
 
 
-(4) Python 2.3 or later              http://www.python.org
+(4) Python 2.5 or later              http://www.python.org
 
 
-Python 2.3 or later is now required.  If your system splits
+Python 2.5 or later is now required.  If your system splits
 python into a bunch of separate packages including python-devel or
 libpython you'll most likely need those too.
 
 python into a bunch of separate packages including python-devel or
 libpython you'll most likely need those too.
 
@@ -185,12 +172,12 @@ Provides a high performance array type for Python.
 http://numpy.scipy.org
 http://sourceforge.net/project/showfiles.php?group_id=1369&package_id=175103
 
 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
 
 
-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
+(6) The Boost C++ Libraries (1.35 or later)  http://www.boost.org
+
+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
 
 
 (7) cppunit 1.9.14 or later.   http://cppunit.sourceforge.net
@@ -211,39 +198,49 @@ This includes a C compiler and linker for the 8051.  It's required to
 build the firmware for the USRP.  If you don't have a USRP, don't
 worry about it.
 
 build the firmware for the USRP.  If you don't have a USRP, don't
 worry about it.
 
+
 (10) Guile 1.6 or 1.8 
 
 Scheme interpreter.  http://www.gnu.org/software/guile/guile.html
 
 
 (10) Guile 1.6 or 1.8 
 
 Scheme interpreter.  http://www.gnu.org/software/guile/guile.html
 
 
+(11) GNU Scientific Library (gsl) 1.10 or later
+
+The GNU Radio core library uses some routines from here.
+
 
 Optional, but nice to have:
 
 
 Optional, but nice to have:
 
-(11) wxPython.  Python binding for the wxWidgets GUI framework.  Use
-version 2.5.2.7 or later.  Again, almost all systems have this
+(12) wxPython.  Python binding for the wxWidgets GUI framework.  Use
+version 2.8 or later.  Again, almost all systems have this
 available.
 
 As a last resort, build it from source (not recommended!)
 http://www.wxpython.org
 
 available.
 
 As a last resort, build it from source (not recommended!)
 http://www.wxpython.org
 
-(12) xmlto version ? or later.   http://cyberelk.net/tim/xmlto/index.html
+(13) xmlto version ? or later.   http://cyberelk.net/tim/xmlto/index.html
 
 Wrapper for XML conversion tools to ease e.g. making html from docbook.
 
 
 Wrapper for XML conversion tools to ease e.g. making html from docbook.
 
+(14) Python Cheetah extensions 2.0.0 or later
+(15) Python lxml wrappers 2.0.0 or later
+(16) Python gtk wrappers 2.10.0 or later
+
+The GNU Radio Companion application requires these additional Python libraries
+to be installed.
 
 ----------------------------------------------------------------
 
 
 ----------------------------------------------------------------
 
-If you've got doxygen installed and provide the --enable-doxygen
-configure option, the build process creates documentation for the
-class hierarchy etc.  Point your browser at
+If you've got doxygen installed, the build process creates 
+documentation for the class hierarchy etc.  Point your browser at
 gnuradio/gnuradio-core/doc/html/index.html
 
 
 gnuradio/gnuradio-core/doc/html/index.html
 
 
-To run the examples you'll need to set PYTHONPATH.  Note that the
+To run the examples you may need to set PYTHONPATH.  Note that the
 prefix and python version number in the path needs to match your
 installed version of python.
 
 prefix and python version number in the path needs to match your
 installed version of python.
 
-  $ export PYTHONPATH=/usr/local/lib/python2.4/site-packages
+  $ export PYTHONPATH=/usr/local/lib/python2.5/site-packages
 
 You may want to add this to your shell init file (~/.bash_profile if
 you use bash).
 
 You may want to add this to your shell init file (~/.bash_profile if
 you use bash).
@@ -264,3 +261,4 @@ happens with pkgsrc and NetBSD.  To build, tell configure to use these
 locations:
 
        LDFLAGS="-L/usr/pkg/lib -R/usr/pkg/lib" CPPFLAGS="-I/usr/pkg/include" ./configure --prefix=/usr/gnuradio
 locations:
 
        LDFLAGS="-L/usr/pkg/lib -R/usr/pkg/lib" CPPFLAGS="-I/usr/pkg/include" ./configure --prefix=/usr/gnuradio
+
Debian packaging of gnuradio